# Leboncoin Scraper: All Categories, Prices & Sellers (`dltik/leboncoin-scraper`) Actor Scrape Leboncoin.fr in any category: cars, real estate, jobs, goods. Search by keyword, category or location, or paste a search URL. Get price, images, seller (private/pro), GPS and niche fields (car mileage/year/fuel, flat rooms/surface/DPE). No browser, no captcha. $1.50/1K. - **URL**: https://apify.com/dltik/leboncoin-scraper.md - **Developed by:** [Walid](https://apify.com/dltik) (community) - **Categories:** E-commerce, Lead generation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing $1.50 / 1,000 listing scrapeds This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Leboncoin Scraper: All Categories, Prices & Sellers > Scrape [Leboncoin.fr](https://www.leboncoin.fr) in any category (cars, real estate, jobs, fashion, electronics, furniture) by keyword, category, location, or a pasted search URL. Get price, title, description, images, seller (private or pro), GPS, and the niche-specific fields of each vertical, as clean JSON or CSV. No browser, no captcha, no Leboncoin account. ⭐ **Bookmark this actor** to keep it on top of your Apify dashboard. ### What is the Leboncoin Scraper? The **Leboncoin Scraper** extracts classified-ad data from Leboncoin, France's largest marketplace, across every category. Search by keyword (`iphone 15`, `peugeot 208`, `canapé cuir`), narrow by category, department, price, or seller type, or paste any Leboncoin search URL and scrape it verbatim. Each ad comes back normalized: the common fields (title, price, description, images, location with GPS, seller) at the top level, plus a **niche object** that surfaces the structured fields that matter for that vertical, so a car returns brand, model, year, mileage, fuel, and gearbox, while a flat returns rooms, surface, and DPE energy class. Leboncoin is protected by DataDome, an anti-bot that hard-blocks datacenter traffic and most scrapers. This **Leboncoin Scraper** passes it with a genuine browser TLS fingerprint over a clean French residential IP, reading the site's lightweight Next.js JSON directly. That means no headless browser, no captcha solver, and no login, which keeps it fast and cheap. ### Leboncoin scraping use cases - **Reselling and arbitrage**: Track underpriced private listings (cars, phones, furniture) the moment they appear. - **Lead generation**: Build lists of pro sellers with their shop and location, filtered by category and area. - **Price monitoring**: Follow the going rate for a model, brand, or property type across France or one department. - **Market research**: Measure supply, price distribution, and private-vs-pro split in any Leboncoin category. - **Real estate and auto pige**: Feed fresh listings into your CRM with the niche fields already parsed. ### Input Set a `mode` and your search. A minimal keyword search: ```json { "mode": "search", "keywords": "peugeot 208", "category": "voitures", "department": "69", "priceMax": 12000, "maxResults": 200 } ```` - **search**: `keywords` across all categories, optionally narrowed by `category` (slug or numeric id), `department`, `priceMin`/`priceMax`, and `ownerType` (private or pro). Use `publishedWithinHours` for a "new listings" monitor. - **detail**: pass Leboncoin ad URLs in `inputs` to get the full record (description plus every attribute plus seller). - **startUrls**: paste any `/recherche` URL you built on the site to scrape it exactly, which is the most reliable way to target exotic categories or complex filters. ### Output One record per ad. A trimmed car example: ```json { "list_id": "2984765432", "title": "Peugeot 208 1.2 PureTech", "price": 8990, "category_name": "Voitures", "location": {"city": "Lyon", "zipcode": "69003", "lat": 45.75, "lng": 4.85}, "seller": {"name": "Garage Central", "type": "pro", "siren": "812345678"}, "images": ["https://img.leboncoin.fr/a.jpg"], "niche": {"brand": "Peugeot", "model": "208", "year": "2019", "mileage_km": "62 000 km", "fuel": "Essence", "gearbox": "Manuelle"}, "attributes": {"...": "full category-specific attribute set"}, "url": "https://www.leboncoin.fr/ad/voitures/2984765432" } ``` ### Pricing This actor uses **PAY\_PER\_EVENT**: **$0.0015 per listing** ($1.50 / 1,000 listings). There is no charge for failed runs, and blocked requests are never charged. ### Automate & schedule Schedule the **Leboncoin Scraper** to run hourly or daily with `publishedWithinHours` set, so you catch new listings the moment they go live, then wire it to Google Sheets, Slack, or your CRM through Apify integrations. Recurring runs turn it into a standing alert for the categories and areas you care about. ### FAQ: Leboncoin API, DataDome & sellers **Is there an official Leboncoin API?** No public one for third parties. This actor reads the public listing data for you, with no account and no app review. **How do I scrape Leboncoin without getting blocked by DataDome?** Use a French residential IP with a real browser fingerprint. This actor does exactly that out of the box (Apify Residential FR, or your own proxy via customProxyUrl) and rotates to a fresh IP on any block. **Does it work for cars, real estate, jobs, and goods?** Yes. Keyword search spans every category, and each ad is parsed niche-aware so you get the structured fields for its vertical (mileage and fuel for cars, rooms and DPE for real estate, and so on). **Can I get the seller's phone number?** The scraper returns the seller name, type (private or pro), shop id, and SIREN when present. The phone number sits behind a separate DataDome-protected reveal on Leboncoin and is not exposed in the listing feed. **Does it need a Leboncoin account or cookies?** No. It works fully anonymously. **How do I monitor only new listings?** Set `publishedWithinHours` (for example 24) and schedule the run. Only ads first published in that window are returned and charged. *** ⭐ **Found this useful? Bookmark it.** Apify ranks actors by bookmarks, and the more you bookmark, the more you support the dev. #### Related actors - [Pige Immo FR (LBC + SeLoger + PAP + Bien'ici)](https://apify.com/dltik/pige-immo-fr-scraper): multi-source French real-estate pige with cross-source dedup and DPE enrichment. - [Google Maps Email Extractor](https://apify.com/dltik/google-maps-email-extractor): turn local businesses into a contact list for outreach. # Actor input Schema ## `mode` (type: `string`): 'search' = find listings by keyword/category/location (or from pasted startUrls). 'detail' = fetch full records (description + all attributes + seller) for specific ad URLs. ## `keywords` (type: `string`): Free-text search across all categories, e.g. 'iphone 15', 'peugeot 208', 'canapé cuir'. Leave empty to browse a whole category/location. Used in 'search' mode. ## `category` (type: `string`): Narrow the search to one category. Accepts a slug (voitures, motos, utilitaires, nautisme, ventes\_immobilieres, locations, colocations, bureaux\_commerces) or a raw Leboncoin numeric category id. Leave empty to search every category. For categories not in the slug list, paste a /recherche URL as a startUrl or use the numeric id. ## `department` (type: `string`): Restrict to a French department by number, e.g. '75' (Paris), '13' (Bouches-du-Rhône), '33' (Gironde). For finer geo (city radius, several areas) paste a /recherche URL as a startUrl. ## `locations` (type: `string`): Advanced: a raw Leboncoin 'locations=' value (e.g. 'd\_75,d\_92' or a city point token). Overrides 'department'. Most users should use 'department' or a startUrl instead. ## `priceMin` (type: `integer`): Only listings priced at or above this (euros). Used in 'search' mode. ## `priceMax` (type: `integer`): Only listings priced at or below this (euros). Used in 'search' mode. ## `ownerType` (type: `string`): Filter by seller: 'private' (particuliers) or 'pro' (professionnels). Leave empty for both. Useful to target private sellers for reselling or pros for lead gen. ## `inputs` (type: `array`): In 'detail' mode: Leboncoin ad URLs (e.g. https://www.leboncoin.fr/ad/voitures/2984765432). In 'search' mode, the first item is used as the keyword if 'keywords' is empty. ## `startUrls` (type: `array`): Paste one or more Leboncoin /recherche URLs to scrape verbatim (any category/filter combination you built on the site). Bypasses the keyword/category/location fields — the URL is authoritative. This is the most reliable way to target exotic categories or complex filters. ## `maxResults` (type: `integer`): Maximum listings to return per run (search mode). Detail mode returns one record per URL. ## `publishedWithinHours` (type: `integer`): Only keep listings first published within the last N hours. Great for recurring 'new listings' monitoring (e.g. 24). Leave empty for no recency filter. ## `fetchDescriptions` (type: `boolean`): In 'search' mode, fetch each listing's full description text from its detail page (one extra request per listing, slightly higher cost). Off by default (the search feed already returns title, price, location, images, attributes and seller). ## `sort` (type: `string`): Advanced: raw Leboncoin 'sort=' value (e.g. 'time' for most recent). Leave empty for default relevance. ## `customProxyUrl` (type: `string`): Your own residential FR proxy URL (http://user:pass@host:port). When set, it is used as the ONLY proxy. Leboncoin needs a French residential IP; leave empty to use Apify Residential (FR). ## `proxyConfig` (type: `object`): Apify proxy configuration. Leboncoin requires the RESIDENTIAL group, country FR. Defaults to that if left unset. ## Actor input object example ```json { "mode": "search", "ownerType": "", "maxResults": 100, "fetchDescriptions": false, "proxyConfig": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "FR" } } ``` # Actor output Schema ## `results` (type: `string`): Scraped Leboncoin listings. # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = {}; // Run the Actor and wait for it to finish const run = await client.actor("dltik/leboncoin-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = {} # Run the Actor and wait for it to finish run = client.actor("dltik/leboncoin-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{}' | apify call dltik/leboncoin-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=dltik/leboncoin-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Leboncoin Scraper: All Categories, Prices & Sellers", "description": "Scrape Leboncoin.fr in any category: cars, real estate, jobs, goods. Search by keyword, category or location, or paste a search URL. Get price, images, seller (private/pro), GPS and niche fields (car mileage/year/fuel, flat rooms/surface/DPE). No browser, no captcha. $1.50/1K.", "version": "1.0", "x-build-id": "9TOKwgVeiWcM4HmNO" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/dltik~leboncoin-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-dltik-leboncoin-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/dltik~leboncoin-scraper/runs": { "post": { "operationId": "runs-sync-dltik-leboncoin-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/dltik~leboncoin-scraper/run-sync": { "post": { "operationId": "run-sync-dltik-leboncoin-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "mode": { "title": "Mode", "enum": [ "search", "detail" ], "type": "string", "description": "'search' = find listings by keyword/category/location (or from pasted startUrls). 'detail' = fetch full records (description + all attributes + seller) for specific ad URLs.", "default": "search" }, "keywords": { "title": "Keywords", "type": "string", "description": "Free-text search across all categories, e.g. 'iphone 15', 'peugeot 208', 'canapé cuir'. Leave empty to browse a whole category/location. Used in 'search' mode." }, "category": { "title": "Category (optional)", "type": "string", "description": "Narrow the search to one category. Accepts a slug (voitures, motos, utilitaires, nautisme, ventes_immobilieres, locations, colocations, bureaux_commerces) or a raw Leboncoin numeric category id. Leave empty to search every category. For categories not in the slug list, paste a /recherche URL as a startUrl or use the numeric id." }, "department": { "title": "Department (optional)", "type": "string", "description": "Restrict to a French department by number, e.g. '75' (Paris), '13' (Bouches-du-Rhône), '33' (Gironde). For finer geo (city radius, several areas) paste a /recherche URL as a startUrl." }, "locations": { "title": "Raw locations token (advanced)", "type": "string", "description": "Advanced: a raw Leboncoin 'locations=' value (e.g. 'd_75,d_92' or a city point token). Overrides 'department'. Most users should use 'department' or a startUrl instead." }, "priceMin": { "title": "Min price (€)", "minimum": 0, "type": "integer", "description": "Only listings priced at or above this (euros). Used in 'search' mode." }, "priceMax": { "title": "Max price (€)", "minimum": 0, "type": "integer", "description": "Only listings priced at or below this (euros). Used in 'search' mode." }, "ownerType": { "title": "Seller type", "enum": [ "", "private", "pro" ], "type": "string", "description": "Filter by seller: 'private' (particuliers) or 'pro' (professionnels). Leave empty for both. Useful to target private sellers for reselling or pros for lead gen.", "default": "" }, "inputs": { "title": "Ad URLs (detail mode)", "type": "array", "description": "In 'detail' mode: Leboncoin ad URLs (e.g. https://www.leboncoin.fr/ad/voitures/2984765432). In 'search' mode, the first item is used as the keyword if 'keywords' is empty.", "items": { "type": "string" } }, "startUrls": { "title": "Start URLs (advanced)", "type": "array", "description": "Paste one or more Leboncoin /recherche URLs to scrape verbatim (any category/filter combination you built on the site). Bypasses the keyword/category/location fields — the URL is authoritative. This is the most reliable way to target exotic categories or complex filters.", "items": { "type": "string" } }, "maxResults": { "title": "Max results", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Maximum listings to return per run (search mode). Detail mode returns one record per URL.", "default": 100 }, "publishedWithinHours": { "title": "Published within (hours)", "minimum": 1, "type": "integer", "description": "Only keep listings first published within the last N hours. Great for recurring 'new listings' monitoring (e.g. 24). Leave empty for no recency filter." }, "fetchDescriptions": { "title": "Fetch full descriptions", "type": "boolean", "description": "In 'search' mode, fetch each listing's full description text from its detail page (one extra request per listing, slightly higher cost). Off by default (the search feed already returns title, price, location, images, attributes and seller).", "default": false }, "sort": { "title": "Sort (advanced)", "type": "string", "description": "Advanced: raw Leboncoin 'sort=' value (e.g. 'time' for most recent). Leave empty for default relevance." }, "customProxyUrl": { "title": "Custom residential proxy (optional)", "type": "string", "description": "Your own residential FR proxy URL (http://user:pass@host:port). When set, it is used as the ONLY proxy. Leboncoin needs a French residential IP; leave empty to use Apify Residential (FR)." }, "proxyConfig": { "title": "Proxy", "type": "object", "description": "Apify proxy configuration. Leboncoin requires the RESIDENTIAL group, country FR. Defaults to that if left unset.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "FR" } } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```