leboncoin.fr APIleboncoin.fr ↗
Access leboncoin.fr listings via API. Search cars, real estate, jobs, and more with price filters, location codes, and seller profiles.
curl -X GET 'https://api.parse.bot/scraper/e47ee25c-b3eb-449c-b65b-e512fd4cf897/search_listings?page=1&query=iphone&location=d_75' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for listings on leboncoin.fr with optional filters. Returns paginated results up to 100 pages. Location uses leboncoin codes: d_XX for departments (e.g., d_39 for Jura, d_75 for Paris), r_XX for regions (e.g., r_12 for Ile-de-France).
| Param | Type | Description |
|---|---|---|
| page | integer | Page number (1-100) |
| query | string | Search keyword (e.g., 'iphone', 'voiture') |
| category | string | Category ID (e.g., '2' for cars, '9' for real estate sales, '15' for electronics, '33' for jobs) |
| location | string | Location code: d_XX for department (e.g., d_39 for Jura, d_75 for Paris), r_XX for region (e.g., r_12 for Ile-de-France) |
| price_max | integer | Maximum price filter in euros |
| price_min | integer | Minimum price filter in euros |
{
"type": "object",
"fields": {
"page": "integer current page number",
"total": "integer total number of matching listings",
"results": "array of listing objects with id, title, price, url, date, category, location, images, owner, owner_type, attributes",
"max_pages": "integer maximum page number available",
"total_all": "integer total across all categories"
},
"sample": {
"data": {
"page": 1,
"total": 384024,
"results": [
{
"id": 3172761225,
"url": "https://www.leboncoin.fr/ad/telephones_objets_connectes/3172761225",
"date": "2026-04-02 20:40:37",
"owner": "[email protected]",
"price": 110,
"title": "Iphone 11",
"images": [
"https://img.leboncoin.fr/api/v1/lbcpb1/images/98/f9/32/98f9323abab2743719b4a45013f2e2b3b3d913c8.jpg?rule=ad-image"
],
"category": "Téléphones & Objets connectés",
"location": "Courcelles-lès-Lens 62970",
"attributes": {
"condition": "Très bon état",
"phone_brand": "Apple",
"phone_model": "iPhone 11"
},
"owner_type": "private"
}
],
"max_pages": 100,
"total_all": 384024
},
"status": "success"
}
}About the leboncoin.fr API
This API exposes 5 endpoints covering leboncoin.fr, France's largest classifieds platform, returning listing data across cars, real estate, electronics, and jobs. The search_listings endpoint accepts category IDs, price range filters, and department or region location codes to return paginated results including title, price, images, owner info, and listing attributes. Dedicated endpoints for car search and price analytics are also included.
Search and Filter Listings
The search_listings endpoint returns paginated results (up to 100 pages) with fields including id, title, price, url, date, category, location, images, owner, owner_type, and attributes. You can narrow results using category (e.g., '2' for cars, '9' for real estate sales, '15' for electronics, '33' for jobs), price_min/price_max in euros, and location using leboncoin's own coding scheme: d_XX for departments (e.g., d_75 for Paris) and r_XX for regions (e.g., r_12 for Ile-de-France). The response also exposes total, max_pages, and total_all so you can page through result sets accurately.
Listing Details and Car Search
get_listing_detail accepts either a full listing URL or a numeric listing ID and returns the complete listing record: description, full images array, attributes object with listing-specific fields, seller owner name, location as city and postal code, and first publication date. The dedicated search_cars endpoint wraps car-category filtering with additional make and model parameters — pass uppercase make names like 'PEUGEOT' or 'BMW' alongside a model string to filter results without manually specifying the category.
Price Analytics and Seller Profiles
get_average_price computes average, min, max, and count of priced listings matching a keyword query, scoped to an optional category. Statistics are calculated from up to 35 listings from the first result page, so treat these as indicative market prices rather than exhaustive aggregations. get_seller_profile takes a user_id from listing detail responses and returns the seller's public name and an array of their active ads.
- Monitor used car prices for a specific make and model using
search_carswithmakeandmodelfilters - Track real estate listing volumes and price ranges in a French department using
search_listingswithcategory='9'and ad_XXlocation code - Build a price alert tool that compares a target price against the
averagereturned byget_average_pricefor a given query - Aggregate seller activity by fetching
get_seller_profilefor user IDs extracted from listing detail responses - Index new electronics listings by polling
search_listingswithcategory='15'and comparingdatefields - Estimate fair market value for second-hand goods using
min,max, andaveragefromget_average_price
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does leboncoin.fr have an official public developer API?+
What location codes does the `search_listings` endpoint use, and where do I find them?+
d_XX (e.g., d_75 for Paris, d_39 for Jura) and region codes follow r_XX (e.g., r_12 for Ile-de-France). These map directly to leboncoin's internal location taxonomy — use the two-digit French department number or region number after the prefix.How accurate is the data returned by `get_average_price`?+
average, min, max, and count. Because it samples only the first result page, it reflects the most recently listed or most relevant items rather than the full historical dataset. Use it as a directional pricing reference, not a statistical survey of all active listings.Does the API expose listing descriptions from `get_listing_detail`?+
get_listing_detail returns a description field along with attributes, images, price, location, owner, and publication date. The attributes object contains listing-specific fields that vary by category — for a car listing this typically includes mileage, fuel type, and year; for real estate it includes surface area and number of rooms.Does the API support searching for listings in categories beyond cars and real estate, such as services or rentals?+
search_listings endpoint accepts any valid leboncoin category ID as the category parameter, including categories like jobs ('33') and electronics ('15'). However, dedicated filtered endpoints only exist for cars via search_cars. There is no dedicated endpoint for real estate rentals, services, or other specific sub-categories with their own filter parameters. You can fork this API on Parse and revise it to add a specialized endpoint for any additional category.