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:
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

Endpoints

Credit Costs

Authentication

All requests require your API key in the X-API-Key header:

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