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. ## Rental Pricing - Simple & Predictable $30 per month - Unlimited scraping, unlimited runs, no hidden fees. - ✅ Scrape unlimited ads per month - ✅ Run the actor as many times as you need - ✅ All features included (monitor mode, Telegram notifications, filters) - ✅ Cancel anytime Perfect for businesses, researchers, and anyone who needs reliable, unrestricted access to French marketplace data. 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 json { "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 json { "searchQuery": "vélo électrique", "location": "Lyon 69", "radius": 50, "adLimit": 500, "sortBy": "price" } ### Direct Ad URL Extraction json { "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 json [ { "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 json { "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 json { "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 json { "searchQuery": "MacBook Pro", "category": "14", // Électronique "seller_type": "pro", "adLimit": 200, "shippable": true } ### Geographic Price Comparison json { "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 json { "searchQuery": "iPhone 16 Plus", "category_id": "17", // Using specific subcategory ID "location": "Paris", "mode": "monitor", "telegramUserId": "123456789" } ### Monitor Mode Output Examples #### First Run (Initialization) json [{ "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 json [{ "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: json [ { "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: json { "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 json { "searchQuery": "Nintendo Switch OLED", "category_id": "43", // Using specific subcategory ID "mode": "monitor", "price_max_filter": 250, "telegramUserId": "123456789" } #### Regional Market Monitoring json { "searchQuery": "iPhone 16", "location": "Île-de-France", "radius": 50, "mode": "monitor", "seller_type": "pro" } #### Price Alert System json { "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 Simple Monthly Rental - $30/month Unlimited scraping with predictable costs: - ✅ Unlimited ads per month - scrape as many as you need - ✅ Unlimited runs - run the actor as often as required - ✅ All features included - monitor mode, Telegram notifications, advanced filters - ✅ No usage limits - up to 10,000 ads per run - ✅ Cancel anytime - no long-term commitments ### Why Rental Pricing Works Better Predictable costs - Know exactly what you'll pay each month, no surprises based on usage. Best for regular users: - Market research firms - Continuous monitoring without worrying about per-ad costs - E-commerce businesses - Track competitor pricing daily without budget concerns - Real estate professionals - Monitor listings across France without usage anxiety - Researchers - Collect comprehensive datasets for academic studies 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 - Subscribe for unlimited access at $30/month ## 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: json { "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": ["RESIDENTIAL"], "apifyProxyCountry": "FR" } } You can also configure your own proxies in the UI or programatically: json { "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 json { "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 json { "searchQuery": "vélo électrique", "location": "Lyon 69", "radius": 50, "adLimit": 500, "sortBy": "price" } ### Extraction d'URL d'Annonce Directe json { "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 json { "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 json { "searchQuery": "MacBook Pro", "category": "14", // Électronique "seller_type": "pro", "adLimit": 200, "shippable": true } ### Comparaison de Prix Géographique json { "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 json { "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) json [{ "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 json [{ "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é: json [ { "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: json { "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 json { "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 json { "searchQuery": "iPhone 16", "location": "Île-de-France", "radius": 50, "mode": "monitor", "seller_type": "pro" } #### Système d'Alerte Prix json { "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 Location Mensuelle Simple - 30$/mois Extraction illimitée avec coûts prévisibles: - ✅ Annonces illimitées par mois - extrayez autant que nécessaire - ✅ Exécutions illimitées - lancez l'acteur aussi souvent que requis - ✅ Toutes les fonctionnalités incluses - mode surveillance, notifications Telegram, filtres avancés - ✅ Aucune limite d'utilisation - jusqu'à 10 000 annonces par exécution - ✅ Annulation à tout moment - sans engagement à long terme ### Pourquoi la Tarification Locative Fonctionne Mieux Coûts prévisibles - Sachez exactement ce que vous paierez chaque mois, sans surprises basées sur l'utilisation. Idéal pour les utilisateurs réguliers: - Cabinets d'études de marché - Surveillance continue sans souci des coûts par annonce - Entreprises e-commerce - Suivez les prix des concurrents quotidiennement sans inquiétude budgétaire - Professionnels de l'immobilier - Surveillez les annonces à travers la France sans anxiété d'utilisation - Chercheurs - Collectez des ensembles de données complets pour des études académiques 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 - Abonnez-vous pour un accès illimité à 30$/mois ## 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 : json { "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": ["RESIDENTIAL"], "apifyProxyCountry": "FR" } } Vous pouvez également configurer vos propres proxies dans l'interface utilisateur ou par programmation : json { "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 !