Leboncoin Scraper

Extrait les annonces de leboncoin.fr et les exporte dans un dataset structuré, prêt à être utilisé dans Excel, Google Sheets, ou tout pipeline de données.

---

Ce que fait cet Actor

• Parcourt les pages de résultats d'une recherche leboncoin et collecte toutes les annonces correspondantes
• Exporte chaque annonce dans un format structuré : titre, prix, localisation, coordonnées GPS, photos, attributs spécifiques, et plus encore
• Permet optionnellement de visiter chaque annonce individuellement pour en extraire le texte complet et les photos en haute résolution
• Retourne jusqu'à 700 annonces par exécution

---

Input — Deux façons de définir votre recherche

Option 1 — URL directe (recommandée)

Effectuez votre recherche directement sur leboncoin.fr, ajustez les filtres à votre convenance, puis copiez l'URL de la page de résultats dans le champ URL de recherche.

https://www.leboncoin.fr/recherche?text=vélo+cargo&locations=Lyon__45.74846_4.84671_4722_10000&price=min-800&owner_type=private

⚠️ Si une URL est renseignée, tous les autres paramètres de l'input sont ignorés.

Option 2 — Filtres structurés

Renseignez les champs de filtre directement dans l'interface sans quitter Apify.

Champ	Description
Mot-clé	Terme de recherche (ex : iPhone 14, table basse, développeur)
Catégorie	Catégorie leboncoin parmi les 26 disponibles
Localisation	Ville ou code postal (ex : Paris, 69001, Bordeaux_33000__44.83_-0.57_1234_15000)
Prix minimum / maximum	Fourchette de prix en euros
Type de vendeur	Tous, particuliers uniquement, ou professionnels uniquement
Tri	Par date, par prix, ou par pertinence — dans l'ordre croissant ou décroissant
Annonces urgentes uniquement	Restreint aux annonces marquées "Urgent"

Options communes

Champ	Défaut	Description
Nombre max d'annonces	700	Nombre d'annonces à collecter (maximum : 700)
Contenu détaillé	Non	Voir ci-dessous

---

Option "Contenu détaillé" — À lire avant d'activer

Par défaut, l'Actor collecte les informations affichées sur les pages de résultats : titre, prix, localisation, photos miniatures, attributs principaux.

En activant l'option Extraire le contenu complet de chaque annonce, l'Actor visite individuellement chaque annonce pour en extraire :

• La description complète rédigée par le vendeur
• Les photos en haute résolution (jusqu'à 10)
• Les attributs détaillés (kilométrage, surface, DPE, type de contrat, etc.)
• Le nombre de vues et les options de livraison

⚠️ Cette option ralentit considérablement l'exécution et consomme un volume significativement plus élevé de crédits Apify. Comptez environ 1 minute par annonce, soit près de 12 heures pour 700 annonces. À n'activer que si le contenu détaillé est indispensable à votre cas d'usage.

---

Temps d'exécution indicatifs

Mode	Volume	Durée estimée
Standard (sans détails)	700 annonces	~8–10 minutes
Avec contenu détaillé	100 annonces	~1h30
Avec contenu détaillé	700 annonces	~10–12 heures

Ces durées peuvent varier selon la disponibilité des pages et la charge du site au moment de l'exécution.

---

Dataset de sortie

Champs disponibles

Champ	Type	Description
id	string	Identifiant unique de l'annonce sur leboncoin
title	string	Titre de l'annonce
status	string	Statut de l'annonce (active, etc.)
price	string	Prix affiché (ex : "1 200 €")
priceRaw	number	Prix brut en nombre entier
location	string	Localisation complète (ville, code postal, département)
city	string	Ville
zipcode	string	Code postal
department	string	Département
region	string	Région
latitude	number	Latitude GPS
longitude	number	Longitude GPS
publishDate	string	Date de première publication (ISO 8601)
indexDate	string	Date de dernière remontée dans les résultats
category	string	Catégorie leboncoin
sellerType	string	Type de vendeur (private ou pro)
sellerName	string	Nom du vendeur
sellerStore	string	Nom du magasin (vendeurs professionnels)
isUrgent	boolean	Annonce marquée comme urgente
image1	string	URL de la première photo
images	string	URLs de toutes les photos, séparées par |
attributes	string	Attributs spécifiques à la catégorie, au format JSON
url	string	Lien vers l'annonce
scrapedAt	string	Horodatage de l'extraction

Champs supplémentaires avec l'option "Contenu détaillé" :

Champ	Description
description	Texte complet de l'annonce
image1 à image3	Photos individuelles en haute résolution
viewCount	Nombre de vues de l'annonce
hasDelivery	Livraison disponible

Exemple de résultat (format JSON)

{
  "id": "2456789012",
  "title": "iPhone 14 Pro 256Go Violet - Très bon état",
  "status": "active",
  "price": "750 €",
  "priceRaw": 750,
  "location": "Lyon, 69003, Rhône",
  "city": "Lyon",
  "zipcode": "69003",
  "department": "Rhône",
  "region": "Auvergne-Rhône-Alpes",
  "latitude": 45.7485,
  "longitude": 4.8467,
  "publishDate": "2026-04-20T09:14:33+00:00",
  "indexDate": "2026-04-25T17:02:11+00:00",
  "category": "Téléphonie",
  "sellerType": "private",
  "sellerName": "Marie L.",
  "sellerStore": null,
  "isUrgent": false,
  "image1": "https://img.leboncoin.fr/api/v1/lbcpb1/images/abc123.jpg",
  "images": "https://img.leboncoin.fr/api/v1/lbcpb1/images/abc123.jpg | https://img.leboncoin.fr/api/v1/lbcpb1/images/def456.jpg",
  "attributes": "{\"phone_model\":\"iPhone 14 Pro\",\"memory\":\"256 Go\",\"color\":\"Violet\",\"condition\":\"Très bon état\"}",
  "url": "https://www.leboncoin.fr/ad/telephones/2456789012",
  "scrapedAt": "2026-04-27T10:08:53.412Z"
}

Le champ attributes contient les caractéristiques spécifiques à chaque catégorie au format JSON. Pour les téléphones : modèle, capacité, couleur, état. Pour l'immobilier : surface, nombre de pièces, DPE. Pour les véhicules : kilométrage, année, carburant, boîte de vitesses.

---

Exemples de configuration

Recherche par mot-clé et localisation

{
  "keyword": "vélo cargo",
  "locationLabel": "Paris",
  "sortBy": "time",
  "sortOrder": "desc",
  "maxItems": 200
}

Annonces immobilières à Lyon entre 200 000 € et 400 000 €

{
  "category": "ventes_immobilieres",
  "locationLabel": "Lyon__45.74846_4.84671_4722_10000",
  "priceMin": 200000,
  "priceMax": 400000,
  "sortBy": "price",
  "sortOrder": "asc",
  "maxItems": 700
}

Offres d'emploi développeur à Paris (depuis une URL)

{
  "searchUrl": "https://www.leboncoin.fr/recherche?category=17&text=développeur&locations=Paris_75000__48.85341_2.3488_5891_20000"
}

Voitures chez des particuliers avec contenu détaillé

{
  "category": "voitures",
  "ownerType": "private",
  "priceMax": 15000,
  "sortBy": "time",
  "sortOrder": "desc",
  "maxItems": 50,
  "scrapeDetails": true
}

---

Limitations et comportement en cas de restriction

L'Actor est conçu pour être le plus efficace possible dans l'extraction de données depuis leboncoin. Comme tout site web grand public, leboncoin peut parfois restreindre l'accès à ses pages de résultats. L'Actor intègre des mécanismes pour gérer ces situations, mais il peut arriver qu'une exécution ne collecte pas la totalité des annonces demandées.

Dans ce cas, nous recommandons de :

• Relancer l'exécution ultérieurement
• Réduire le nombre d'annonces demandées
• Utiliser une recherche plus ciblée (localisation précise, mot-clé spécifique)

La limite de 700 annonces par exécution est une contrainte opérationnelle que nous avons identifiée comme le seuil au-delà duquel les restrictions deviennent systématiques.

---

Utilisation des données

Les données extraites via cet Actor sont destinées à un usage personnel ou professionnel dans le respect des Conditions Générales d'Utilisation de leboncoin. L'utilisateur est seul responsable de l'usage qu'il fait des données collectées.