# Leboncoin Classifieds Scraper (`parseforge/leboncoin-scraper`) Actor

Scrapes Leboncoin.fr classified ads by search query, category, region, or URL. Returns each listing as a flat row with price, location, seller details, and description.

- **URL**: https://apify.com/parseforge/leboncoin-scraper.md
- **Developed by:** [ParseForge](https://apify.com/parseforge) (community)
- **Categories:** E-commerce, Lead generation, Other
- **Stats:** 29 total users, 1 monthly users, 89.7% runs succeeded, 2 bookmarks
- **User rating**: 5.00 out of 5 stars

## Pricing

from $12.99 / 1,000 result items

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/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
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.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — 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

[![ParseForge](https://raw.githubusercontent.com/ParseForge/apify-assets/main/banner.jpg)](https://apify.com/parseforge?fpr=vmoqkp)

### Leboncoin Classifieds Scraper

**Scrape Leboncoin listings from any search, category, or URL, up to a million per run.** Every ad comes with its price, location, seller details, and full description. No login or API key. Export to CSV, JSON, Excel, or XML.

Leboncoin's official API is closed to most developers, and manual browsing is slow. This reads the public classifieds directly, filtered by category, region, price, or keyword, and returns each match in one fixed schema. It covers real estate, vehicles, jobs, and goods across France.

| Who uses it | What they scrape Leboncoin for |
|---|---|
| Market researchers | Which products and prices are trending in a French region |
| Real estate analysts | Rental and sale price benchmarks by department |
| Car dealers | Competitor vehicle listings and asking prices |
| Lead generation teams | Seller contact details from active classifieds |
| E-commerce sellers | Second-hand goods supply and demand signals |

### What it does

This Actor collects Leboncoin classified ads by search query, category, region, or direct URL, and returns each one as a flat row.

- 🔍 **Search query:** any keyword, from 'iphone' to 'appartement Paris'.
- 🏷️ **Category filter:** immobilier, vehicules, Locations, Ventes, Emplois, Services, or toutes.
- 📍 **Region filter:** target a French region or department, like ile\_de\_france or rhone.
- 💰 **Price range:** set minimum and maximum price in EUR.
- 🔗 **Direct URLs:** paste specific Leboncoin listing URLs to scrape.
- 🛡️ **Residential proxy:** built-in Apify proxy with country selection to avoid blocks.

Results export to CSV, JSON, Excel, or XML, or straight from the API.

### What you can do with Leboncoin data

**📈 Monitor market prices.**

A pricing analyst runs the Actor weekly for 'voiture BMW' in ile\_de\_france to track asking prices and adjust their own listings.

**🏠 Build a real estate dataset.**

A proptech startup scrapes 'appartement' in rhone with a price range to feed their valuation model.

**🚗 Track competitor inventory.**

A used car dealer scrapes vehicle ads by brand and region to see what competitors are offering.

**📊 Generate leads.**

A sales team collects seller contact details from active classifieds in their target category.

**🛍️ Spot second-hand trends.**

An e-commerce seller scrapes 'iphone' ads to understand supply and demand before sourcing stock.

### Why choose this scraper

|  | What you get |
|---|---|
| **No API key** | Scrape public Leboncoin pages without registration or OAuth. |
| **Fixed schema** | Every ad returns the same fields, ready for analysis. |
| **Scale** | Collect up to 1,000,000 listings per run. |
| **Export anywhere** | CSV, JSON, Excel, or XML for your pipeline. |

### How it compares

This Actor competes directly with other Leboncoin scrapers on Apify, offering a full set of filters and proxy support.

| Feature | ParseForge | Leboncoin.fr Scraper | $1 / 1k | Fast & Reliable | Leboncoin Scraper (API) Pro 🇫🇷 - Annonces & Prix | 🔍🚚 Leboncoin Vehicle Scraper (PPE) |
|---|---|---|---|---|
| Search by keyword | Yes | Not listed | Not listed | Not listed |
| Category filter | Yes | Not listed | Yes | Not listed |
| Region filter | Yes | Not listed | Yes | Not listed |
| Price range filter | Yes | Not listed | Yes | Not listed |
| Direct URL scraping | Yes | Not listed | Not listed | Not listed |
| Residential proxy support | Yes | Not listed | Not listed | Not listed |

### Configure the run

Drive the Actor from search queries, categories, regions, and direct URLs, alone or together, and filters run as each ad is read so only matches reach your dataset. The Input tab lists every parameter.

A first run with the defaults:

```json
{
  "searchQuery": "iphone",
  "maxItems": 10
}
```

A larger pull:

```json
{
  "searchQuery": "iphone",
  "maxItems": 200
}
```

### Pricing

Pay-per-result: **$0.01734 per result** collected. You pay only for the results written to your dataset.

| Results collected | Approximate cost |
|---|---|
| 100 results | $1.73 |
| 1,000 results | $17.34 |
| 10,000 results | $173.40 |

New Apify accounts start with $5 in free credit.

### Free users

Free-plan runs return up to 10 results as a preview. [Upgrade your Apify plan](https://console.apify.com/sign-up?fpr=vmoqkp) to collect up to 1,000,000 results per run.

### Run it

1. [Create a free Apify account with $5 in credit](https://console.apify.com/sign-up?fpr=vmoqkp).
2. Open the [Leboncoin Classifieds Scraper](https://apify.com/parseforge/leboncoin-scraper?fpr=vmoqkp).
3. Set your inputs and any filters, then click **Start**.
4. Export the results as CSV, Excel, JSON, or XML from the **Dataset** tab.

Run it programmatically through the [Apify API](https://docs.apify.com/api/v2) (`run-sync-get-dataset-items`) or the [ApifyClient](https://docs.apify.com/api/client/js) for JavaScript and Python.

### Use with AI agents (MCP)

Give an AI agent live access to Leboncoin through the Model Context Protocol. Add the Actor to Claude, Cursor, or any MCP client:

```bash
claude mcp add --transport http apify "https://mcp.apify.com/?tools=parseforge/leboncoin-scraper"
```

Then prompt it in plain language to run the scraper and read back the results.

### Troubleshooting

**Why am I getting no results?**

Check your search query and filters. Try a broader keyword, set category to 'toutes', and remove region or price limits. Also ensure your proxy is working.

**Why are some listings missing fields?**

Leboncoin pages vary. Some sellers omit details like description or photos. The Actor returns what is available.

**Why am I blocked or getting CAPTCHAs?**

Enable residential proxies and set the proxy country to France. Reduce the number of concurrent requests if needed.

**How do I scrape a specific region?**

Use the region input with the correct slug. You can find slugs by browsing Leboncoin and looking at the URL.

**Can I run this on a schedule?**

Yes, use Apify's scheduler to run the Actor daily or weekly for fresh data.

### FAQ

| Question | Answer |
|---|---|
| Is this an official Leboncoin API? | No, this is an unofficial scraper that reads public Leboncoin pages. It does not use the official API and requires no API key. |
| Can I scrape all categories? | Yes, set category to 'toutes' to search across all categories, or choose a specific one like immobilier or vehicules. |
| How do I filter by region? | Use the region input with a French region or department slug, such as 'ile\_de\_france' or 'provence\_alpes\_cote\_azur'. |
| What is the maximum number of listings? | You can collect up to 1,000,000 listings per run with the maxItems input. |
| Does it use proxies? | Yes, it uses Apify residential proxies by default, and you can set a proxy country to appear from France. |
| Can I scrape specific listing URLs? | Yes, paste one or more Leboncoin listing URLs into the startUrls input. |
| What data does each listing include? | Each row includes price, location, seller details, description, and other fields as shown in the sample output. |
| Is it legal to scrape Leboncoin? | You are responsible for complying with Leboncoin's terms of service and local laws. Use the data ethically and at your own risk. |
| Can I export to Excel? | Yes, the Actor supports CSV, JSON, Excel, and XML exports. |
| How fast is it? | Speed depends on the number of listings and proxy settings, but it is designed for efficient parallel scraping. |

### Related actors

Browse the full [ParseForge collection](https://apify.com/parseforge?fpr=vmoqkp) for more scrapers.

🆘 **Need help?** Email parseforge@protonmail.com with your run ID, your input, and what you expected.

⚠️ **Disclaimer.** This Actor is unofficial and is not affiliated with, endorsed by, or sponsored by Leboncoin.fr. It collects only publicly available data. You are responsible for using the collected data in compliance with the source's terms of service and applicable data-protection laws, including GDPR, CCPA, and PIPL. Do not use it to collect personal data unlawfully.

# Actor input Schema

## `searchQuery` (type: `string`):

Keyword to search for on Leboncoin (e.g., 'voiture', 'appartement', 'iphone')

## `category` (type: `string`):

Leboncoin category filter. Options: toutes (all), immobilier (real estate), vehicules (vehicles), Locations (rentals), Ventes (for sale), Emplois (jobs), Services

## `region` (type: `string`):

French region or department to filter results (e.g., 'ile\_de\_france', 'provence\_alpes\_cote\_azur', 'rhone')

## `priceMin` (type: `integer`):

Minimum price filter in EUR

## `priceMax` (type: `integer`):

Maximum price filter in EUR

## `startUrls` (type: `array`):

Direct Leboncoin listing URLs to scrape

## `maxItems` (type: `integer`):

How many listings to collect per run.

## `proxyConfig` (type: `object`):

Proxy configuration for residential proxy support

## Actor input object example

```json
{
  "searchQuery": "voiture BMW",
  "category": "toutes",
  "region": "ile_de_france",
  "priceMin": 1000,
  "priceMax": 50000,
  "startUrls": [],
  "maxItems": 10,
  "proxyConfig": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ]
  }
}
```

# Actor output Schema

## `overview` (type: `string`):

No description

# 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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "searchQuery": "iphone",
    "maxItems": 10
};

// Run the Actor and wait for it to finish
const run = await client.actor("parseforge/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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "searchQuery": "iphone",
    "maxItems": 10,
}

# Run the Actor and wait for it to finish
run = client.actor("parseforge/leboncoin-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "searchQuery": "iphone",
  "maxItems": 10
}' |
apify call parseforge/leboncoin-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,parseforge/leboncoin-scraper"
        }
    }
}

```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/SxHGIN1JpuItwydPP/builds/0maL7wolDCI8jyWY7/openapi.json