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
ApiKeyAuthx-api-key<token>Your API key. Include it in the x-api-key header for every request.
query*stringLeboncoin 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:
3012186547https://www.leboncoin.fr/ad/equipement_auto/3012186547Note: If the ad has been deleted or expired on Leboncoin, the endpoint returns a 404 status code.
return_page_source?booleanControls 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.
falsefields?stringComma-separated list of response fields to return, with dot notation for nested fields (e.g. name,location.city).
is_async?booleanRun the request as a background job: the API answers 202 with a job_id to poll on GET /v1/jobs/{id}.
falsesoft_fail?booleanReturn HTTP 200 even when the request fails; the error is in the error field of the body.
falseSuccessful response
application/json- response
url?stringbody?stringowner?price?array<integer>images?status?stringlist_id?integersubject?stringcategory?location?attributes?array<>price_cents?array<integer>creation_date?stringexpiration_date?stringcurl -X GET 'https://api.piloterr.com/v2/leboncoin/ad?query=string'{ "url": "https://www.leboncoin.fr/voitures/2715494476.htm", "body": "Renault Clio IV 1.5 DCI 90. Carnet d'entretien complet, CT OK, première main.", "owner": { "name": "Alex Martin", "type": "private", "siren": null, "user_id": "abc123456" }, "price": [ 8500 ], "images": { "urls": [ "https://img.leboncoin.fr/api/cdn/thumbs/abcdef1234567890.jpg" ] }, "status": "active", "list_id": 2715494476, "subject": "Renault Clio IV 1.5 DCI 90 Energy SL Rip Curl", "category": { "id": "2", "label": "Voitures" }, "location": { "lat": 44.8378, "lng": -0.5792, "city": "Bordeaux", "zipcode": "33000", "region_id": "14", "region_name": "Nouvelle-Aquitaine", "department_id": "33", "department_name": "Gironde" }, "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" } ], "price_cents": [ 850000 ], "creation_date": "2024-09-15T14:22:00+02:00", "expiration_date": "2024-10-15T14:22:00+02:00"}