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
Autorização
ApiKeyAuth Your API key. Include it in the x-api-key header for every request.
In: header
Parâmetros de consulta
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:
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.
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"Corpo da resposta
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.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": "Jean-Marc", "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"}{ "error": "Bad Request"}{ "error": "Invalid API Key"}{ "error": "Payment required"}{ "error": "Rate limit exceeded for the API key: quota monthly"}{ "error": "Internal Error"}