Leboncoin.fr 🇫🇷 Scraper | Fast unlimited French Classified Ads Data Extraction

Extract unlimited classified ad listings from Leboncoin.fr, France's leading marketplace, with this reliable Python-based scraper designed for market research, price monitoring, and business intelligence. Scrape up to 10,000 ads per run with no pagination limits.

Important: Pricing Update (Pay Per Event)

Cost breakdown:

• actor_start: $0.005 flat fee for starting an Actor run
• scraped_ad: $0.0025 flat fee per scraped ad from leboncoin.fr

Examples

• Scraped 10 ads: $0.025
• Scraped 100 ads: $0.25
• Scraped 1000 ads: $2.50

Prefer the French README? Klick here.

⚡ Key Features

• Unlimited scraping - Extract up to 10,000 ads per run with automatic pagination
• Complete ad data extraction - Titles, descriptions, prices, seller info, location details, and images
• Advanced search capabilities - Query-based search with category, location, and price filtering
• Direct URL support - Extract details from specific ad URLs
• Smart monitor mode - Track only new ads since last run with advanced detection algorithm
• Instant Telegram alerts - Get real-time notifications for new listings matching your criteria
• High-frequency monitoring - Perfect for competitive French markets where deals disappear quickly
• Intelligent location lookup - Search by city, postal code, or region with radius filtering
• Comprehensive filtering - Price range, seller type, condition, shipping options, and more
• Memory efficient - Runs on 256MB for cost-effective operation
• French proxy support - Built-in residential proxy configuration optimized for France

🆓 Trial Users

New users get a free trial with up to 100 results per run to test the actor's capabilities. Upgrade for unlimited access to extract up to 10,000 ads per run.

Use Cases

For Market Research & Analytics

• Price monitoring - Track pricing trends across categories and regions
• Competitive analysis - Monitor competitor pricing and inventory strategies
• Market sizing - Analyze supply and demand patterns in specific markets
• Geographic insights - Compare market activity across French cities and regions
• Real-time market tracking - Monitor mode for instant alerts on new market activity

For Business Intelligence

• Inventory tracking - Monitor product availability and pricing across France
• Trend analysis - Identify popular products and seasonal patterns
• Supply chain insights - Track product flow and regional distribution
• Brand monitoring - Monitor brand presence and pricing across the platform

For E-commerce & Retail

• Dynamic pricing - Adjust prices based on real-time market data
• Product sourcing - Identify opportunities for product acquisition with instant alerts
• Market entry research - Understand local market conditions before expansion
• Competitor monitoring - Track competitor inventory and pricing strategies in real-time
• Deal hunting - Get instant notifications when sought-after items are listed

For Academic & Research

• Economic research - Study French consumer behavior and market dynamics
• Urban studies - Analyze economic activity patterns across French cities
• Price elasticity studies - Research pricing sensitivity in different categories
• Digital marketplace analysis - Study online marketplace dynamics

Supported Search Types

• Query searches: Search by keywords (e.g., "iPhone 16 Plus", "vélo électrique")
• Category filtering: Electronics, Vehicles, Real Estate, Fashion, and more
• Location-based: City names, postal codes, or regions with radius filtering
• Direct ad URLs: Extract details from specific ad pages
• Advanced filters: Price range, condition, seller type, and shipping options

Quick Start

Basic Search Configuration

{
  "searchQuery": "iPhone 16 Plus",
  "category": "14", // Électronique (main category)
  "location": "Paris",
  "adLimit": 100,
  "price_min_filter": 500,
  "price_max_filter": 1200
}

Location-Based Market Research

{
  "searchQuery": "vélo électrique",
  "location": "Lyon 69",
  "radius": 50,
  "adLimit": 500,
  "sortBy": "price"
}

Direct Ad URL Extraction

{
  "adDetailUrls": [
    "https://www.leboncoin.fr/ad/telephonie/3009018573",
    "https://www.leboncoin.fr/ad/informatique/3009018574"
  ]
}

Input Parameters

Parameter	Type	Description	Default
query	String	Search keywords	Optional
adDetailUrls	Array	Specific ad URLs to scrape	Optional
category	String	Main category ID (see categories below)	"0" (All)
category_id	String	Specific subcategory ID (takes precedence over category)	Optional
location	String	City, postal code, or region	All France
mode	String	Scraping mode - Standard: normal scraping, Monitor: real-time tracking of new ads only with Telegram alerts, Price Tracker: track price changes (coming soon)	"standard"
adLimit	Integer	Maximum ads to scrape (0 = unlimited)	20
sortBy	String	Sort criteria (relevance/time/price)	"relevance"
radius	Integer	Search radius in km around location	5
price_min_filter	Integer	Minimum price in euros	Optional
price_max_filter	Integer	Maximum price in euros	Optional
search_in_title_only	Boolean	Search only in ad titles	false
seller_type	String	Filter by seller (all/pro/private)	"all"
urgent	Boolean	Show only urgent ads	false
donation	Boolean	Show only donation (gratuit) ads	false
shippable	Boolean	Include shippable items	true
telegramUserId	String	Optional: Your Telegram user ID for notifications (only used in monitor mode). Get it from @userinfobot	Optional
telegramNotificationLimit	Integer	Maximum number of Telegram notifications per run (prevents spam)	10
proxyConfiguration	Object	Proxy settings (French residential recommended)	Optional

Available Categories

[
  {
    "id": "0",
    "label": "Toutes catégories"
  },
  {
    "id": "71",
    "label": "Emploi"
  },
  {
    "id": "33",
    "label": "Offres d'emploi"
  },
  {
    "id": "74",
    "label": "Formations professionnelles"
  },
  {
    "id": "1",
    "label": "Véhicules"
  },
  {
    "id": "2",
    "label": "Voitures"
  },
  {
    "id": "3",
    "label": "Motos"
  },
  {
    "id": "4",
    "label": "Caravaning"
  },
  {
    "id": "5",
    "label": "Utilitaires"
  },
  {
    "id": "300",
    "label": "Camions"
  },
  {
    "id": "7",
    "label": "Nautisme"
  },
  {
    "id": "55",
    "label": "Vélos"
  },
  {
    "id": "6",
    "label": "Équipement auto"
  },
  {
    "id": "44",
    "label": "Équipement moto"
  },
  {
    "id": "50",
    "label": "Équipement caravaning"
  },
  {
    "id": "51",
    "label": "Équipement nautisme"
  },
  {
    "id": "8",
    "label": "Immobilier"
  },
  {
    "id": "9",
    "label": "Ventes immobilières"
  },
  {
    "id": "10",
    "label": "Locations"
  },
  {
    "id": "11",
    "label": "Colocations"
  },
  {
    "id": "13",
    "label": "Bureaux & Commerces"
  },
  {
    "id": "66",
    "label": "Locations de vacances"
  },
  {
    "id": "12",
    "label": "Locations saisonnières"
  },
  {
    "id": "14",
    "label": "Électronique"
  },
  {
    "id": "15",
    "label": "Ordinateurs"
  },
  {
    "id": "83",
    "label": "Accessoires informatique"
  },
  {
    "id": "82",
    "label": "Tablettes & Liseuses"
  },
  {
    "id": "16",
    "label": "Photo, audio & vidéo"
  },
  {
    "id": "17",
    "label": "Téléphones & Objets connectés"
  },
  {
    "id": "81",
    "label": "Accessoires téléphone & Objets connectés"
  },
  {
    "id": "43",
    "label": "Consoles"
  },
  {
    "id": "84",
    "label": "Jeux vidéo"
  },
  {
    "id": "18",
    "label": "Maison & Jardin"
  },
  {
    "id": "19",
    "label": "Ameublement"
  },
  {
    "id": "96",
    "label": "Papeterie & Fournitures scolaires"
  },
  {
    "id": "20",
    "label": "Électroménager"
  },
  {
    "id": "45",
    "label": "Arts de la table"
  },
  {
    "id": "39",
    "label": "Décoration"
  },
  {
    "id": "46",
    "label": "Linge de maison"
  },
  {
    "id": "21",
    "label": "Bricolage"
  },
  {
    "id": "52",
    "label": "Jardin & Plantes"
  },
  {
    "id": "79",
    "label": "Famille"
  },
  {
    "id": "23",
    "label": "Équipement bébé"
  },
  {
    "id": "80",
    "label": "Mobilier enfant"
  },
  {
    "id": "54",
    "label": "Vêtements bébé"
  },
  {
    "id": "72",
    "label": "Mode"
  },
  {
    "id": "22",
    "label": "Vêtements"
  },
  {
    "id": "53",
    "label": "Chaussures"
  },
  {
    "id": "47",
    "label": "Accessoires & Bagagerie"
  },
  {
    "id": "42",
    "label": "Montres & Bijoux"
  },
  {
    "id": "24",
    "label": "Loisirs"
  },
  {
    "id": "89",
    "label": "Antiquités"
  },
  {
    "id": "40",
    "label": "Collection"
  },
  {
    "id": "26",
    "label": "CD - Musique"
  },
  {
    "id": "25",
    "label": "DVD - Films"
  },
  {
    "id": "30",
    "label": "Instruments de musique"
  },
  {
    "id": "27",
    "label": "Livres"
  },
  {
    "id": "86",
    "label": "Modélisme"
  },
  {
    "id": "48",
    "label": "Vins & Gastronomie"
  },
  {
    "id": "41",
    "label": "Jeux & Jouets"
  },
  {
    "id": "88",
    "label": "Loisirs créatifs"
  },
  {
    "id": "29",
    "label": "Sport & Plein air"
  },
  {
    "id": "85",
    "label": "Équipements vélos"
  },
  {
    "id": "75",
    "label": "Animaux"
  },
  {
    "id": "76",
    "label": "Accessoires animaux"
  },
  {
    "id": "77",
    "label": "Animaux perdus"
  },
  {
    "id": "56",
    "label": "Matériel professionnel"
  },
  {
    "id": "105",
    "label": "Tracteurs"
  },
  {
    "id": "57",
    "label": "Matériel agricole"
  },
  {
    "id": "59",
    "label": "BTP - Chantier gros-oeuvre"
  },
  {
    "id": "106",
    "label": "Poids lourds"
  },
  {
    "id": "58",
    "label": "Manutention - Levage"
  },
  {
    "id": "32",
    "label": "Équipements industriels"
  },
  {
    "id": "61",
    "label": "Équipements pour restaurants & hôtels"
  },
  {
    "id": "62",
    "label": "Équipements & Fournitures de bureau"
  },
  {
    "id": "63",
    "label": "Équipements pour commerces & marchés"
  },
  {
    "id": "64",
    "label": "Matériel médical"
  },
  {
    "id": "31",
    "label": "Services"
  },
  {
    "id": "101",
    "label": "Artistes & Musiciens"
  },
  {
    "id": "100",
    "label": "Baby-Sitting"
  },
  {
    "id": "35",
    "label": "Billetterie"
  },
  {
    "id": "65",
    "label": "Covoiturage"
  },
  {
    "id": "36",
    "label": "Cours particuliers"
  },
  {
    "id": "103",
    "label": "Entraide entre voisins"
  },
  {
    "id": "49",
    "label": "Évènements"
  },
  {
    "id": "99",
    "label": "Services à la personne"
  },
  {
    "id": "102",
    "label": "Services aux animaux"
  },
  {
    "id": "92",
    "label": "Services de déménagement"
  },
  {
    "id": "95",
    "label": "Services de réparations électroniques"
  },
  {
    "id": "93",
    "label": "Services de réparations mécaniques"
  },
  {
    "id": "97",
    "label": "Services de jardinerie & bricolage"
  },
  {
    "id": "98",
    "label": "Services évènementiels"
  },
  {
    "id": "34",
    "label": "Autres services"
  },
  {
    "id": "1000",
    "label": "Dons"
  },
  {
    "id": "37",
    "label": "Divers"
  },
  {
    "id": "38",
    "label": "Autres"
  }
]

Output

{
  "list_id": 2748144243,
  "first_publication_date": "2024-06-18 15:41:00",
  "index_date": "2025-07-07 20:34:23",
  "status": "active",
  "category_id": "2",
  "category_name": "Toutes catégories",
  "subject": "Volkswagen golf 8 gti clubsport 300 cv",
  "body": "VOLKSWAGEN GOLF 8 GTI CLUBSPORT 300 CV, berline, blanc, 19 cv, première mise en circulation le 21/01/2022, garantie : 3 mois.\n\nPrix TTC : 39 990 €\n\nOPTIONS ET ÉQUIPEMENTS :\nAutres équipements et informations :\n  - NONE\n\n - consommation extra urbaine: 0.00l/100\n - consommation urbaine: 0.00l/100\n - consommation mixte: 0.00l/100\n\nSÉCURITÉ :  - ABS, ESP, AIRBAGS, DIRECTION ASSISTÉE- FERMETURE CENTRALISÉE- RÉGULATEUR/LIMITEUR DE VITESSE- RADAR DE RECUL- CAMERA DE RECUL- RADAR ANTI COLLISION\n\n EXTÉRIEUR :- JANTES ALU- PEINTURE MÉTAL- FEUX LED AV/AR\n\n INTÉRIEUR ET CONFORT :- VITRES ÉLECTRIQUES- COMPTEUR VIRTUAL COCKPIT- VOLANT CUIR MULTIFONCTIONS- RADIO BLUETOOTH- GPS NAVIGATION- ÉCRAN TACTILE- CHARGEUR INDUCTION- CLIM AUTO- SIÈGES SPORT ALCANTARA- SIÈGES CHAUFFANTS- INTÉRIEUR SURPIQUÉE ROUGE- PACK AMBIANCE LED- PLAFONNIER ANTHRACITE- ETC? SOUS RÉSERVE D'ERREUR\n\n ** EMPIRE AUTO SE SITUE 1 RUE DES CHAUDRONNIERS 88190 GOLBEY DANS UNE ZONE COMMERCIALE DERRIÈRE LE LECLERC\n\n ** VÉHICULE GARANTI ET RÉVISÉE AVEC NETTOYAGE INTÉRIEUR / EXTÉRIEUR\n\n ** SERVICE CARTE GRISE SUR PLACE ( SEULEMENT 30e DE FRAIS ADMINISTRATIFS )\n\n ** REPRISE POSSIBLE TOUTES MARQUES\n\n ** FINANCEMENT POSSIBLE SUR VEHICULE DE MOINS DE 7 ANS\n\n ** GARANTIES SUR CHAQUE VÉHICULE ( 3 MOIS MINIMUM AVEC POSSIBILITÉ D'EXTENSION )\n\n ** OUVERT DU LUNDI au SAMEDI de 9H00 à 12H00 et 14H00 à 18h00\n\nRéférence annonce : 3886",
  "brand": "leboncoin",
  "ad_type": "offer",
  "url": "https://www.leboncoin.fr/ad/voitures/2748144243",
  "price": [
    39990
  ],
  "price_cents": 3999000,
  "images": {
    "thumb_url": "https://img.leboncoin.fr/api/v1/lbcpb1/images/37/de/f4/37def4862ad5de24fc9df128e852cb450a8d3d57.jpg?rule=ad-thumb",
    "small_url": "https://img.leboncoin.fr/api/v1/lbcpb1/images/37/de/f4/37def4862ad5de24fc9df128e852cb450a8d3d57.jpg?rule=ad-small",
    "nb_images": 19,
    "urls": [
      "https://img.leboncoin.fr/api/v1/lbcpb1/images/37/de/f4/37def4862ad5de24fc9df128e852cb450a8d3d57.jpg?rule=ad-image",
      "https://img.leboncoin.fr/api/v1/lbcpb1/images/77/34/e4/7734e403bcc4c61757468a42176880e43b0e4251.jpg?rule=ad-image",
      "https://img.leboncoin.fr/api/v1/lbcpb1/images/10/55/39/1055398511c839f1ec79e4441137b8b2797b27d2.jpg?rule=ad-image",
      "https://img.leboncoin.fr/api/v1/lbcpb1/images/9b/35/ce/9b35cebf31e9bfd73f4d40aa41b2afef9f68cd2e.jpg?rule=ad-image",
      "https://img.leboncoin.fr/api/v1/lbcpb1/images/6f/e4/5a/6fe45a0f1874d4a1db8dde668ec9cd727c88f619.jpg?rule=ad-image",
      "https://img.leboncoin.fr/api/v1/lbcpb1/images/10/77/ed/1077ed200ce0b147da481cbab96d8b5fbd404c09.jpg?rule=ad-image",
      "https://img.leboncoin.fr/api/v1/lbcpb1/images/39/4b/04/394b04db875eac11a49f2b3c60aeb7bca06173ea.jpg?rule=ad-image",
      "https://img.leboncoin.fr/api/v1/lbcpb1/images/30/65/fc/3065fc96e4d57ab6b97849a68f3a4369cd57f9b7.jpg?rule=ad-image",
      "https://img.leboncoin.fr/api/v1/lbcpb1/images/4a/c4/48/4ac4484b4befb8902c445f5cf2cf6c57be6eaf19.jpg?rule=ad-image",
      "https://img.leboncoin.fr/api/v1/lbcpb1/images/76/8a/c2/768ac2d4197af14fa908976666ff396fc209eee9.jpg?rule=ad-image",
      "https://img.leboncoin.fr/api/v1/lbcpb1/images/b5/8e/50/b58e507d22a1d4a4ab66048004bdcfdc562c95dc.jpg?rule=ad-image",
      "https://img.leboncoin.fr/api/v1/lbcpb1/images/61/d7/8b/61d78b5c77851b237f964c7bb9330f2afb6f2073.jpg?rule=ad-image",
      "https://img.leboncoin.fr/api/v1/lbcpb1/images/5e/22/5e/5e225e0f18233b3efde44ff57b7679eb606f57b3.jpg?rule=ad-image",
      "https://img.leboncoin.fr/api/v1/lbcpb1/images/b2/71/6f/b2716f8d893ef8038c4ec834c9fd119cc9be6665.jpg?rule=ad-image",
      "https://img.leboncoin.fr/api/v1/lbcpb1/images/d5/fd/48/d5fd48c0b183589d1e6efa4ebdda8e89425cb783.jpg?rule=ad-image",
      "https://img.leboncoin.fr/api/v1/lbcpb1/images/82/76/3a/82763a3203c9cdccc5fb0b24e2dc8befd2c02ff1.jpg?rule=ad-image",
      "https://img.leboncoin.fr/api/v1/lbcpb1/images/e7/ae/e6/e7aee6ddb3db9b5564697da2f9c35c154597e728.jpg?rule=ad-image",
      "https://img.leboncoin.fr/api/v1/lbcpb1/images/77/4f/b1/774fb12604107bf6e3cc4d08b7a9281dbcf2a924.jpg?rule=ad-image",
      "https://img.leboncoin.fr/api/v1/lbcpb1/images/76/f2/40/76f24009c425dfd227063e6c2c563b696dd7fb82.jpg?rule=ad-image"
    ],
    "urls_thumb": [
      "https://img.leboncoin.fr/api/v1/lbcpb1/images/37/de/f4/37def4862ad5de24fc9df128e852cb450a8d3d57.jpg?rule=ad-thumb",
      "https://img.leboncoin.fr/api/v1/lbcpb1/images/77/34/e4/7734e403bcc4c61757468a42176880e43b0e4251.jpg?rule=ad-thumb",
      "https://img.leboncoin.fr/api/v1/lbcpb1/images/10/55/39/1055398511c839f1ec79e4441137b8b2797b27d2.jpg?rule=ad-thumb",
      "https://img.leboncoin.fr/api/v1/lbcpb1/images/9b/35/ce/9b35cebf31e9bfd73f4d40aa41b2afef9f68cd2e.jpg?rule=ad-thumb",
      "https://img.leboncoin.fr/api/v1/lbcpb1/images/6f/e4/5a/6fe45a0f1874d4a1db8dde668ec9cd727c88f619.jpg?rule=ad-thumb",
      "https://img.leboncoin.fr/api/v1/lbcpb1/images/10/77/ed/1077ed200ce0b147da481cbab96d8b5fbd404c09.jpg?rule=ad-thumb",
      "https://img.leboncoin.fr/api/v1/lbcpb1/images/39/4b/04/394b04db875eac11a49f2b3c60aeb7bca06173ea.jpg?rule=ad-thumb",
      "https://img.leboncoin.fr/api/v1/lbcpb1/images/30/65/fc/3065fc96e4d57ab6b97849a68f3a4369cd57f9b7.jpg?rule=ad-thumb",
      "https://img.leboncoin.fr/api/v1/lbcpb1/images/4a/c4/48/4ac4484b4befb8902c445f5cf2cf6c57be6eaf19.jpg?rule=ad-thumb",
      "https://img.leboncoin.fr/api/v1/lbcpb1/images/76/8a/c2/768ac2d4197af14fa908976666ff396fc209eee9.jpg?rule=ad-thumb",
      "https://img.leboncoin.fr/api/v1/lbcpb1/images/b5/8e/50/b58e507d22a1d4a4ab66048004bdcfdc562c95dc.jpg?rule=ad-thumb",
      "https://img.leboncoin.fr/api/v1/lbcpb1/images/61/d7/8b/61d78b5c77851b237f964c7bb9330f2afb6f2073.jpg?rule=ad-thumb",
      "https://img.leboncoin.fr/api/v1/lbcpb1/images/5e/22/5e/5e225e0f18233b3efde44ff57b7679eb606f57b3.jpg?rule=ad-thumb",
      "https://img.leboncoin.fr/api/v1/lbcpb1/images/b2/71/6f/b2716f8d893ef8038c4ec834c9fd119cc9be6665.jpg?rule=ad-thumb",
      "https://img.leboncoin.fr/api/v1/lbcpb1/images/d5/fd/48/d5fd48c0b183589d1e6efa4ebdda8e89425cb783.jpg?rule=ad-thumb",
      "https://img.leboncoin.fr/api/v1/lbcpb1/images/82/76/3a/82763a3203c9cdccc5fb0b24e2dc8befd2c02ff1.jpg?rule=ad-thumb",
      "https://img.leboncoin.fr/api/v1/lbcpb1/images/e7/ae/e6/e7aee6ddb3db9b5564697da2f9c35c154597e728.jpg?rule=ad-thumb",
      "https://img.leboncoin.fr/api/v1/lbcpb1/images/77/4f/b1/774fb12604107bf6e3cc4d08b7a9281dbcf2a924.jpg?rule=ad-thumb",
      "https://img.leboncoin.fr/api/v1/lbcpb1/images/76/f2/40/76f24009c425dfd227063e6c2c563b696dd7fb82.jpg?rule=ad-thumb"
    ],
    "urls_large": [
      "https://img.leboncoin.fr/api/v1/lbcpb1/images/37/de/f4/37def4862ad5de24fc9df128e852cb450a8d3d57.jpg?rule=ad-large",
      "https://img.leboncoin.fr/api/v1/lbcpb1/images/77/34/e4/7734e403bcc4c61757468a42176880e43b0e4251.jpg?rule=ad-large",
      "https://img.leboncoin.fr/api/v1/lbcpb1/images/10/55/39/1055398511c839f1ec79e4441137b8b2797b27d2.jpg?rule=ad-large",
      "https://img.leboncoin.fr/api/v1/lbcpb1/images/9b/35/ce/9b35cebf31e9bfd73f4d40aa41b2afef9f68cd2e.jpg?rule=ad-large",
      "https://img.leboncoin.fr/api/v1/lbcpb1/images/6f/e4/5a/6fe45a0f1874d4a1db8dde668ec9cd727c88f619.jpg?rule=ad-large",
      "https://img.leboncoin.fr/api/v1/lbcpb1/images/10/77/ed/1077ed200ce0b147da481cbab96d8b5fbd404c09.jpg?rule=ad-large",
      "https://img.leboncoin.fr/api/v1/lbcpb1/images/39/4b/04/394b04db875eac11a49f2b3c60aeb7bca06173ea.jpg?rule=ad-large",
      "https://img.leboncoin.fr/api/v1/lbcpb1/images/30/65/fc/3065fc96e4d57ab6b97849a68f3a4369cd57f9b7.jpg?rule=ad-large",
      "https://img.leboncoin.fr/api/v1/lbcpb1/images/4a/c4/48/4ac4484b4befb8902c445f5cf2cf6c57be6eaf19.jpg?rule=ad-large",
      "https://img.leboncoin.fr/api/v1/lbcpb1/images/76/8a/c2/768ac2d4197af14fa908976666ff396fc209eee9.jpg?rule=ad-large",
      "https://img.leboncoin.fr/api/v1/lbcpb1/images/b5/8e/50/b58e507d22a1d4a4ab66048004bdcfdc562c95dc.jpg?rule=ad-large",
      "https://img.leboncoin.fr/api/v1/lbcpb1/images/61/d7/8b/61d78b5c77851b237f964c7bb9330f2afb6f2073.jpg?rule=ad-large",
      "https://img.leboncoin.fr/api/v1/lbcpb1/images/5e/22/5e/5e225e0f18233b3efde44ff57b7679eb606f57b3.jpg?rule=ad-large",
      "https://img.leboncoin.fr/api/v1/lbcpb1/images/b2/71/6f/b2716f8d893ef8038c4ec834c9fd119cc9be6665.jpg?rule=ad-large",
      "https://img.leboncoin.fr/api/v1/lbcpb1/images/d5/fd/48/d5fd48c0b183589d1e6efa4ebdda8e89425cb783.jpg?rule=ad-large",
      "https://img.leboncoin.fr/api/v1/lbcpb1/images/82/76/3a/82763a3203c9cdccc5fb0b24e2dc8befd2c02ff1.jpg?rule=ad-large",
      "https://img.leboncoin.fr/api/v1/lbcpb1/images/e7/ae/e6/e7aee6ddb3db9b5564697da2f9c35c154597e728.jpg?rule=ad-large",
      "https://img.leboncoin.fr/api/v1/lbcpb1/images/77/4f/b1/774fb12604107bf6e3cc4d08b7a9281dbcf2a924.jpg?rule=ad-large",
      "https://img.leboncoin.fr/api/v1/lbcpb1/images/76/f2/40/76f24009c425dfd227063e6c2c563b696dd7fb82.jpg?rule=ad-large"
    ]
  },
  "attributes": [
    {
      "key": "activity_sector",
      "value": "1",
      "values": [
        "1"
      ],
      "value_label": "1",
      "generic": false
    },
    {
      "key": "brand",
      "value": "Volkswagen",
      "values": [
        "Volkswagen"
      ],
      "key_label": "Marque",
      "value_label": "Volkswagen",
      "generic": false
    },
    {
      "key": "model",
      "value": "Golf",
      "values": [
        "Golf",
        "model_all"
      ],
      "key_label": "Modèle",
      "value_label": "Golf",
      "generic": false
    },
    {
      "key": "u_car_brand",
      "value": "VOLKSWAGEN",
      "values": [
        "VOLKSWAGEN"
      ],
      "key_label": "Marque",
      "value_label": "VOLKSWAGEN",
      "generic": true
    },
    {
      "key": "u_car_model",
      "value": "VOLKSWAGEN_Golf",
      "values": [
        "VOLKSWAGEN_Golf",
        "VOLKSWAGEN_model_all"
      ],
      "key_label": "Modèle",
      "value_label": "Golf",
      "generic": true
    },
    {
      "key": "regdate",
      "value": "2022",
      "values": [
        "2022"
      ],
      "key_label": "Année modèle",
      "value_label": "2022",
      "generic": true,
      "display_ad_card": true
    },
    {
      "key": "mileage",
      "value": "20000",
      "values": [
        "20000"
      ],
      "key_label": "Kilométrage",
      "value_label": "20000 km",
      "value_label_reader": "20000 Kilomètres",
      "generic": true,
      "display_ad_card": true
    },
    {
      "key": "fuel",
      "value": "1",
      "values": [
        "1"
      ],
      "key_label": "Énergie",
      "value_label": "Essence",
      "generic": true,
      "display_ad_card": true
    },
    {
      "key": "gearbox",
      "value": "2",
      "values": [
        "2"
      ],
      "key_label": "Boîte de vitesse",
      "value_label": "Automatique",
      "generic": true,
      "display_ad_card": true
    },
    {
      "key": "u_car_version",
      "value": "Golf 2.0 TSI 300ch GTI Clubsport DSG7",
      "values": [
        "Golf 2.0 TSI 300ch GTI Clubsport DSG7"
      ],
      "key_label": "Version Constructeur",
      "value_label": "Golf 2.0 TSI 300ch GTI Clubsport DSG7",
      "generic": true
    },
    {
      "key": "issuance_date",
      "value": "01/2022",
      "values": [
        "01/2022"
      ],
      "key_label": "Date de première mise en circulation",
      "value_label": "01/2022",
      "generic": true
    },
    {
      "key": "vehicle_type",
      "value": "berline",
      "values": [
        "berline"
      ],
      "key_label": "Type de véhicule",
      "value_label": "Berline",
      "generic": true
    },
    {
      "key": "vehicule_color",
      "value": "blanc",
      "values": [
        "blanc"
      ],
      "key_label": "Couleur",
      "value_label": "Blanc",
      "generic": true
    },
    {
      "key": "horsepower",
      "value": "19",
      "values": [
        "19"
      ],
      "key_label": "Puissance fiscale",
      "value_label": "19 Cv",
      "value_label_reader": "19 Chevaux",
      "generic": true
    },
    {
      "key": "vehicle_vsp",
      "value": "avecpermis",
      "values": [
        "avecpermis"
      ],
      "key_label": "Permis",
      "value_label": "Avec permis",
      "generic": true
    },
    {
      "key": "recent_used_vehicle",
      "value": "false",
      "values": [
        "false"
      ],
      "value_label": "false",
      "generic": false
    },
    {
      "key": "has_visibility_option",
      "value": "true",
      "values": [
        "true"
      ],
      "value_label": "true",
      "generic": false
    },
    {
      "key": "store_logo",
      "value": "https://img.leboncoin.fr/api/v1/lbcpb1/images/27/19/11/271911006099699.jpg?rule=bo-thumb",
      "values": [
        "https://img.leboncoin.fr/api/v1/lbcpb1/images/27/19/11/271911006099699.jpg?rule=bo-thumb"
      ],
      "value_label": "https://img.leboncoin.fr/api/v1/lbcpb1/images/27/19/11/271911006099699.jpg?rule=bo-thumb",
      "generic": false
    },
    {
      "key": "store_name",
      "value": "EMPIRE AUTO",
      "values": [
        "EMPIRE AUTO"
      ],
      "value_label": "EMPIRE AUTO",
      "generic": false
    },
    {
      "key": "online_store_id",
      "value": "5810",
      "values": [
        "5810"
      ],
      "value_label": "5810",
      "generic": false
    },
    {
      "key": "custom_ref",
      "value": "3886",
      "values": [
        "3886"
      ],
      "key_label": "Référence",
      "value_label": "3886",
      "generic": true
    },
    {
      "key": "is_import",
      "value": "true",
      "values": [
        "true"
      ],
      "value_label": "true",
      "generic": false
    },
    {
      "key": "old_price",
      "value": "42990",
      "values": [
        "42990"
      ],
      "value_label": "42990",
      "generic": false
    },
    {
      "key": "vehicle_history_report_status",
      "value": "broken",
      "values": [
        "broken"
      ],
      "value_label": "broken",
      "generic": false
    },
    {
      "key": "argus_object_id",
      "value": "2539836",
      "values": [
        "2539836"
      ],
      "value_label": "2539836",
      "generic": false
    },
    {
      "key": "spare_parts_availability",
      "value": "non_renseignee",
      "values": [
        "non_renseignee"
      ],
      "key_label": "Durée de disponibilité des pièces détachées",
      "value_label": "Non renseignée",
      "generic": true
    },
    {
      "key": "licence_plate_available",
      "value": "true",
      "values": [
        "true"
      ],
      "value_label": "true",
      "generic": false
    }
  ],
  "location": {
    "country_id": "FR",
    "region_id": "15",
    "region_name": "Lorraine",
    "department_id": "88",
    "department_name": "Vosges",
    "city_label": "Golbey 88190",
    "city": "Golbey",
    "zipcode": "88190",
    "lat": 48.19756,
    "lng": 6.43886,
    "source": "city",
    "provider": "here",
    "is_shape": true,
    "feature": {
      "type": "Feature",
      "geometry": {
        "type": "Point",
        "coordinates": [
          6.43886,
          48.19756
        ]
      },
      "properties": null
    }
  },
  "owner": {
    "store_id": "236560",
    "user_id": "35f9e6bd-b741-4cd2-8692-b6f900e36e8e",
    "type": "pro",
    "name": "Empire auto",
    "siren": "539049130",
    "no_salesmen": true,
    "activity_sector": "1"
  },
  "options": {
    "has_option": false,
    "booster": false,
    "photosup": false,
    "urgent": false,
    "gallery": false,
    "sub_toplist": false,
    "continuous_top_ads": false,
    "highlight": false
  },
  "has_phone": true,
  "similar": null,
  "counters": {},
  "search_query": "golf 8 gti",
  "scraped_at": "2025-07-09T03:57:24.505034+00:00",
  "scraped_at_timestamp": 1752033444,
  "data_source": "search",
  "actor_run_id": "run_id",
  "actor_input_hash": "input_hash",
  "is_shippable": false,
  "price_euros": 39990.0,
  "location_summary": "Golbey (88190)"
}

The attributes array may differ depending on the type of ad scraped.

Advanced Usage

Market Research Across Regions

{
  "searchQuery": "appartement 3 pièces",
  "category": "8", // Immobilier
  "location": "Île-de-France",
  "radius": 0,
  "adLimit": 1000,
  "price_min_filter": 200000,
  "price_max_filter": 500000,
  "sortBy": "price"
}

Professional Seller Analysis

{
  "searchQuery": "MacBook Pro",
  "category": "14", // Électronique
  "seller_type": "pro",
  "adLimit": 200,
  "shippable": true
}

Geographic Price Comparison

{
  "searchQuery": "Tesla Model 3",
  "category": "1", // Véhicules
  "location": "Marseille 13",
  "radius": 100,
  "adLimit": 50,
  "sortBy": "price"
}

🔄 Monitor Mode - Real-time tracking (Secret Weapon)

Monitor mode transforms the Leboncoin scraper into a powerful real-time alerting system for the French marketplace:

How it works

1. Baseline Creation - First run establishes what ads currently exist across your search criteria
2. Smart Detection - Subsequent runs only return genuinely new ads since the last run
3. Instant Alerts - Get notified immediately when new items match your criteria via Telegram
4. Zero Noise - No duplicate or re-posted ads, only truly new listings

Advanced Detection System

Our monitor mode uses a sophisticated listing detection algorithm:

• Positional analysis - Examines the first pages for new listings at the top
• Baseline filtering - Compares against comprehensive historical baseline of all previously seen ads
• False positive prevention - Eliminates reactivated or re-listed items
• Reliable detection - Only reports genuinely new listings that weren't in the original baseline

This approach ensures you never miss a truly new listing while avoiding noise from reactivated listings.

In competitive French markets where good deals disappear quickly, monitor mode gives you the edge by alerting you to new listings within minutes of being posted.

Perfect for

• Deal hunting - Get notified immediately when sought-after items are listed
• Market monitoring - Track new inventory in specific categories or regions
• Price alerts - Monitor for items within your price range
• Competitive intelligence - Track competitor activity and new product launches
• Research projects - Collect time-series data on French marketplace activity

Setting up Monitor Mode

{
  "searchQuery": "iPhone 16 Plus",
  "category_id": "17", // Using specific subcategory ID
  "location": "Paris",
  "mode": "monitor",
  "telegramUserId": "123456789"
}

Monitor Mode Output Examples

First Run (Initialization)

[{
  "monitor_initialized": true,
  "total_baseline_ads": 1247,
  "baseline_ids_count": 1247,
  "ads_returned": 100,
  "message": "Monitor initialized. Only new ads will be returned in subsequent runs.",
  "baseline_timestamp": "2025-01-15T10:30:05.792234+00:00",
  "search_query": "iPhone 16 Plus",
  "category": "Téléphones & Objets connectés"
}]

No New Ads Found

[{
  "monitor_summary": true,
  "timestamp": "2025-01-15T11:45:27.625202+00:00",
  "since_timestamp": "2025-01-15T11:30:15.725754+00:00",
  "new_ads_found": 0,
  "message": "No new ads found since last run"
}]

New Ads Detected

When new ads are found, you'll get the complete ad data followed by a summary:

[
  {
    "list_id": 3009018573,
    "subject": "iPhone 16 Plus 256GB Noir - État neuf",
    "price_euros": 1150.0,
    "location": {
      "city": "Paris",
      "zipcode": "75001"
    },
    "monitor_mode": true,
    "monitor_status": "new",
    "monitor_timestamp": "2025-01-15T12:06:37.831772+00:00",
    // ... complete ad data
  },
  {
    "monitor_summary": true,
    "timestamp": "2025-01-15T12:06:37.831772+00:00",
    "since_timestamp": "2025-01-15T11:45:27.625202+00:00",
    "new_ads_found": 1,
    "positional_candidates": 3,
    "reactivated_filtered": 2
  }
]

Setting up Telegram notifications

Get instant notifications for new listings:

{
  "searchQuery": "vélo électrique",
  "location": "Lyon 69",
  "mode": "monitor",
  "telegramUserId": "123456789",
  "telegramNotificationLimit": 5
}

• Get your Telegram user ID from @userinfobot
• Receive instant notifications with ad details
• Includes direct links to leboncoin listings
• Customizable notification limits to prevent spam

⚠️ Before notifications will work, you must send a message to the notification bot first:

1. Find the bot - Search for @clearpath_api_bot on Telegram
2. Send any message - Type /start or any text to initiate contact
3. Grant permission - Done! This allows the bot to send you notifications

Without this initial contact, Telegram's privacy settings prevent the bot from sending you messages.

Here's a screenshot of how it looks in Telegram:

Monitor Mode Use Cases

Deal Hunting

{
  "searchQuery": "Nintendo Switch OLED",
  "category_id": "43", // Using specific subcategory ID
  "mode": "monitor",
  "price_max_filter": 250,
  "telegramUserId": "123456789"
}

Regional Market Monitoring

{
  "searchQuery": "iPhone 16",
  "location": "Île-de-France",
  "radius": 50,
  "mode": "monitor",
  "seller_type": "pro"
}

Price Alert System

{
  "searchQuery": "MacBook Pro M3",
  "category_id": "15", // Using specific subcategory ID
  "mode": "monitor",
  "price_min_filter": 1500,
  "price_max_filter": 2200,
  "telegramUserId": "123456789"
}

Important: Bot Permission Setup

Monitor mode pairs perfectly with automated scheduling - set up Actor Tasks to run every 5-15 minutes for optimal new listing detection across France's largest marketplace.

Pricing

Pay-Per-Event (PPE) Pricing

• actor_start: $0.005 flat fee for starting an Actor run
• scraped_ad: $0.0025 flat fee per scraped ad from leboncoin.fr

Pricing Examples

• Scraped 10 ads: $0.025
• Scraped 100 ads: $0.25
• Scraped 1000 ads: $2.50

Why PPE is Better for You

Transparent, usage-based pricing - Only pay for what you actually scrape, no monthly commitments or hidden fees.

Cost-effective at any scale:

• Small projects (10 ads): $0.025 total cost
• Market research (100 ads): $0.25 total cost
• Enterprise monitoring (1,000 ads): $2.50 total cost

Memory-optimized architecture keeps platform costs minimal - our 256MB actor runs efficiently compared to standard 2-4GB scrapers.

Free Trial

• Test with up to 100 ads extraction during 24-hour trial period
• Full feature access during trial
• No credit card required to start
• Upgrade for unlimited access

Technical Requirements

• Memory: 128MB - 256MB
• Proxy: French residential proxies highly recommended for best results
• Rate limits: Built-in request management and Anti-Bot-Detection
• Location service: Automatic French location lookup and validation

Proxy Configuration

French residential proxies are strongly recommended for optimal performance:

{
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": ["RESIDENTIAL"],
    "apifyProxyCountry": "FR"
  }
}

You can also configure your own proxies in the UI or programatically:

{
  "proxyConfiguration": {
    "useApifyProxy": false,
    "proxyUrls": ["http://username:password@proxy.domain.com:8888"]
  }
}

Output Format

The scraper returns structured JSON data for each ad including:

• Basic info: Title, description, price, publication date
• Location: City, postal code, coordinates, region
• Seller details: Type (private/professional), contact info
• Product details: Condition, brand, model (category-specific)
• Images: URLs to all available photos
• Metadata: Category, filters applied, scraping timestamp

Data Export

Export results in multiple formats:

• JSON - Structured data for programmatic analysis
• CSV - Spreadsheet analysis and reporting
• Excel - Advanced data manipulation and visualization

Automation & Integration

Set up automated data collection:

• Scheduled runs - Daily, weekly, or monthly market monitoring
• Webhooks - Real-time notifications for new data
• API integration - Connect with existing business intelligence tools
• Price alert systems - Monitor specific products or price thresholds

Best Practices

For Optimal Performance

• Use French residential proxies for consistent access
• Limit memory to 128-256MB to control costs
• Implement small delays between runs
• Use specific categories rather than searching all categories

For Market Research

• Combine multiple location searches for regional analysis
• Use price filtering to focus on relevant market segments
• Sort by time to track recent market activity
• Export to CSV/Excel for deeper analysis

For Business Intelligence

• Set up scheduled runs for consistent data collection
• Use webhook notifications for real-time market changes
• Combine with external data sources for comprehensive analysis
• Implement data validation and cleaning processes

Unlimited Scraping & Trial Limits

Full Users: Extract up to 10,000 ads per run with unlimited pagination. Set adLimit: 0 for unlimited results.

Trial Users: Limited to 100 results per run during the trial period. This applies to both search queries and direct ad URL processing. Perfect for testing the actor's capabilities before upgrading.

FAQ

Q: What data is extracted from each ad? A: Complete ad information including title, description, price, location, seller details, condition, images, and category-specific attributes.

Q: How many ads can I extract? A: Unlimited. Set adLimit: 0 to extract all available results. The limit per run is 10.000 ads.

Q: Can I search specific regions of France? A: Yes, use city names, postal codes, or regions like "Île-de-France" with radius filtering for precise geographic targeting.

Q: Is the data real-time? A: Data reflects current listings on Leboncoin at extraction time. For real-time monitoring, schedule frequent runs.

Q: What about rate limiting? A: The scraper includes intelligent delays and proxy rotation. French residential proxies are essential for reliable operation.

Q: Can I monitor specific products or prices? A: Yes, combine scheduled runs with webhooks to create automated monitoring and alert systems.

Q: What formats can I export data in? A: JSON, CSV, and Excel formats are available directly from Apify, or access via API for custom integrations.

Getting Started Guide

Step 1: Set Up Your Account

1. Sign up for Apify - Create your free account
2. No credit card required for initial testing
3. Free tier included to get started

Step 2: Configure Your Search

1. Define your keywords - What products or services to search for
2. Set location parameters - Choose cities, regions, or all of France
3. Apply filters - Price range, categories, seller type, etc.
4. Set extraction limits - Control volume and costs

Step 3: Run and Monitor

1. Start extraction - Begin data collection
2. Monitor progress - Track extraction in real-time
3. Download results - Export as JSON, CSV, or Excel
4. Schedule automation - Set up recurring data collection

Step 4: Integrate and Scale

1. Use Apify API - Integrate with existing systems
2. Set up webhooks - Get real-time notifications
3. Build dashboards - Visualize market trends
4. Scale operations - Handle enterprise-level data needs

Support

• 📧 Email: max@mapa.slmail.me
• 📖 Found a bug?: Use the issues tab and describe your issue (I'll respond asap)
• 🔧 Feature Requests: Use email or the issues tab if you need more features

Legal Compliance

This scraper extracts publicly available data from Leboncoin.fr. Users must comply with Leboncoin's terms of service, French data protection laws (RGPD/GDPR), and applicable regulations for data collection and usage.

---

🚀 **Ready to extract French marketplace data? Start your market research today!**

French README

Scraper Leboncoin | Extraction Illimitée de Données d'Annonces Classées Françaises

Extrayez un nombre illimité d'annonces classées depuis Leboncoin.fr, la plateforme marketplace leader en France, grâce à ce scraper Python fiable conçu pour les études de marché, la surveillance des prix et l'intelligence d'affaires. Extrayez jusqu'à 10 000 annonces par exécution sans limitation de pagination.

⚡ Fonctionnalités Principales

Extraction illimitée - Extrayez jusqu'à 10 000 annonces par exécution avec pagination automatique Extraction complète des données d'annonces - Titres, descriptions, prix, informations vendeur, détails de localisation et images Capacités de recherche avancées - Recherche par mots-clés avec filtrage par catégorie, localisation et prix Support d'URL directes - Extrayez les détails depuis des URLs d'annonces spécifiques Mode surveillance intelligent - Suivez uniquement les nouvelles annonces depuis la dernière exécution avec algorithme de détection avancé Alertes Telegram instantanées - Recevez des notifications en temps réel pour les nouvelles annonces correspondant à vos critères Surveillance haute fréquence - Parfait pour les marchés français compétitifs où les bonnes affaires disparaissent rapidement Recherche de localisation intelligente - Recherche par ville, code postal ou région avec filtrage par rayon Filtrage complet - Gamme de prix, type de vendeur, état, options d'expédition, et plus Efficace en mémoire - Fonctionne sur 256MB pour un fonctionnement économique Support proxy français - Configuration de proxy résidentiel intégrée optimisée pour la France

🆓 Utilisateurs d'Essai

Les nouveaux utilisateurs bénéficient d'un essai gratuit avec jusqu'à 100 résultats par exécution pour tester les capacités de l'acteur. Passez à la version complète pour un accès illimité et extraire jusqu'à 10 000 annonces par exécution.

Cas d'Usage

Pour les Études de Marché et Analyses

• Surveillance des prix - Suivez les tendances tarifaires à travers les catégories et régions
• Analyse concurrentielle - Surveillez les stratégies de prix et d'inventaire des concurrents
• Dimensionnement du marché - Analysez les modèles d'offre et de demande sur des marchés spécifiques
• Insights géographiques - Comparez l'activité du marché à travers les villes et régions françaises
• Suivi de marché en temps réel - Mode surveillance pour alertes instantanées sur la nouvelle activité du marché

Pour l'Intelligence d'Affaires

• Suivi d'inventaire - Surveillez la disponibilité des produits et les prix à travers la France
• Analyse des tendances - Identifiez les produits populaires et les modèles saisonniers
• Insights de chaîne d'approvisionnement - Suivez le flux de produits et la distribution régionale
• Surveillance de marque - Surveillez la présence et les prix des marques sur la plateforme

Pour l'E-commerce et la Vente au Détail

• Tarification dynamique - Ajustez les prix basés sur les données de marché en temps réel
• Sourcing produit - Identifiez les opportunités d'acquisition de produits avec alertes instantanées
• Recherche d'entrée sur le marché - Comprenez les conditions de marché locales avant l'expansion
• Surveillance des concurrents - Suivez l'inventaire et les stratégies de prix des concurrents en temps réel
• Chasse aux bonnes affaires - Recevez des notifications instantanées quand des articles recherchés sont mis en ligne

Pour la Recherche Académique

• Recherche économique - Étudiez le comportement des consommateurs français et la dynamique du marché
• Études urbaines - Analysez les modèles d'activité économique à travers les villes françaises
• Études d'élasticité des prix - Recherchez la sensibilité aux prix dans différentes catégories
• Analyse de marketplace numérique - Étudiez la dynamique des marketplaces en ligne

Types de Recherche Supportés

• Recherches par mots-clés : Recherche par mots-clés (ex : "iPhone 16 Plus", "vélo électrique")
• Filtrage par catégorie : Électronique, Véhicules, Immobilier, Mode, et plus
• Basé sur la localisation : Noms de villes, codes postaux, ou régions avec filtrage par rayon
• URLs d'annonces directes : Extrayez les détails depuis des pages d'annonces spécifiques
• Filtres avancés : Gamme de prix, état, type de vendeur, et options d'expédition

Démarrage Rapide

Configuration de Recherche Basique

{
  "searchQuery": "iPhone 16 Plus",
  "category": "14", // Électronique (catégorie principale)
  "location": "Paris",
  "adLimit": 100,
  "price_min_filter": 500,
  "price_max_filter": 1200
}

Étude de Marché Basée sur la Localisation

{
  "searchQuery": "vélo électrique",
  "location": "Lyon 69",
  "radius": 50,
  "adLimit": 500,
  "sortBy": "price"
}

Extraction d'URL d'Annonce Directe

{
  "adDetailUrls": [
    "https://www.leboncoin.fr/ad/telephonie/3009018573",
    "https://www.leboncoin.fr/ad/informatique/3009018574"
  ]
}

Paramètres d'Entrée

Paramètre	Type	Description	Défaut
query	String	Mots-clés de recherche	Optionnel
adDetailUrls	Array	URLs d'annonces spécifiques à extraire	Optionnel
category	String	ID de catégorie principale (voir catégories ci-dessous)	"0" (Tout)
category_id	String	ID de sous-catégorie spécifique (priorité sur category)	Optionnel
location	String	Ville, code postal, ou région	Toute France
mode	String	Mode de scraping - Standard: scraping normal, Surveillance: suivi en temps réel des nouvelles annonces uniquement avec alertes Telegram	"standard"
adLimit	Integer	Nombre maximum d'annonces à extraire (0 = illimité)	20
sortBy	String	Critère de tri (relevance/time/price)	"relevance"
radius	Integer	Rayon de recherche en km autour de la localisation	5
price_min_filter	Integer	Prix minimum en euros	Optionnel
price_max_filter	Integer	Prix maximum en euros	Optionnel
search_in_title_only	Boolean	Rechercher uniquement dans les titres d'annonces	false
seller_type	String	Filtrer par vendeur (all/pro/private)	"all"
urgent	Boolean	Afficher uniquement les annonces urgentes	false
donation	Boolean	Afficher uniquement les annonces de don (gratuit)	false
shippable	Boolean	Inclure les articles expédiables	true
telegramUserId	String	Optionnel: Votre ID utilisateur Telegram pour les notifications (utilisé uniquement en mode surveillance). Obtenez-le depuis @userinfobot	Optionnel
telegramNotificationLimit	Integer	Nombre maximum de notifications Telegram par exécution (évite le spam)	10
proxyConfiguration	Object	Paramètres proxy (proxy résidentiel français recommandé)	Optionnel

Catégories Disponibles

voir ci-dessus

Données de Sortie

voir ci-dessus

Le tableau attributes peut différer selon le type d'annonce extraite.

Utilisation Avancée

Étude de Marché à Travers les Régions

{
  "searchQuery": "appartement 3 pièces",
  "category": "8", // Immobilier
  "location": "Île-de-France",
  "radius": 0,
  "adLimit": 1000,
  "price_min_filter": 200000,
  "price_max_filter": 500000,
  "sortBy": "price"
}

Analyse des Vendeurs Professionnels

{
  "searchQuery": "MacBook Pro",
  "category": "14", // Électronique
  "seller_type": "pro",
  "adLimit": 200,
  "shippable": true
}

Comparaison de Prix Géographique

{
  "searchQuery": "Tesla Model 3",
  "category": "1", // Véhicules
  "location": "Marseille 13",
  "radius": 100,
  "adLimit": 50,
  "sortBy": "price"
}

🔄 Mode Surveillance - Suivi en temps réel (Arme secrète)

Le mode surveillance transforme le scraper Leboncoin en un puissant système d'alerte en temps réel pour le marketplace français:

Comment ça fonctionne

1. Création de la ligne de base - La première exécution établit quelles annonces existent actuellement selon vos critères de recherche
2. Détection intelligente - Les exécutions suivantes ne retournent que les annonces vraiment nouvelles depuis la dernière exécution
3. Alertes instantanées - Soyez notifié immédiatement quand de nouveaux articles correspondent à vos critères via Telegram
4. Zéro bruit - Aucune annonce dupliquée ou re-postée, seulement les vraies nouvelles annonces

Système de Détection Avancé

Notre mode surveillance utilise un algorithme de détection d'annonces sophistiqué:

• Analyse positionnelle - Examine les premières pages pour les nouvelles annonces en haut
• Filtrage de ligne de base - Compare avec une ligne de base historique complète de toutes les annonces vues précédemment
• Prévention des faux positifs - Élimine les articles réactivés ou re-listés
• Détection fiable - Ne signale que les vraies nouvelles annonces qui n'étaient pas dans la ligne de base originale

Cette approche garantit que vous ne manquez jamais une vraie nouvelle annonce tout en évitant le bruit des annonces réactivées.

Dans les marchés français compétitifs où les bonnes affaires disparaissent rapidement, le mode surveillance vous donne l'avantage en vous alertant des nouvelles annonces dans les minutes suivant leur publication.

Parfait pour

• Chasse aux bonnes affaires - Soyez notifié immédiatement quand des articles recherchés sont listés
• Surveillance de marché - Suivez le nouvel inventaire dans des catégories ou régions spécifiques
• Alertes de prix - Surveillez les articles dans votre gamme de prix
• Intelligence concurrentielle - Suivez l'activité des concurrents et les lancements de nouveaux produits
• Projets de recherche - Collectez des données chronologiques sur l'activité du marketplace français

Configuration du Mode Surveillance

{
  "searchQuery": "iPhone 16 Plus",
  "category_id": "17", // Utilisation d'un ID de sous-catégorie spécifique
  "location": "Paris",
  "mode": "monitor",
  "telegramUserId": "123456789"
}

Exemples de Sortie du Mode Surveillance

Première Exécution (Initialisation)

[{
  "monitor_initialized": true,
  "total_baseline_ads": 1247,
  "baseline_ids_count": 1247,
  "ads_returned": 100,
  "message": "Monitor initialized. Only new ads will be returned in subsequent runs.",
  "baseline_timestamp": "2025-01-15T10:30:05.792234+00:00",
  "search_query": "iPhone 16 Plus",
  "category": "Téléphones & Objets connectés"
}]

Aucune Nouvelle Annonce Trouvée

[{
  "monitor_summary": true,
  "timestamp": "2025-01-15T11:45:27.625202+00:00",
  "since_timestamp": "2025-01-15T11:30:15.725754+00:00",
  "new_ads_found": 0,
  "message": "Aucune nouvelle annonce trouvée depuis la dernière exécution"
}]

Nouvelles Annonces Détectées

Quand de nouvelles annonces sont trouvées, vous obtiendrez les données complètes de l'annonce suivies d'un résumé:

[
  {
    "list_id": 3009018573,
    "subject": "iPhone 16 Plus 256GB Noir - État neuf",
    "price_euros": 1150.0,
    "location": {
      "city": "Paris",
      "zipcode": "75001"
    },
    "monitor_mode": true,
    "monitor_status": "new",
    "monitor_timestamp": "2025-01-15T12:06:37.831772+00:00",
    // ... données complètes de l'annonce
  },
  {
    "monitor_summary": true,
    "timestamp": "2025-01-15T12:06:37.831772+00:00",
    "since_timestamp": "2025-01-15T11:45:27.625202+00:00",
    "new_ads_found": 1,
    "positional_candidates": 3,
    "reactivated_filtered": 2
  }
]

Configuration des notifications Telegram

Obtenez des notifications instantanées pour les nouvelles annonces:

{
  "searchQuery": "vélo électrique",
  "location": "Lyon 69",
  "mode": "monitor",
  "telegramUserId": "123456789",
  "telegramNotificationLimit": 5
}

• Obtenez votre ID utilisateur Telegram depuis @userinfobot
• Recevez des notifications instantanées avec les détails de l'annonce
• Inclut des liens directs vers les annonces leboncoin
• Limites de notifications personnalisables pour éviter le spam

⚠️ Avant que les notifications fonctionnent, vous devez d'abord envoyer un message au bot de notification:

1. Trouvez le bot - Recherchez @clearpath_api_bot sur Telegram
2. Envoyez un message - Tapez /start ou n'importe quel texte pour initier le contact
3. Accordez la permission - Terminé ! Cela permet au bot de vous envoyer des notifications

Sans ce contact initial, les paramètres de confidentialité de Telegram empêchent le bot de vous envoyer des messages.

Voici une capture d'écran de l'apparence dans Telegram:

Cas d'Usage du Mode Surveillance

Chasse aux Bonnes Affaires

{
  "searchQuery": "Nintendo Switch OLED",
  "category_id": "43", // Utilisation d'un ID de sous-catégorie spécifique
  "mode": "monitor",
  "price_max_filter": 250,
  "telegramUserId": "123456789"
}

Surveillance de Marché Régional

{
  "searchQuery": "iPhone 16",
  "location": "Île-de-France",
  "radius": 50,
  "mode": "monitor",
  "seller_type": "pro"
}

Système d'Alerte Prix

{
  "searchQuery": "MacBook Pro M3",
  "category_id": "15", // Utilisation d'un ID de sous-catégorie spécifique
  "mode": "monitor",
  "price_min_filter": 1500,
  "price_max_filter": 2200,
  "telegramUserId": "123456789"
}

Important: Configuration des Permissions du Bot

Le mode surveillance se marie parfaitement avec la planification automatisée - configurez des Tâches d'Acteur pour s'exécuter toutes les 5-15 minutes pour une détection optimale des nouvelles annonces sur le plus grand marketplace de France.

Tarification

Tarification Pay-Per-Event (PPE)

• actor_start : 0,005$ frais fixe pour démarrer une exécution d'Acteur
• scraped_ad : 0,0025$ frais fixe par annonce extraite de leboncoin.fr

Exemples de Tarification

• 10 annonces extraites : 0,025$
• 100 annonces extraites : 0,25$
• 1000 annonces extraites : 2,50$

Pourquoi PPE est Mieux pour Vous

Tarification transparente basée sur l'usage - Ne payez que pour ce que vous extrayez réellement, sans engagement mensuel ni frais cachés.

Rentable à toute échelle :

• Petits projets (10 annonces) : 0,025$ coût total
• Étude de marché (100 annonces) : 0,25$ coût total
• Surveillance entreprise (1 000 annonces) : 2,50$ coût total

Architecture optimisée en mémoire maintient les coûts de plateforme minimaux - notre acteur 256MB fonctionne efficacement comparé aux scrapers standards de 2-4GB.

Essai Gratuit

• Test avec jusqu'à 100 extractions d'annonces pendant la période d'essai de 24 heures
• Accès complet aux fonctionnalités pendant l'essai
• Aucune carte de crédit requise pour commencer
• Passez à la version complète pour un accès illimité

Exigences Techniques

• Mémoire : 128MB - 256MB
• Proxy : Proxies résidentiels français fortement recommandés pour de meilleurs résultats
• Limites de taux : Gestion intégrée des requêtes et Anti-Bot-Detection
• Service de localisation : Recherche et validation automatique des localisations françaises

Configuration Proxy

Les proxies résidentiels français sont fortement recommandés pour des performances optimales :

{
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": ["RESIDENTIAL"],
    "apifyProxyCountry": "FR"
  }
}

Vous pouvez également configurer vos propres proxies dans l'interface utilisateur ou par programmation :

{
  "proxyConfiguration": {
    "useApifyProxy": false,
    "proxyUrls": ["http://username:password@proxy.domain.com:8888"]
  }
}

Format de Sortie

Le scraper retourne des données JSON structurées pour chaque annonce incluant :

• Informations de base : Titre, description, prix, date de publication
• Localisation : Ville, code postal, coordonnées, région
• Détails vendeur : Type (particulier/professionnel), informations de contact
• Détails produit : État, marque, modèle (spécifique à la catégorie)
• Images : URLs vers toutes les photos disponibles
• Métadonnées : Catégorie, filtres appliqués, horodatage d'extraction

Export de Données

Exportez les résultats en plusieurs formats :

• JSON - Données structurées pour l'analyse programmatique
• CSV - Analyse et rapports en feuille de calcul
• Excel - Manipulation et visualisation avancées des données

Automatisation et Intégration

Configurez la collecte de données automatisée :

• Exécutions programmées - Surveillance de marché quotidienne, hebdomadaire ou mensuelle
• Webhooks - Notifications en temps réel pour les nouvelles données
• Intégration API - Connexion avec les outils d'intelligence d'affaires existants
• Systèmes d'alerte prix - Surveillance de produits spécifiques ou de seuils de prix

Bonnes Pratiques

Pour des Performances Optimales

• Utilisez des proxies résidentiels français pour un accès cohérent
• Limitez la mémoire à 128-256MB pour contrôler les coûts
• Implémentez de petits délais entre les exécutions
• Utilisez des catégories spécifiques plutôt que de rechercher dans toutes les catégories

Pour l'Étude de Marché

• Combinez plusieurs recherches de localisation pour l'analyse régionale
• Utilisez le filtrage par prix pour vous concentrer sur les segments de marché pertinents
• Triez par temps pour suivre l'activité récente du marché
• Exportez vers CSV/Excel pour une analyse plus approfondie

Pour l'Intelligence d'Affaires

• Configurez des exécutions programmées pour une collecte de données cohérente
• Utilisez les notifications webhook pour les changements de marché en temps réel
• Combinez avec des sources de données externes pour une analyse complète
• Implémentez des processus de validation et de nettoyage des données

Extraction Illimitée et Limites d'Essai

Utilisateurs Complets : Extrayez jusqu'à 10 000 annonces par exécution avec pagination illimitée. Définissez adLimit: 0 pour des résultats illimités.

Utilisateurs d'Essai : Limités à 100 résultats par exécution pendant la période d'essai. Cela s'applique à la fois aux requêtes de recherche et au traitement d'URLs d'annonces directes. Parfait pour tester les capacités de l'acteur avant de passer à la version complète.

FAQ

Q : Quelles données sont extraites de chaque annonce ? R : Informations complètes d'annonce incluant titre, description, prix, localisation, détails vendeur, état, images, et attributs spécifiques à la catégorie.

Q : Combien d'annonces puis-je extraire ? R : Illimité. Définissez adLimit: 0 pour extraire tous les résultats disponibles. La limite par exécution est de 10 000 annonces.

Q : Puis-je rechercher dans des régions spécifiques de France ? R : Oui, utilisez les noms de villes, codes postaux, ou régions comme "Île-de-France" avec filtrage par rayon pour un ciblage géographique précis.

Q : Les données sont-elles en temps réel ? R : Les données reflètent les annonces actuelles sur Leboncoin au moment de l'extraction. Pour une surveillance en temps réel, programmez des exécutions fréquentes.

Q : Qu'en est-il de la limitation de taux ? R : Le scraper inclut des délais intelligents et une rotation de proxy. Les proxies résidentiels français sont essentiels pour un fonctionnement fiable.

Q : Puis-je surveiller des produits ou prix spécifiques ? R : Oui, combinez des exécutions programmées avec des webhooks pour créer des systèmes de surveillance et d'alerte automatisés.

Q : Dans quels formats puis-je exporter les données ? R : Les formats JSON, CSV et Excel sont disponibles directement depuis Apify, ou accès via API pour des intégrations personnalisées.

Guide de Démarrage

Étape 1 : Configurez Votre Compte

1. Inscrivez-vous sur Apify - Créez votre compte gratuit
2. Aucune carte de crédit requise pour les tests initiaux
3. Niveau gratuit inclus pour commencer

Étape 2 : Configurez Votre Recherche

1. Définissez vos mots-clés - Quels produits ou services rechercher
2. Définissez les paramètres de localisation - Choisissez villes, régions, ou toute la France
3. Appliquez les filtres - Gamme de prix, catégories, type de vendeur, etc.
4. Définissez les limites d'extraction - Contrôlez le volume et les coûts

Étape 3 : Exécutez et Surveillez

1. Démarrez l'extraction - Commencez la collecte de données
2. Surveillez les progrès - Suivez l'extraction en temps réel
3. Téléchargez les résultats - Exportez en JSON, CSV, ou Excel
4. Programmez l'automatisation - Configurez la collecte de données récurrente

Étape 4 : Intégrez et Mettez à l'Échelle

1. Utilisez l'API Apify - Intégrez avec les systèmes existants
2. Configurez les webhooks - Obtenez des notifications en temps réel
3. Construisez des tableaux de bord - Visualisez les tendances du marché
4. Mettez à l'échelle les opérations - Gérez les besoins de données au niveau entreprise

Support

• 📧 Email : max@mapa.slmail.me
• 📖 Trouvé un bug ? : Utilisez l'onglet issues et décrivez votre problème (je répondrai rapidement)
• 🔧 Demandes de fonctionnalités : Utilisez l'email ou l'onglet issues si vous avez besoin de plus de fonctionnalités

Conformité Légale

Ce scraper extrait des données publiquement disponibles depuis Leboncoin.fr. Les utilisateurs doivent se conformer aux conditions d'utilisation de Leboncoin, aux lois françaises de protection des données (RGPD), et aux réglementations applicables pour la collecte et l'utilisation des données.

---

🚀 Prêt à extraire les données du marketplace français ? Commencez votre étude de marché dès aujourd'hui !