# Leboncoin API — OpenScraper

*Page HTML : https://openscraper.ai/fr/leboncoin-api · Index pour agents : https://openscraper.ai/llms.txt*

> Récupérez les annonces de leboncoin.fr avec notre API de scraping : titres, prix, catégories, photos, vendeurs et localisations, livrés en JSON structuré — à partir de 0,79 $ par tranche de 1 000 annonces scrapées (avec abonnement ; 0,93 $ sans).

## Ce qu'elle fait

Leboncoin ne propose pas d'API publique pour consulter ses annonces. Notre API Leboncoin vous donne accès aux données de leboncoin.fr en une requête : une URL de recherche (`…/recherche?…`) renvoie toutes les annonces correspondantes, page après page ; une URL d'annonce (`…/ad/…`) renvoie cette annonce.

Le scraper extrait en temps réel chaque détail des annonces : titre, prix, catégorie, photos, ville et code postal, type de vendeur (particulier ou professionnel), date de publication, ainsi que tous les attributs propres à la catégorie — marque, modèle, année, kilométrage, carburant et boîte de vitesses pour les voitures, surface et nombre de pièces pour l'immobilier.

- Dès 0,79 $ les 1 000 annonces avec abonnement (0,93 $ sans)
- Données JSON structurées
- Annonces extraites en temps réel
- DataDome contourné, sans proxy à fournir

Si vous avez besoin d'un champ qui n'est pas listé ci-dessous, contactez-nous — nous pouvons ajouter n'importe quel champ personnalisé à votre flux en quelques heures.

## Champs des annonces

`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`.

## Tarifs

| Produit | Prix sans abonnement | Prix avec abonnement |
| --- | --- | --- |
| Annonces | 0,93 $ / 1 000 annonces | 0,79 $ / 1 000 annonces |

Plans et règles des crédits : <https://openscraper.ai/fr/pricing.md>.

## L'utiliser depuis l'API

Une recherche renvoie beaucoup de lignes : exécutez-la en asynchrone et faites du polling.

```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 | Rôle | Paramètres clés |
| --- | --- | --- |
| `leboncoin_matrix` | Annonces d'une URL de recherche, ou une annonce unique | `url`, `max_results` |

Référence complète des paramètres et des réponses : <https://openscraper.ai/fr/docs.md>.

## Questions fréquentes

**Existe-t-il une API Leboncoin officielle ?** Leboncoin ne propose pas d'API publique pour consulter ses annonces. Notre API comble ce manque : vous lui envoyez une URL leboncoin.fr, elle vous renvoie les annonces en JSON structuré.

**Qu'est-ce qu'un MCP et en quoi ça peut m'être utile ?** Un MCP (Model Context Protocol) est une sorte de prise universelle qui permet à un assistant IA comme Claude ou Cursor d'utiliser des outils externes. Une fois notre serveur MCP connecté (il suffit de donner l'URL `https://mcp.openscraper.ai/mcp` à votre assistant), vous n'avez plus besoin d'écrire une seule ligne de code : demandez simplement, en français, « récupère les 100 derniers appartements T3 à vendre à Bordeaux à moins de 300 000 € et fais-m'en un tableau avec le prix au m² ». L'assistant lance lui-même le scraping et vous présente les annonces, prêtes à analyser ou à exporter. Vous économisez les heures qu'il faudrait pour apprendre une API, écrire un script ou copier les annonces à la main.

**Faut-il fournir des proxies ou gérer DataDome ?** Non. L'API gère l'anti-bot, les sessions et les proxies. Vous ne payez que les annonces effectivement récupérées.

**Quelles catégories sont couvertes ?** Toutes : voitures, immobilier, emploi, multimédia, maison, mode, etc. Les filtres de votre URL de recherche sont respectés, et les attributs propres à chaque catégorie sont renvoyés dans le champ `attributes`.