Leboncoin Search API
Search Leboncoin listings via structured POST API with advanced filters for category, location, price range, seller type, and sorting.
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
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://api.piloterr.com/v2/leboncoin/search_api"{
"total": 4821,
"total_all": 4821,
"total_pro": 1203,
"total_private": 3618,
"max_pages": 100,
"ads": [
{
"list_id": 2712345678,
"ad_type": "classified",
"url": "https://www.leboncoin.fr/voitures/2712345678.htm",
"category_id": "2",
"category_name": "Voitures",
"subject": "Volkswagen Golf VII 1.6 TDI 110 Confortline Business",
"body": "Bonjour, je vends ma Golf 7 en parfait état, CT valable, aucun défaut.",
"brand_name": null,
"price": [
11500
],
"price_cents": [
1150000
],
"currency": "EUR",
"owner": {
"type": "private",
"name": "Lucas",
"siren": null
},
"location": {
"country_id": "FR",
"city": "Lyon",
"zipcode": "69003",
"department_id": "69",
"department_name": "Rhône",
"region_id": "22",
"region_name": "Auvergne-Rhône-Alpes",
"lat": 45.75,
"lng": 4.85
},
"attributes": [
{
"key": "regdate",
"value": "2017",
"value_label": "2017"
},
{
"key": "mileage",
"value": "112000",
"value_label": "112 000 km"
},
{
"key": "fuel",
"value": "diesel",
"value_label": "Diesel"
},
{
"key": "gearbox",
"value": "manual",
"value_label": "Manuelle"
},
{
"key": "brand",
"value": "volkswagen",
"value_label": "Volkswagen"
},
{
"key": "model",
"value": "Golf VII",
"value_label": "Golf VII"
},
{
"key": "critair",
"value": "2",
"value_label": "Crit'Air 2"
}
],
"images": {
"urls": [
"https://img.leboncoin.fr/api/cdn/thumbs/abcdef1.jpg"
],
"small_url": "https://img.leboncoin.fr/api/cdn/thumbs/abcdef1.jpg",
"thumb_url": "https://img.leboncoin.fr/api/cdn/thumbs/abcdef1_thumb.jpg",
"nb_images": 6
},
"status": "active",
"creation_date": "2024-09-10T11:00:00+02:00",
"expiration_date": "2024-10-10T11:00: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"
}