# Leboncoin API — OpenScraper

*HTML page: https://openscraper.ai/leboncoin-api · Agent index: https://openscraper.ai/llms.txt*

> Get leboncoin.fr listings with our scraping API: titles, prices, categories, photos, sellers and locations, delivered as structured JSON — from $0.79 per 1,000 ads scraped (with a subscription; $0.93 without).

## What it does

Leboncoin does not offer a public API to read its listings. Our Leboncoin API gives you leboncoin.fr data in a single request: a search URL (`…/recherche?…`) returns every matching ad, page after page; a single ad URL (`…/ad/…`) returns that one ad.

The scraper extracts every detail from the ads in real time: title, price, category, photos, city and postcode, seller type (private or professional), publication date, plus every category-specific attribute — brand, model, year, mileage, fuel and gearbox for cars, surface and number of rooms for real estate.

- From $0.79 per 1,000 ads with a subscription ($0.93 without)
- Structured JSON data
- Ads extracted in real time
- DataDome bypassed, no proxy to bring

If you need a field that isn't listed below, contact us — we can add any custom field to your feed within hours.

## Ad fields

`url`, `list_id`, `subject`, `category_name`, `price`, `currency`, `brand`, `model`, `regdate`, `mileage`, `fuel`, `gearbox`, `attributes`, `owner_name`, `owner_type`, `city`, `zipcode`, `image`, `images`, `nb_images`, `first_publication_date`, `product_count`, `scraped_at`.

## Pricing

| Product | Price without subscription | Price with subscription |
| --- | --- | --- |
| Ads | $0.93 / 1,000 ads | $0.79 / 1,000 ads |

Plans and credit rules: <https://openscraper.ai/pricing.md>.

## Using it from the API

A search returns many rows: run it asynchronously and poll.

```bash
curl -X POST https://api.openscraper.ai/runs \
  -H "Authorization: Bearer sk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "module": "leboncoin_matrix",
    "params": {
      "url": "https://www.leboncoin.fr/recherche?category=9&locations=Paris&sort=time",
      "max_results": 50
    }
  }'
```

| Module | Role | Key parameters |
| --- | --- | --- |
| `leboncoin_matrix` | Ads from a search URL, or a single ad | `url`, `max_results` |

Full parameter and response reference: <https://openscraper.ai/docs.md>.

## FAQ

**Is there an official Leboncoin API?** Leboncoin does not offer a public API to read its listings. Our API fills that gap: send it a leboncoin.fr URL and it returns the ads as structured JSON.

**Do I need proxies or a DataDome bypass?** No. The API handles the anti-bot, the sessions and the proxies. You only pay for the ads actually returned.

**Which categories are covered?** All of them: cars, real estate, jobs, electronics, home, fashion and more. The filters in your search URL are honoured, and category-specific attributes come back in the `attributes` field.