# Leboncoin Scraper (`ivanvs/leboncoin-scraper`) Actor Extract data from leboncoin.fr across thousands of listings — real estate, cars, jobs, and more. Scrape titles, descriptions, images, prices, location, seller names, and contact details, plus every other ad field. Unlimited and extremely fast! - **URL**: https://apify.com/ivanvs/leboncoin-scraper.md - **Developed by:** [Gen First](https://apify.com/ivanvs) (community) - **Categories:** E-commerce, Real estate, Jobs - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 1 bookmarks - **User rating**: No ratings yet ## Pricing from $2.00 / 1,000 listings This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. 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.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.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/platform/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 Extract listings, prices, seller info, photos, and location data from [Leboncoin.fr](https://www.leboncoin.fr) — no login, no cookies, and no proxy setup required. Leboncoin Scraper turns any Leboncoin search, category, ad, seller profile, or shop (boutique) URL into clean, structured JSON you can export to CSV, Excel, JSON, XML, or HTML. ### What does Leboncoin Scraper do? - 🔎 **Scrapes search & category pages** — paste any Leboncoin category or search-results URL and collect every listing on it. - 📄 **Scrapes individual ads** — paste a single ad URL to get its full detail record. - 👤 **Scrapes seller profiles** — paste a seller/store profile URL to collect every listing they have published. - 🏬 **Scrapes shops (boutiques)** — paste a professional shop's boutique URL to collect that store's entire public inventory. - 🏠 **Works across all categories** — real estate, vehicles, jobs, electronics, fashion, services, and more. - 🧾 **Returns rich structured data** — title, description, price, currency, images, geolocation, seller/owner profile, listing options, and category-specific attributes (e.g. energy rating, surface, rooms for real estate). - 🔓 **No login or session cookies** required. - 🌐 **Proxy preconfigured** for reliable performance out of the box. - 📤 **Export anywhere** — JSON, CSV, Excel, XML, RSS, or HTML Table. ### About Leboncoin Leboncoin is one of France's largest classifieds websites, founded in 2006 and operated by LBC France (part of the Adevinta group). It hosts millions of listings across real estate, vehicles, jobs, and consumer goods, making it a key source of French marketplace and pricing data. ### What can you do with this data? - **Real-estate market & price monitoring** — track property prices, surfaces, and energy ratings by city or department. - **Vehicle & product price comparison** — benchmark asking prices across listings. - **Lead generation** — collect professional sellers and agencies with their public profile data. - **Competitor & agency tracking** — drop a seller's profile URL to monitor a specific store's or pro's full inventory over time. - **Dataset building** — feed structured listing data into analytics, dashboards, or ML pipelines. ### How to use Leboncoin Scraper 1. Open the actor on Apify. 2. Add one or more Leboncoin URLs to the **urls** field (search/category pages, single ads, seller profiles, or shop/boutique pages). 3. Set **maxRecords** to cap how many listings to collect (default `100`). 4. Click **Start** and let the scraper run. 5. Download the results in JSON, CSV, Excel, XML, RSS, or HTML Table. #### Input parameters | Input parameter | Description | Required | Default value | | --------------- | -------------------------------------------- | -------- | ---------------------------------------------------------------------------- | | urls | Leboncoin URLs to scrape (search, ad, profile, or boutique URLs) | `true` | `{url: "https://www.leboncoin.fr/c/ventes_immobilieres/real_estate_type:2"}` | | maxRecords | Maximum number of records to scrape | `false` | 100 | #### Supported input URLs Leboncoin Scraper accepts four kinds of URLs: - **Search / category URL** — collects every listing on the page (and paginates): - `https://www.leboncoin.fr/c/ventes_immobilieres/real_estate_type:2` - **Single ad URL** — collects one listing's full detail record: - `https://www.leboncoin.fr/ad/ventes_immobilieres/1234567890` - **Seller profile URL** — collects every active listing from one seller (and paginates): - `https://www.leboncoin.fr/profile/26716442-a12c-49e1-a381-7fbbe381e1a7/offers` - Pattern: `https://www.leboncoin.fr/profile//offers`, where `` is the UUID shown in the seller's profile-page URL. Results are returned newest-first and respect `maxRecords`. - **Boutique (shop) URL** — collects the entire public inventory of one professional shop (and paginates): - `https://www.leboncoin.fr/boutique/7394489/barnes_saint_germain_en_laye.htm` - Pattern: `https://www.leboncoin.fr/boutique//.htm`, where `` is the numeric store ID in the boutique-page URL (the trailing `` is just the shop name and is ignored). Results respect `maxRecords`. > **Profile vs. boutique:** both collect a single seller's listings, but they are different URL forms — a profile uses a UUID (`/profile//offers`), while a boutique uses the numeric store ID from the shop's storefront page (`/boutique//...`). Use whichever URL you have. You can mix all four URL types in the same `urls` list. ### Examples #### Input Scrape 20 search results from a given search URL: ```json { "urls": ["https://www.leboncoin.fr/c/ventes_immobilieres/real_estate_type:2"], "maxRecords": 20 } ```` Scrape up to 20 listings from a single seller's profile: ```json { "urls": ["https://www.leboncoin.fr/profile/26716442-a12c-49e1-a381-7fbbe381e1a7/offers"], "maxRecords": 20 } ``` Scrape up to 20 listings from a single shop (boutique): ```json { "urls": ["https://www.leboncoin.fr/boutique/7394489/barnes_saint_germain_en_laye.htm"], "maxRecords": 20 } ``` #### Output > Profile and boutique runs return the **same ad records** as search and single-ad runs — one record per listing — with each record's `inputUrl` set to the profile or boutique URL you supplied. > The example below is illustrative — personal and identifying values have been anonymized. ```json { "id": "1234567890", "url": "https://www.leboncoin.fr/ad/ventes_immobilieres/1234567890", "title": "Studio 1 pièce 27 m²", "description": "Studio 1 pièce 27 m²\n\nVous recherchez un premier achat malin ou un investissement locatif rentable ? Ce studio de 27 m2 a tout pour vous séduire !\nSitué au 1er étage d'une résidence agréable, cet appartement bénéficie d'un emplacement privilégié, en retrait de la circulation, offrant un calme rare tout en restant proche des commodités.\nTrès lumineux, il dispose d'une pièce de vie confortable ouvrant sur un agréable balcon privatif.\nPour votre confort, une place de parking privative complète ce bien.\n\nSurface : 27 m²\n\nConsommation énergie primaire : 142 kWh/m²/an\nConsommation énergie finale : 52 kWh/m²/an", "status": "active", "categoryId": "9", "categoryName": "Ventes immobilières", "brand": "leboncoin", "adType": "offer", "images": [ "https://img.leboncoin.fr/api/v1/lbcpb1/images/00/00/00/0000000000000000000000000000000000000000.jpg?rule=ad-image", "https://img.leboncoin.fr/api/v1/lbcpb1/images/11/11/11/1111111111111111111111111111111111111111.jpg?rule=ad-image" ], "thumbnailUrl": "https://img.leboncoin.fr/api/v1/lbcpb1/images/00/00/00/0000000000000000000000000000000000000000.jpg?rule=ad-thumb", "imageCount": 6, "inputUrl": "https://www.leboncoin.fr/c/ventes_immobilieres/real_estate_type:2", "price": 145000, "priceCents": 14500000, "currency": "EUR", "createdAt": "2026-06-11 01:17:20", "indexedAt": "2026-06-11 01:17:20", "hasPhone": true, "favorites": 0, "location": { "countryId": "FR", "regionId": "22", "regionName": "Rhône-Alpes", "departmentId": "69", "departmentName": "Rhône", "cityLabel": "Lyon 69005", "city": "Lyon", "zipcode": "69005", "district": "Point du Jour", "lat": 45.75, "lng": 4.79 }, "owner": { "storeId": "00000000", "userId": "00000000-0000-0000-0000-000000000000", "type": "pro", "name": "Agence Immobilière Exemple", "siren": "000000000", "noSalesmen": false, "activitySector": "2" }, "options": { "hasOption": false, "booster": false, "photosup": false, "urgent": false, "gallery": false, "subToplist": false, "continuousTopAds": false, "highlight": false }, "attributes": { "activity_sector": "2", "external_ad_id": "example_000000_00", "real_estate_type": "2", "square": "27", "rooms": "1", "nb_shower_room": "1", "energy_rate": "c", "ges": "a", "specificities": "", "heating_type": "communal", "heating_mode": "gas", "floor_number": "1", "nb_floors_building": "8", "floor_property": "", "elevator": "1", "orientation": "west", "outside_access": "", "nb_parkings": "2", "building_year": "1972", "fees_at_the_expanse_of": "seller", "annual_charges": "1700", "pro_rates_link": "https://www.example.com/honoraires", "district_id": "3000360", "district_visibility": "true", "district_type_id": "9", "district_resolution_type": "integration_flux", "mandate_type": "simple", "price_per_square_meter": "5370", "estimated_notary_fees": "11600", "estimated_total_property_price": "156600", "price_except_fees": "145000", "fees_price": "0", "annual_energy_budget_min": "700", "annual_energy_budget_max": "1100", "custom_ref": "20", "immo_sell_type": "old", "is_import": "true", "lease_type": "sell" } } ``` ### Output fields Each scraped listing is one dataset record with the following fields. #### Core | Field | Description | | -------------- | ----------------------------------------------------------------- | | `id` | Unique Leboncoin listing ID. | | `url` | Canonical URL of the ad. | | `title` | Listing title. | | `description` | Full listing description text. | | `status` | Listing status (e.g. `active`). | | `categoryId` | Leboncoin category ID. | | `categoryName` | Human-readable category name. | | `brand` | Source brand (`leboncoin`). | | `adType` | Ad type (e.g. `offer`). | | `images` | Array of full-size image URLs. | | `thumbnailUrl` | URL of the thumbnail image. | | `imageCount` | Number of images on the listing. | | `inputUrl` | The original URL you supplied that produced this record. | | `createdAt` | First publication date/time. | | `indexedAt` | When the listing was indexed. | | `hasPhone` | Whether the seller published a phone number. | | `favorites` | Number of times the ad was favorited. | #### Pricing | Field | Description | | ------------ | ---------------------------------------- | | `price` | Price as a number (in `currency`). | | `priceCents` | Price in cents (integer). | | `currency` | Currency code (e.g. `EUR`). | #### Location (`location`) | Field | Description | | ---------------- | -------------------------------------------- | | `countryId` | Country code (e.g. `FR`). | | `regionId` / `regionName` | Region ID and name. | | `departmentId` / `departmentName` | Department ID and name. | | `cityLabel` | Full city label as shown on the listing. | | `city` | City name. | | `zipcode` | Postal code. | | `district` | District/neighborhood, when available. | | `lat` / `lng` | Geographic coordinates. | #### Seller (`owner`) | Field | Description | | ---------------- | --------------------------------------------------- | | `storeId` | Store ID for professional sellers. | | `userId` | Seller account ID. | | `type` | Seller type (`private` or `pro`). | | `name` | Seller / store display name. | | `siren` | French business registration number (pros). | | `noSalesmen` | Whether the seller opts out of salesperson contact. | | `activitySector` | Professional activity sector code. | #### Options (`options`) Boolean promotion flags for the listing: `hasOption`, `booster`, `photosup`, `urgent`, `gallery`, `subToplist`, `continuousTopAds`, `highlight`. #### Attributes (`attributes`) A category-specific key/value map. For real estate this includes fields such as `square` (surface), `rooms`, `energy_rate`, `ges`, `heating_type`, `building_year`, `price_per_square_meter`, and more. The exact keys depend on the listing's category. ### Output formats Results are stored in an Apify dataset. After a run finishes you can download the data as **JSON, CSV, Excel, XML, RSS, or HTML Table**, or pull it via the Apify API. ### ❓ FAQ #### Do I need proxies to scrape Leboncoin? No. The proxy is already preconfigured for optimal performance — you don't need to set anything up. #### Do I need to write code? No. Leboncoin Scraper is a no-code tool: paste your URLs, set `maxRecords`, and run. #### Can I scrape a single ad or a whole category? Both. Provide a search/category URL to collect many listings, or a single ad URL to collect one listing's full record. You can mix search, ad, seller-profile, and boutique (shop) URLs in the same `urls` list. #### Can I scrape every listing from one seller? Yes. Paste the seller's profile URL — `https://www.leboncoin.fr/profile//offers` — and the scraper collects all of that seller's active offers (newest first), up to `maxRecords`. Each result is a full ad record, identical to single-ad output, with `inputUrl` set to the profile URL. #### Can I scrape every listing from a shop (boutique)? Yes. Paste the shop's boutique URL — `https://www.leboncoin.fr/boutique//.htm` — and the scraper collects that shop's entire public inventory, up to `maxRecords`. `` is the numeric store ID in the URL; the trailing slug (shop name) is ignored. Each result is a full ad record, identical to single-ad output, with `inputUrl` set to the boutique URL. A boutique is the storefront form of a professional seller — if you have a `/profile//offers` URL instead, use that; both return the same kind of records. #### How many listings can I scrape? Use `maxRecords` to set the cap (default `100`). Increase it to collect more results across paginated search pages. #### What data can I extract? Title, description, price, currency, images, geolocation, seller/owner profile, promotion options, and category-specific attributes (such as surface, rooms, and energy rating for real estate). See [Output fields](#output-fields). #### Is it legal to scrape Leboncoin? Scraping publicly available data is generally permitted, but you are responsible for how you use it. Avoid collecting or storing personal data beyond what your use case requires, and comply with applicable laws (including the GDPR) and Leboncoin's terms. Consult legal counsel if you're unsure. #### What export formats are available? JSON, CSV, Excel, XML, RSS, and HTML Table — plus programmatic access via the Apify API. ### Support For custom or simplified outputs, or to report a bug, contact the developer at **support (at) getmediumdata.com** or open an issue. # Actor input Schema ## `maxRecords` (type: `integer`): Maximum number of records to be scraped ## `urls` (type: `array`): List of URLs from Leboncoin (https://www.leboncoin.fr) that needs to be scraped ## Actor input object example ```json { "maxRecords": 10, "urls": [ { "url": "https://www.leboncoin.fr/c/ventes_immobilieres/real_estate_type:2" } ] } ``` # 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 = { "maxRecords": 10, "urls": [ { "url": "https://www.leboncoin.fr/c/ventes_immobilieres/real_estate_type:2" } ] }; // Run the Actor and wait for it to finish const run = await client.actor("ivanvs/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 = { "maxRecords": 10, "urls": [{ "url": "https://www.leboncoin.fr/c/ventes_immobilieres/real_estate_type:2" }], } # Run the Actor and wait for it to finish run = client.actor("ivanvs/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 '{ "maxRecords": 10, "urls": [ { "url": "https://www.leboncoin.fr/c/ventes_immobilieres/real_estate_type:2" } ] }' | apify call ivanvs/leboncoin-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=ivanvs/leboncoin-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Leboncoin Scraper", "description": "Extract data from leboncoin.fr across thousands of listings — real estate, cars, jobs, and more. Scrape titles, descriptions, images, prices, location, seller names, and contact details, plus every other ad field. Unlimited and extremely fast!", "version": "0.0", "x-build-id": "6pshEbXHMML8PISq1" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/ivanvs~leboncoin-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-ivanvs-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/ivanvs~leboncoin-scraper/runs": { "post": { "operationId": "runs-sync-ivanvs-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/ivanvs~leboncoin-scraper/run-sync": { "post": { "operationId": "run-sync-ivanvs-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", "required": [ "urls" ], "properties": { "maxRecords": { "title": "Maximum number of records", "minimum": 1, "type": "integer", "description": "Maximum number of records to be scraped", "default": 100 }, "urls": { "title": "List of URLs", "type": "array", "description": "List of URLs from Leboncoin (https://www.leboncoin.fr) that needs to be scraped", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } } } }, "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 } } } } } } } } } } ```