Leboncoin Ad
Extract full details from a Leboncoin ad including price, location, attributes, seller info, and images. Returns structured JSON by default, or raw HTML on demand.
Credit cost: 1 credit per call
Authorization
ApiKeyAuth Your API key. Include it in the x-api-key header for every request.
In: header
Query Parameters
Leboncoin ad ID or full ad URL. Both formats are accepted regardless of return_page_source.
Accepted formats:
- Ad ID:
3012186547 - Full URL:
https://www.leboncoin.fr/ad/equipement_auto/3012186547
Examples:
3012186547
https://www.leboncoin.fr/ad/equipement_auto/3012186547Note: If the ad has been deleted or expired on Leboncoin, the endpoint returns a 404 status code.
Controls the response format.
false(default): returns a structured JSON object with all parsed ad fields (price, location, attributes, seller, images, etc.).true: returns the raw HTML source of the ad page as a string. Useful for advanced extraction or debugging when a field is missing from the structured response.
Note: The same query (ad ID or full URL) works in both modes. You don't need to change the input format depending on the value of this parameter.
"false"Response Body
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://api.piloterr.com/v2/leboncoin/ad?query=string"{
"list_id": 2715494476,
"category": {
"id": "2",
"label": "Voitures"
},
"subject": "Renault Clio IV 1.5 DCI 90 Energy SL Rip Curl",
"body": "Renault Clio IV 1.5 DCI 90. Carnet d'entretien complet, CT OK, première main.",
"price": [
8500
],
"price_cents": [
850000
],
"owner": {
"type": "private",
"name": "Jean-Marc",
"user_id": "abc123456",
"siren": null
},
"location": {
"city": "Bordeaux",
"zipcode": "33000",
"department_id": "33",
"department_name": "Gironde",
"region_id": "14",
"region_name": "Nouvelle-Aquitaine",
"lat": 44.8378,
"lng": -0.5792
},
"attributes": [
{
"key": "regdate",
"value": "2015",
"value_label": "2015"
},
{
"key": "mileage",
"value": "95000",
"value_label": "95 000 km"
},
{
"key": "fuel",
"value": "diesel",
"value_label": "Diesel"
},
{
"key": "gearbox",
"value": "manual",
"value_label": "Manuelle"
},
{
"key": "horsepower",
"value": "8",
"value_label": "8 CV"
},
{
"key": "brand",
"value": "renault",
"value_label": "Renault"
},
{
"key": "model",
"value": "Clio IV",
"value_label": "Clio IV"
},
{
"key": "vehicle_damage",
"value": "no_damage",
"value_label": "Non endommagé"
},
{
"key": "seats",
"value": "5",
"value_label": "5 places"
},
{
"key": "doors",
"value": "5",
"value_label": "5 portes"
},
{
"key": "critair",
"value": "2",
"value_label": "Crit'Air 2"
},
{
"key": "color",
"value": "silver",
"value_label": "Gris"
},
{
"key": "vehicle_type",
"value": "berline",
"value_label": "Berline"
}
],
"images": {
"urls": [
"https://img.leboncoin.fr/api/cdn/thumbs/abcdef1234567890.jpg"
]
},
"creation_date": "2024-09-15T14:22:00+02:00",
"expiration_date": "2024-10-15T14:22:00+02:00",
"status": "active",
"url": "https://www.leboncoin.fr/voitures/2715494476.htm"
}{
"error": "Bad Request"
}{
"error": "Invalid API Key"
}{
"error": "Payment required"
}{
"error": "Rate limit exceeded for the API key: quota monthly"
}{
"error": "Internal Error"
}