Skip to main content

​
Leboncoin Scraper API

Search classified ads, pull full ad detail, fetch similar ads, and retrieve seller profiles and storefronts from Leboncoin — France’s largest classifieds marketplace. The API handles authentication, DataDome anti-bot bypass, and French location routing automatically.

​
Key Features

France Coverage

Full national coverage of leboncoin.fr, filterable by region, department, city, or postal code.

Location Filters

Narrow searches by region_id, department_id, city, or zipcode, including DOM-TOM overseas territories.

DataDome Bypass

Automatic session management, Chrome TLS impersonation, and fingerprint rotation to clear Leboncoin’s DataDome protection.

Rich Ad Data

Prices, category-specific attributes, images, publication dates, shipping eligibility, and seller info.

Seller Insights

Private and pro seller profiles, feedback scores, store ratings, reviews, and full storefront listings.

French Proxies

Requests are routed through French proxies for accurate pricing, availability, and DataDome trust.

SDK Support

First-class support via the ScrapeBadger Node.js and Python SDKs.
Leboncoin is a single-country marketplace (France only). There is no domain or market selector — instead you scope results geographically with region_id, department_id, city, or zipcode. Overseas territories (DOM-TOM) are exposed as region values.

​
Coverage & Locations

Leboncoin operates as one national marketplace (leboncoin.fr). Instead of picking a country domain, you filter results by French administrative geography:
FilterParameterLookup endpoint
Region (incl. DOM-TOM)region_id/v1/leboncoin/regions
Departmentdepartment_id/v1/leboncoin/departments
City / postal codecity, zipcode/v1/leboncoin/locations/search
Use /v1/leboncoin/locations/search to resolve a free-text place name (e.g. Lyon) into a structured location with its region_id, department_id, and coordinates. Use /v1/leboncoin/markets to get the market metadata (currency, locale) programmatically.

​
Quick Start

import ScrapeBadger from "scrapebadger";

const client = new ScrapeBadger({ apiKey: "YOUR_API_KEY" });

const results = await client.leboncoin.search({
  text: "vélo électrique",
  region_id: "22",
  page: 1,
});

console.log(results.ads);

​
Endpoints

EndpointMethodDescription
/v1/leboncoin/searchGETSearch ads across France
/v1/leboncoin/ads/{list_id}GETFull detail for a single ad
/v1/leboncoin/ads/{list_id}/similarGETAds similar to a given ad
/v1/leboncoin/sellers/{user_id}GETSeller public profile
/v1/leboncoin/sellers/{user_id}/listingsGETA seller’s active listings
/v1/leboncoin/categoriesGETList categories
/v1/leboncoin/regionsGETList French regions (incl. DOM-TOM)
/v1/leboncoin/departmentsGETList departments
/v1/leboncoin/locations/searchGETAutocomplete a location by name
/v1/leboncoin/marketsGETList supported markets

​
Credit Costs

EndpointCost
Search5 credits
Get ad detail5 credits
Get similar ads5 credits
Get seller5 credits
Seller listings5 credits
Search locations2 credits
List categories0 credits
List regions0 credits
List departments0 credits
List markets0 credits
Failed requests0 credits

​
Authentication

All requests require your API key in the X-API-Key header: 
curl "https://api.scrapebadger.com/v1/leboncoin/search?text=iphone" \
  -H "X-API-Key: YOUR_API_KEY"

​
Anti-Bot Handling

Leboncoin protects its catalog with DataDome, which combines IP-reputation scoring, TLS/HTTP-2 fingerprinting, and JavaScript challenges. ScrapeBadger clears these automatically using Chrome TLS impersonation on French sessions. You never need to manage proxies, sessions, or CAPTCHAs.
For accurate pricing, availability, and DataDome trust, requests are routed through French proxies. This is handled automatically.

​
Next Steps

Search Ads

Full API reference for searching Leboncoin classifieds

Get Ad Detail

Retrieve the full detail for a single ad by list_id