Leboncoin Search
Scrape Leboncoin search results or category pages by URL, returning paginated listings with price, location, and attributes.
Credit cost: 1 credit per call
Authorization
ApiKeyAuth x-api-key<token>
Your API key. Include it in the x-api-key header for every request.
In: header
Query Parameters
query*string
Full Leboncoin search or category URL. Both keyword searches and category browse URLs are supported.
Supported URL types:
- Category with filters:
https://www.leboncoin.fr/voitures/offres/ile_de_france/ - Keyword search:
https://www.leboncoin.fr/recherche?text=iphone+15&category=38
Examples:
https://www.leboncoin.fr/voitures/offres/ile_de_france/
https://www.leboncoin.fr/recherche?text=macbook&category=15Note: Pagination can be added by appending &page=2 to the URL.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://api.piloterr.com/v2/leboncoin/search?query=string"{
"total": 12481,
"ads": [
{
"list_id": 2718234567,
"category_id": "2",
"category_name": "Voitures",
"subject": "Renault Megane IV Estate 1.5 DCI 110 Business",
"body": "Renault Megane IV Estate diesel, CT valable 2 ans, révision à jour, non fumeur.",
"price": [
9900
],
"owner": {
"type": "private",
"name": "Sophie"
},
"location": {
"city": "Versailles",
"zipcode": "78000",
"department_name": "Yvelines",
"region_name": "Île-de-France"
},
"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"
}
],
"images": {
"small_url": "https://img.leboncoin.fr/api/cdn/thumbs/xyz12345.jpg",
"nb_images": 8
},
"url": "https://www.leboncoin.fr/voitures/2718234567.htm",
"status": "active",
"creation_date": "2024-09-18T09:30:00+02:00"
}
],
"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"
}