Dedicated Leboncoin APILeboncoin Scraper API — Extract France's #1 Classifieds Site
The fastest way to start scraping Leboncoin at scale. Our API returns structured JSON for ads, sellers, categories, and locations across all of France — including overseas regions — with anti-bot bypass built in.
No credit card required · PAYG credits never expire
# Get ad detail for a Leboncoin listing
import scrapebadger
client = scrapebadger.ScrapeBadger("sb_live_...")
ad = client.leboncoin.ad(
list_id=2891234567
){
"list_id": 2891234567,
"subject": "Vélo VTT Décathlon Rockrider",
"price_eur": 180,
"category_name": "Vélos",
"location": {
"city": "Lyon",
"zipcode": "69003",
"region_name": "Auvergne-Rhône-Alpes"
},
"owner": { "name": "Julien", "type": "private" }
}Leboncoin API — 10 Dedicated Endpoints
Structured JSON responses with normalized data models. No HTML parsing. No proxy management.
/v1/leboncoin/search/v1/leboncoin/ads/{list_id}/v1/leboncoin/ads/{list_id}/similar/v1/leboncoin/sellers/{user_id}/v1/leboncoin/sellers/{user_id}/listings/v1/leboncoin/categories/v1/leboncoin/regions/v1/leboncoin/departments/v1/leboncoin/locations/search/v1/leboncoin/marketsAll of France, Including DOM-TOM
Leboncoin is a single national market — the API covers every metropolitan region and department, plus the overseas regions (DOM-TOM): Guadeloupe, Martinique, Réunion, Guyane, and Mayotte.
Built for Reliability at Scale
ScrapeBadger's Leboncoin Scraper API handles everything Leboncoin throws at automated requests — so your pipeline keeps running.
Nationwide French coverage
Search and browse ads across all of France — every region and department, including overseas territories (Guadeloupe, Martinique, Réunion, Guyane, Mayotte).
Location-based search
Filter by region, department, city, or zipcode. Look up regions and departments via dedicated reference endpoints, or resolve free-text locations with autocomplete.
Structured JSON, no parsing
Ad price, description, images, category, location, and seller info come back as normalized typed JSON — no HTML to parse, no fragile selectors that break on frontend changes.
Seller & listing lookups
Pull a seller profile and every ad they have posted from a single user ID — useful for tracking pro sellers or verifying private ones.
Pay per success only
Credits are only deducted for successful responses. If Leboncoin returns an error or the request times out, no credits are consumed.
SDKs for 12 Languages
Official SDKs for 12 languages — Python, Node.js, Go, Rust, PHP, C#, Java, Kotlin, Ruby, Swift, Dart, C++ — generated from one OpenAPI spec, or use the REST API directly.
Pay Per Request. Credits Never Expire.
You only pay for successful responses — failed requests are always free. PAYG credits never expire; volume subscription tiers reduce per-credit cost further.
Simple Integration. Any Language.
Get started in minutes with Node.js, Python, or plain HTTP requests.
The scrapebadger Node.js library wraps the Leboncoin API with typed methods. Install with npm install scrapebadger, then start scraping Leboncoin in a few lines of code.
import ScrapeBadger from 'scrapebadger'
const client = new ScrapeBadger({
apiKey: 'sb_live_...'
})
// Search bikes for sale in the Lyon area
const results = await client.leboncoin.search({
text: 'vélo',
regionId: '12',
priceMax: 300,
})
// Get full details for the first result
for (const ad of results.ads.slice(0, 3)) {
const detail = await client.leboncoin.ad({
listId: ad.listId,
})
console.log(detail.subject, detail.priceEur)
}Frequently Asked Questions
Common questions about scraping Leboncoin with the API — Node.js, Python, or REST.
What data does the Leboncoin Scraper API return?
Search returns a list of ads with list ID, subject, price, category, URL, and location, plus total and max page counts. Ad detail returns the full listing — subject, body, price in EUR, category, images, location (city, zipcode, region, department), owner (name and type), and structured attributes. Seller endpoints return the seller profile and their active listings.
Does it cover all of France including overseas territories (DOM-TOM)?
Yes. The Leboncoin API covers every French region and department, including the overseas departments and regions — Guadeloupe, Martinique, Réunion, Guyane, and Mayotte. The /regions and /departments endpoints return the full list so you can filter searches to any part of the country.
How do I search by location (region, department, city, zipcode)?
The /search endpoint accepts region_id, department_id, city, and zipcode filters directly. Use /regions and /departments to look up valid IDs, or /locations/search with a free-text query to get city and zipcode suggestions — handy for building a location autocomplete in your own app.
What is the pricing for the Leboncoin Scraper API?
Search, ad detail, similar ads, and seller endpoints cost 5 credits per request. Location search (autocomplete) costs 2 credits. Reference endpoints — categories, regions, departments, and markets — are free. PAYG credits never expire; monthly subscriptions reduce the per-credit cost further. Failed requests are always free.
How do I scrape Leboncoin with Node.js?
Install with npm install scrapebadger, initialise the client with your API key, then call client.leboncoin.search({ text: "vélo", regionId: "12" }) or client.leboncoin.ad({ listId: 2891234567 }). The SDK returns typed objects, and search results expose pagination via total and maxPages.
Bigger volume? Save up to 64%
Per-request credit costs are listed above. For higher monthly volume, subscription tiers reduce the per-credit rate substantially. All Leboncoin endpoints — search, ads, sellers, and reference data — included on every plan.
Start Scraping Leboncoin Today
1,000 free credits. No credit card. Get your API key in under a minute.
PAYG credits never expire · Pay only for successful requests · All of France covered