Leboncoin Search
Scrape Leboncoin search results or category pages by URL, returning paginated listings with price, location, and attributes. Returns structured JSON. return_page_source is deprecated and returns 400.
Credit cost: 1 credit per call
Autorización
ApiKeyAuth x-api-key<token>
Your API key. Include it in the x-api-key header for every request.
In: header
Parámetros de consulta
query*string
Full Leboncoin search or category URL. Both keyword searches and category browse URLs are supported.
Supported URL types:
- Category page:
https://www.leboncoin.fr/c/offres_d_emploi?locations=Paris_75015__48.84105_2.29926_2747 - Keyword search:
https://www.leboncoin.fr/recherche?text=iphone+15&category=38 - Map view:
https://www.leboncoin.fr/carte/...
Examples:
https://www.leboncoin.fr/c/offres_d_emploi?locations=Paris_75015__48.84105_2.29926_2747https://www.leboncoin.fr/recherche?text=macbook&category=15Note: Pagination can be added by appending &page=2 to the URL.
return_page_source?booleanDeprecated
Deprecated. Sending true returns 400.
Default
"false"Cuerpo de la respuesta
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/v2/leboncoin/search?query=string"{ "ads": [ { "url": "https://www.leboncoin.fr/voitures/2718234567.htm", "body": "Renault Megane IV Estate diesel, CT valable 2 ans, révision à jour, non fumeur.", "owner": { "name": "Sophie", "type": "private" }, "price": [ 9900 ], "images": { "nb_images": 8, "small_url": "https://img.leboncoin.fr/api/cdn/thumbs/xyz12345.jpg" }, "status": "active", "list_id": 2718234567, "subject": "Renault Megane IV Estate 1.5 DCI 110 Business", "location": { "city": "Versailles", "zipcode": "78000", "region_name": "Île-de-France", "department_name": "Yvelines" }, "attributes": [ { "key": "brand", "value": "renault", "value_label": "Renault" }, { "key": "model", "value": "Megane IV Estate", "value_label": "Megane IV Estate" }, { "key": "regdate", "value": "2018", "value_label": "2018" }, { "key": "mileage", "value": "89000", "value_label": "89 000 km" }, { "key": "fuel", "value": "diesel", "value_label": "Diesel" }, { "key": "gearbox", "value": "manual", "value_label": "Manuelle" }, { "key": "critair", "value": "2", "value_label": "Crit'Air 2" } ], "category_id": "2", "category_name": "Voitures", "creation_date": "2024-09-18T09:30:00+02:00" } ], "total": 12481, "pagination": { "page": 1, "total_pages": 100 }}{ "error": "Bad Request"}{ "error": "Invalid API Key"}{ "error": "Payment required"}{ "error": "Rate limit exceeded for the API key: quota monthly"}{ "error": "Internal Error"}