# Leboncoin Scraper (API) Pro đŸ‡«đŸ‡· - Annonces & Prix (`clearpath/leboncoin-api`) Actor Leboncoin.fr Scraper API: Extract classified ads with prices, locations, seller info, and photos. Filter by category, price range, and area. For market research, price monitoring, and competitive analysis across France. - **URL**: https://apify.com/clearpath/leboncoin-api.md - **Developed by:** [ClearPath](https://apify.com/clearpath) (community) - **Categories:** E-commerce, Automation, Real estate - **Features:** Limited permissions - **Stats:** 778 total users, 139 monthly users, 98.9% runs succeeded, 13 bookmarks - **User rating**: 4.96 out of 5 stars ## Pricing from $0.99 / 1,000 annonces This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event ## What's an Apify Actor? An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md. ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run. For examples already wired to this Actor's own input schema, see the [API](#api) section below. Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`). # README ## Leboncoin.fr đŸ‡«đŸ‡· Scraper | Fast French Classified Ads Data Extraction [![The #1 Leboncoin scraper on Apify. 1,000 listings in under a minute. Seller profiles. Ratings. Phone numbers.](https://api.apify.com/v2/key-value-stores/pJ7iaZsTFhR3k9tjV/records/leboncoin-api-readme-20260921-3d0017041c80.png)](https://console.apify.com/actors/nfWPDHJzRb80PsNo1/input) Built by Clearpath, creators of the #1 Leboncoin scraper on Apify and a dedicated suite for property listings, seller phone numbers and buyer messaging. ### Why choose this Leboncoin listings scraper? 1,000 search listings in under a minute. Build your dataset from a keyword or paste a Leboncoin search URL to use its filters. Export listing descriptions, photos, locations and category-specific details to JSON, CSV or Excel. Know the seller, not just the listing. Add seller ratings, review counts, response indicators, badges and professional business details. Enable phone collection to retrieve available seller phone numbers. Choose how much to collect. Set your result count without a fixed 10,000-listing search cap. Monitor mode can also collect new matching ads and send them to Telegram or your webhook. Try your search ### Try it with your keyword Start with 20 listings and seller profiles to inspect the data. ```json { "searchQuery": "iPhone 16 Plus", "adLimit": 20, "includeSeller": true } ``` Open actor input to change the keyword or paste your search URL. Increase adLimit for a larger search; collection stops at your requested count, available results or run budget. Seller profiles and phone lookups are optional paid extras and add processing time. Phone collection requires includePhone: true and your Leboncoin login, sometimes with a verification code. Enter credentials in the input form; numbers are returned where available.
Clearpath · Listings & contacts
  Listings
You are here  Cars
Make, model, mileage  Property
Homes & apartments  Phone Numbers
Seller contacts  Buyer Tools
Messages & inbox   SeLoger
France: phones & agency emails
#### Copy to your AI assistant Copy this block into ChatGPT, Claude, Cursor, or any LLM to start using this actor. ``` clearpath/leboncoin-api on Apify. Call: ApifyClient("TOKEN").actor("clearpath/leboncoin-api").call(run_input={...}), then client.dataset(run["defaultDatasetId"]).list_items().items for results. Key inputs: searchUrl (string), searchQuery (string), adLimit (integer), includePhone (boolean), email/password for phone lookup, twoFactorCode (optional string, secret; use on second run if leboncoin sends an SMS or email verification code). Full actor spec (input schema with all params/enums/defaults, output dataset fields, README): GET https://api.apify.com/v2/acts/clearpath~leboncoin-api/builds/default (Bearer TOKEN) → inputSchema, actorDefinition.storages.dataset, readme. Pricing: pay-per-event. $1.49 per 1,000 ads scraped (tiered down to $0.99 on higher Apify plans), $4.99 per 1,000 ads fetched from a direct ad URL, $2.99 per 1,000 seller profiles, $9.99 per 1,000 phone numbers. No subscription. Get token: https://console.apify.com/account/integrations ``` ### Pricing - Pay Only For What You Scrape | What you are billed for | Price | |---|---| | Run started | $0.009 per run | | Ad scraped | $1.49 / 1,000 ($1.29 Silver, $0.99 Gold and above) | | Ad fetched from a direct ad URL | $4.99 / 1,000 | | Seller profile | $2.99 / 1,000 profiles | | Phone number | $9.99 / 1,000 numbers | - ✅ No subscription, no monthly commitment - ✅ Unlimited runs and unlimited ads per run - ✅ All features included (monitor mode, Telegram notifications, filters) - ✅ A seller profile is billed once per seller, however many ads they have Perfect for businesses, researchers, and anyone who needs reliable, unrestricted access to French marketplace data. ### 🆓 Free Allowance Every account gets **1,000 ads and 25 phone numbers free**, no credit card required, so you can evaluate data quality and coverage before paying anything. ### How to scrape Leboncoin listings #### Basic Search Configuration ```json { "searchQuery": "iPhone 16 Plus", "excludeKeywords": "Pro, Max, coque", "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" ] } ``` #### Phone Number Extraction Fetch seller phone numbers alongside ad details, on a search or on specific ad URLs. Requires a free leboncoin.fr account. ```json { "adDetailUrls": [ "https://www.leboncoin.fr/ad/voitures/3133355114", "https://www.leboncoin.fr/ad/voitures/3121655546" ], "includePhone": true, "email": "your@email.com", "password": "your-password" } ``` Each ad in the output will include a `phone` field (e.g., `"+33612345678"`) when available. If leboncoin asks for a verification code, the run still returns scraped ads and skips phone lookup. Run the same input again with the latest SMS or email code in `twoFactorCode` to fetch phones. ### Input Parameters | Parameter | Type | Description | Default | | ---------------------- | ------- | ----------------------------------------------- | ----------- | | `query` | String | Search keywords | Optional | | `excludeKeywords` | String | Words to exclude from titles, comma-separated (e.g., `Pro, Max, coque`) | Optional | | `adDetailUrls` | Array | Specific ad URLs to scrape (max 100 per run) | Optional | | `includePhone` | Boolean | Fetch seller phone numbers, on a search or ad URLs (requires leboncoin account) | false | | `email` | String | Leboncoin account email (for phone lookup) | Optional | | `password` | String | Leboncoin account password (encrypted, never logged) | Optional | | `twoFactorCode` | String | SMS/email verification code for phone lookup. Use only on the second run after leboncoin requested a code | 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 | Standard extracts current results. Monitor creates a billed, notification-silent bounded baseline, then delivers new ads on a best-effort basis. | "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 | | `webhookUrl` | String | Optional HTTPS URL that receives one JSON batch only when new ads are delivered (monitor mode only) | Optional | | `webhookSecret` | String | Optional: shared secret. When set, each POST includes `X-Webhook-Signature: sha256=` (HMAC-SHA256 of the raw body) so the receiver can verify authenticity. | Optional | | `webhookNotificationLimit` | Integer | Maximum number of ads embedded in the webhook payload. Above this, the array is truncated and `truncated: true` is set. | 100 | | `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" } ] ``` ### What data you get from Leboncoin ```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", "phone": "+33172370785", "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", "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", "condition": "TrĂšs bon Ă©tat", "is_shippable": true, "price_euros": 39990.0, "location_summary": "Golbey (88190)" } ``` The `attributes` array may differ depending on the type of ad scraped. Phone ads will also include `phone_brand` and `phone_model`. Ads with an ongoing purchase show `status: "purchase_pending"` and `transaction_status: "pending"`. #### Seller Profile (included when available) Each ad may include a `seller` object with enriched profile data fetched from the seller's public profile: ```json { "seller": { "id": "35f9e6bd-b741-4cd2-8692-b6f900e36e8e", "name": "Empire auto", "type": "pro", "registered_at": "2020-03-15", "location": "Vosges", "total_ads": 47, "profile_url": "https://www.leboncoin.fr/boutique/35f9e6bd-b741-4cd2-8692-b6f900e36e8e", "profile_picture_url": "https://img.leboncoin.fr/api/v1/.../profile/pictures/default?rule=pp-large", "description": "Garage automobile spĂ©cialisĂ© dans les vĂ©hicules d'occasion toutes marques.", "feedback": { "score": 4.35, "score_raw": 0.87, "count": 124, "categories": { "communication": 0.91, "package": 0.85, "product": 0.88, "recommendation": 0.84, "user_attention": 0.87 } }, "reply": { "rate_percent": 95, "time_minutes": 30, "time_text": "RĂ©pond gĂ©nĂ©ralement en moins d'une heure" }, "presence": { "status": "ONLINE", "last_activity": "2026-03-05T08:15:00Z" }, "badges": ["VerifiedPhoneNumber", "VerifiedIdentity"], "pro": { "store_id": 5810, "store_name": "Empire auto", "siren": "539049130", "siret": "53904913000012", "sector": "1", "active_since": "2020-03-15", "website_url": "https://www.empire-auto.fr", "slogan": "Votre spĂ©cialiste automobile Ă  Golbey", "opening_hours": "Lun-Sam 9h-18h", "logo_url": "https://img.leboncoin.fr/api/v1/.../logo?rule=bo-large", "address": { "street": "1 Rue des Chaudronniers", "city": "Golbey", "zipcode": "88190" }, "rating": { "value": 4.5, "count": 89, "source": "google", "url": "https://maps.google.com/..." } } } } ``` For private sellers, the `pro` field is `null`. The `feedback`, `reply`, and `description` fields may also be `null` if the seller has no reviews, reply stats, or bio. ### Advanced Usage #### Used cars with exact criteria For car listings, [Leboncoin Voitures](https://apify.com/clearpath/leboncoin-voitures) filters by make, model, fuel, gearbox, year, mileage and power, and adds a typed `vehicle` block to every ad: mileage in km, power, and leboncoin's own price rating. #### 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 with a search URL Paste one valid leboncoin.fr search URL and set `mode` to `monitor`. The URL defines the complete search; manual fields are ignored, and results are always checked newest-first. #### How it works | Run | Dataset and billing | Notifications | |---|---|---| | First run | Creates a bounded baseline and returns up to `adLimit` baseline ads. Returned ads are billed normally. | Silent | | Later run, no new ads | Returns an unbilled monitor summary. | Silent | | Later run, new ads | Returns and bills up to `adLimit` new ads. Overflow remains pending only while it stays visible in the bounded newest-first scan. | One webhook batch and/or Telegram alerts for the delivered ads | Ads successfully committed to the history are not delivered again. History has no automatic expiry and is separate for each actor and canonical search URL. Reordering URL parameters preserves it; changing a material filter creates another history. No public reset is currently available. The first baseline is deliberately bounded. An older listing outside that scan can later appear new if it moves into the scanned results. A pending candidate is dropped after three complete scans in which it is absent. Monitoring is best-effort: zero missed listings and eventual delivery are not guaranteed. Delivery is retry-safe but not guaranteed exactly once: if a run stops after delivery but before confirmation, the same ad can appear again. Deduplicate rows and webhook ads by (`attempt_id`, `list_id`). `event_id` deduplicates only an identical batch; a capacity split can produce a different `event_id` for the same attempt. Webhook payloads contain `attempt_id`, `event_id`, `count`, `total_detected`, and `truncated`. A webhook is attempted only when ads are delivered, never for initialization or no-new runs. Delivery is best-effort: any retry happens only during that run, and a failed notification is not replayed automatically by later runs. #### Setting up Monitor Mode ```json { "searchUrl": "https://www.leboncoin.fr/recherche?category=2&locations=Troyes__48.29734_4.0744_9255&price=500-3500&owner_type=private", "mode": "monitor", "adLimit": 100, "webhookUrl": "https://hook.eu1.make.com/abc123", "telegramUserId": "123456789" } ``` #### 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: Leboncoin.fr Scraper Telegram notification #### 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 **Pay per record, from $1.49 / 1,000 ads** | What you are billed for | Price | |---|---| | Run started | $0.009 per run | | Ad scraped | $1.49 / 1,000 ($1.29 Silver, $0.99 Gold and above) | | Ad fetched from a direct ad URL | $4.99 / 1,000 | | Seller profile | $2.99 / 1,000 profiles | | Phone number | $9.99 / 1,000 numbers | - ✅ **Pay only for what you scrape** - no subscription, no monthly minimum - ✅ **Unlimited runs** - run the actor as often as required - ✅ **All features included** - monitor mode, Telegram notifications, advanced filters - ✅ **No fixed search result cap** #### Why Per-Record Pricing Works Better **You pay for output, not for time** - a month where you scrape nothing costs nothing. **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 Allowance - 1,000 ads and 25 phone numbers free - Full feature access - No credit card required to start ### Technical Requirements - **Memory**: 128MB - 256MB - **Proxy**: French residential proxies highly recommended for best results - **Reliability**: Built-in request handling for stable, large-scale collection - **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 **Search result limit**: Choose a positive `adLimit` (minimum 10). Searches have no fixed actor-imposed result cap; collection stops at your requested count, available results, or run budget. **Free allowance**: **1,000 ads and 25 phone numbers** per account. This applies to both search queries and direct ad URL processing. Perfect for evaluating the actor before paying anything. ### 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: Choose a positive `adLimit` (minimum 10). Searches have no fixed actor-imposed result cap; collection stops at your requested count, available results, or run budget. **Q: Is there a monthly usage limit?** A: No. There is no monthly cap and no rate limit — you pay per ad scraped, so scrape as much as you need. **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!](https://console.apify.com/actors/nfWPDHJzRb80PsNo1)\*\* ### French README ## Scraper Leboncoin | Extraction IllimitĂ©e de DonnĂ©es d'Annonces ClassĂ©es Françaises Extrayez des 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. Choisissez le nombre d'annonces Ă  collecter, sans plafond fixe de rĂ©sultats de recherche imposĂ© par cet acteur. **Nouveau : Extraction de numĂ©ros de tĂ©lĂ©phone** — rĂ©cupĂ©rez les numĂ©ros des vendeurs pour jusqu'Ă  100 annonces par exĂ©cution avec `includePhone`. ### 🆓 Offre de dĂ©couverte Chaque compte dispose de **1 000 annonces et 25 numĂ©ros de tĂ©lĂ©phone offerts**, sans carte de crĂ©dit, pour Ă©valuer la qualitĂ© et la couverture des donnĂ©es avant de payer quoi que ce soit. ### DĂ©marrage Rapide #### Configuration de Recherche Basique ```json { "searchQuery": "iPhone 16 Plus", "excludeKeywords": "Pro, Max, coque", "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 | | `excludeKeywords` | String | Mots Ă  exclure des titres, sĂ©parĂ©s par virgule (ex: `Pro, Max, coque`) | Optionnel | | `adDetailUrls` | Array | URLs d'annonces spĂ©cifiques Ă  extraire | Optionnel | | `includePhone` | Boolean | RĂ©cupĂ©rer les numĂ©ros de tĂ©lĂ©phone (nĂ©cessite URLs + compte leboncoin) | false | | `email` | String | Email de votre compte leboncoin (pour les tĂ©lĂ©phones) | Optionnel | | `password` | String | Mot de passe leboncoin (chiffrĂ©, jamais visible dans les logs) | Optionnel | | `twoFactorCode` | String | Code de vĂ©rification SMS/email pour les tĂ©lĂ©phones. À utiliser au deuxiĂšme lancement si leboncoin demande un code | 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 | Standard extrait les rĂ©sultats actuels. Surveillance crĂ©e une rĂ©fĂ©rence bornĂ©e facturĂ©e et silencieuse, puis livre les nouveautĂ©s au mieux. | "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](#available-categories) ### DonnĂ©es de Sortie [voir ci-dessus](#output) 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 avec une URL de recherche Collez une URL de recherche leboncoin.fr valide et choisissez `mode: "monitor"`. L'URL dĂ©finit tous les filtres et la surveillance impose l'ordre du plus rĂ©cent au plus ancien. | ExĂ©cution | Dataset et facturation | Notifications | |---|---|---| | PremiĂšre | CrĂ©e une rĂ©fĂ©rence bornĂ©e et retourne jusqu'Ă  `adLimit` annonces, facturĂ©es normalement. | Aucune | | Suivante, aucune nouveautĂ© | Retourne un rĂ©sumĂ© non facturĂ©. | Aucune | | Suivante, nouveautĂ©s | Retourne et facture jusqu'Ă  `adLimit` annonces. Le surplus reste en attente uniquement tant qu'il apparaĂźt dans le scan bornĂ©, du plus rĂ©cent au plus ancien. | Webhook et/ou Telegram uniquement pour les annonces livrĂ©es | L'historique persiste sans expiration automatique pour chaque recherche canonique. RĂ©ordonner les paramĂštres conserve l'historique ; changer un filtre important en crĂ©e un autre. Aucune rĂ©initialisation publique n'est actuellement disponible. La premiĂšre rĂ©fĂ©rence Ă©tant bornĂ©e, une ancienne annonce hors du scan peut apparaĂźtre plus tard comme nouvelle. Une annonce en attente est abandonnĂ©e aprĂšs trois scans complets oĂč elle est absente. La surveillance est au mieux : ni zĂ©ro annonce manquĂ©e ni la livraison finale ne sont garantis. La livraison n'est pas garantie exactement une fois : aprĂšs une interruption ambiguĂ«, dĂ©dupliquez par (`attempt_id`, `list_id`). `event_id` identifie uniquement un lot identique ; une capacitĂ© diffĂ©rente peut crĂ©er un autre `event_id`. Les notifications webhook sont au mieux : elles sont tentĂ©es uniquement quand des annonces sont livrĂ©es, avec une nouvelle tentative limitĂ©e Ă  l'exĂ©cution courante. Un Ă©chec n'est pas rejouĂ© automatiquement lors d'une exĂ©cution ultĂ©rieure. Le lot contient `attempt_id`, `event_id`, `count`, `total_detected` et `truncated`. #### Configuration du Mode Surveillance ```json { "searchUrl": "https://www.leboncoin.fr/recherche?category=2&locations=Troyes__48.29734_4.0744_9255&price=500-3500&owner_type=private", "mode": "monitor", "adLimit": 100, "webhookUrl": "https://hook.eu1.make.com/abc123", "telegramUserId": "123456789" } ``` #### 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: Notification Telegram du Scraper Leboncoin.fr #### 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 **Paiement Ă  l'usage, Ă  partir de 1,49 $ / 1 000 annonces** | Ce qui est facturĂ© | Prix | |---|---| | DĂ©marrage du run | 0,009 $ par exĂ©cution | | Annonce extraite | 1,49 $ / 1 000 (1,29 $ Silver, 0,99 $ Gold et plus) | | Annonce via URL directe | 4,99 $ / 1 000 | | Profil vendeur | 2,99 $ / 1 000 profils | | NumĂ©ro de tĂ©lĂ©phone | 9,99 $ / 1 000 numĂ©ros | - ✅ **Vous ne payez que ce que vous extrayez** - aucun abonnement, aucun minimum mensuel - ✅ **ExĂ©cutions illimitĂ©es** - lancez l'acteur aussi souvent que requis - ✅ **Toutes les fonctionnalitĂ©s incluses** - mode surveillance, notifications Telegram, filtres avancĂ©s - ✅ **Aucun plafond fixe de rĂ©sultats de recherche** #### Pourquoi la Tarification Ă  l'Usage Fonctionne Mieux **Vous payez pour des rĂ©sultats, pas pour du temps** - un mois sans extraction ne coĂ»te rien. **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. #### Offre de dĂ©couverte - 1 000 annonces et 25 numĂ©ros de tĂ©lĂ©phone offerts - AccĂšs complet aux fonctionnalitĂ©s - Aucune carte de crĂ©dit requise pour commencer ### Exigences Techniques - **MĂ©moire** : 128MB - 256MB - **Proxy** : Proxies rĂ©sidentiels français fortement recommandĂ©s pour de meilleurs rĂ©sultats - **FiabilitĂ©** : Gestion intĂ©grĂ©e des requĂȘtes pour une collecte stable Ă  grande Ă©chelle - **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 **Limite des rĂ©sultats de recherche** : Choisissez une valeur positive pour `adLimit` (minimum 10). Les recherches n'ont pas de plafond fixe imposĂ© par cet acteur ; la collecte s'arrĂȘte au nombre demandĂ©, aux rĂ©sultats disponibles ou au budget de l'exĂ©cution. **Offre de dĂ©couverte** : **1 000 annonces et 25 numĂ©ros de tĂ©lĂ©phone** par compte. Cela s'applique Ă  la fois aux requĂȘtes de recherche et au traitement d'URLs d'annonces directes. Parfait pour Ă©valuer l'acteur avant de payer quoi que ce soit. ### 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 : Choisissez une valeur positive pour `adLimit` (minimum 10). Les recherches n'ont pas de plafond fixe imposĂ© par cet acteur ; la collecte s'arrĂȘte au nombre demandĂ©, aux rĂ©sultats disponibles ou au budget de l'exĂ©cution. **Q : Y a-t-il une limite d'utilisation mensuelle ?** R : Non. Aucun plafond mensuel, aucune limite de frĂ©quence — vous payez Ă  l'annonce extraite, extrayez donc autant que nĂ©cessaire. **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 !**](https://console.apify.com/actors/nfWPDHJzRb80PsNo1) # Actor input Schema ## `adLimit` (type: `integer`): Nombre maximum d'annonces Ă  extraire. S'applique Ă  tous les modes (URL, mot-clĂ©, URLs d'annonces). ## `includeSeller` (type: `boolean`): RĂ©cupĂšre le profil complet du vendeur : taux de rĂ©ponse, badges, avis.

Facturé 2,99 $ / 1 000 profils vendeurs récupérés.
Peut ralentir l'exécution au-delà de 100 annonces. ## `searchUrl` (type: `string`): Collez une seule URL de recherche leboncoin.fr valide. En mode Monitor, l'URL définit tous les filtres, les champs manuels sont ignorés et l'ordre le plus récent est imposé.
Paste one valid leboncoin.fr search URL. In Monitor mode, it owns all filters, manual fields are ignored, and newest-first order is enforced. ## `adDetailUrls` (type: `array`): URLs d'annonces individuelles Ă  scraper.

Prioritaire sur l'URL de recherche et la recherche par mot-clé. Maximum 100 URLs par exécution. ## `searchQuery` (type: `string`): Recherche par mot-clé. Ignoré si une URL de recherche est fournie. ## `excludeKeywords` (type: `string`): Mots à exclure des titres, séparés par des virgules. ## `category` (type: `string`): Catégorie principale de recherche. ## `location` (type: `string`): Ville ou département. Vide (ou « Toute la France ») = recherche sur toute la France.

Exemples : Paris, Lyon 69, Strasbourg 67 ## `radius` (type: `integer`): Rayon autour de la localisation choisie. ## `sortBy` (type: `string`): Ordre de tri des résultats. ## `price_min_filter` (type: `integer`): Filtre prix minimum en euros. ## `price_max_filter` (type: `integer`): Filtre prix maximum en euros. ## `search_in_title_only` (type: `boolean`): Limite la recherche aux titres d'annonces (ignore le contenu). ## `seller_type` (type: `string`): Filtrer par type de vendeur. ## `urgent` (type: `boolean`): Afficher uniquement les annonces marquées « Urgent ». ## `donation` (type: `boolean`): Afficher uniquement les annonces gratuites. ## `shippable` (type: `boolean`): Inclut les annonces avec livraison possible.

Attention : si activé avec une localisation, la localisation est ignorée par l'API. Le scraper désactive automatiquement cette option quand une localisation est définie. ## `category_id` (type: `string`): ID numérique d'une sous-catégorie spécifique. Prioritaire sur la catégorie principale.

Voir la liste des IDs. ## `includePhone` (type: `boolean`): RécupÚre le numéro de téléphone du vendeur pour chaque annonce (recherche ou URLs d'annonces).

Facturé 9,99 $ / 1 000 numéros récupérés.
Requis : un compte leboncoin.fr (gratuit).
Les identifiants sont chiffrés et jamais stockés. ## `email` (type: `string`): Email de votre compte leboncoin.fr. Requis si « Numéros de téléphone » est activé. ## `password` (type: `string`): Mot de passe de votre compte leboncoin.fr. Chiffré, jamais visible dans les logs. ## `twoFactorCode` (type: `string`): Optionnel. Si leboncoin demande un code de vérification par SMS ou email, lancez d'abord l'acteur sans ce champ pour demander le code. Relancez ensuite avec le dernier code reçu, idéalement dans les 15 minutes.

Optional. If leboncoin asks for an SMS or email verification code, first run without this field to request the code. Then run again with the latest code, preferably within 15 minutes. ## `mode` (type: `string`): Standard : extraction classique. Monitor : la premiÚre exécution retourne une référence bornée facturée sans notification. Le surplus reste en attente tant qu'il apparaßt dans le scan borné, du plus récent au plus ancien, puis est abandonné aprÚs trois absences complÚtes. La livraison est au mieux ; aucune garantie de zéro annonce manquée ou de livraison finale.
Standard extracts current results. Monitor returns a billed, notification-silent bounded baseline first. Overflow remains pending only while it appears in the bounded newest-first scan, then is dropped after three complete misses. Delivery is best-effort; zero missed listings and eventual delivery are not guaranteed. ## `telegramUserId` (type: `string`): Votre ID Telegram pour les notifications (mode Monitor uniquement).
Obtenez-le via @userinfobot sur Telegram. ## `telegramNotificationLimit` (type: `integer`): Nombre maximum de notifications Telegram par exécution (anti-spam). ## `webhookUrl` (type: `string`): URL HTTPS contactée uniquement lorsque des annonces sont livrées. Envoi au mieux, avec nouvelle tentative limitée à l'exécution courante ; un échec n'est pas rejoué plus tard.
HTTPS URL attempted only when ads are delivered. Best-effort, with retries limited to the current run; failures are not replayed later. ## `webhookSecret` (type: `string`): Secret optionnel pour signer le corps JSON avec HMAC-SHA256 dans X-Webhook-Signature. Chiffré et masqué.
Optional secret used to sign the JSON body with HMAC-SHA256. Encrypted and masked. ## `webhookNotificationLimit` (type: `integer`): Nombre maximum d'annonces dans le lot. truncated: true indique une troncature. DĂ©dupliquez par attempt_id + list_id ; event_id ne couvre qu'un lot identique.
Maximum ads per batch. truncated: true marks truncation. Deduplicate by attempt_id + list_id; event_id covers only an identical batch. ## Actor input object example ```json { "adLimit": 100, "includeSeller": true, "searchUrl": "https://www.leboncoin.fr/recherche?category=2&u_car_brand=BMW&fuel=2,6", "adDetailUrls": [ "https://www.leboncoin.fr/ad/accessoires_bagagerie/3009018573" ], "searchQuery": "iPhone 16 Plus", "excludeKeywords": "Pro, Max, coque", "category": "0", "location": "Paris", "radius": 5, "sortBy": "relevance", "price_min_filter": 100, "price_max_filter": 500, "search_in_title_only": false, "seller_type": "all", "urgent": false, "donation": false, "shippable": true, "includePhone": false, "mode": "standard", "telegramNotificationLimit": 10, "webhookUrl": "https://hook.eu1.make.com/abc123", "webhookNotificationLimit": 100 } ``` # Actor output Schema ## `results` (type: `string`): No description # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "adLimit": 100, "searchQuery": "iPhone 16 Plus" }; // Run the Actor and wait for it to finish const run = await client.actor("clearpath/leboncoin-api").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`đŸ’Ÿ Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "adLimit": 100, "searchQuery": "iPhone 16 Plus", } # Run the Actor and wait for it to finish run = client.actor("clearpath/leboncoin-api").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print(f"đŸ’Ÿ Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}") for item in client.dataset(run.default_dataset_id).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "adLimit": 100, "searchQuery": "iPhone 16 Plus" }' | apify call clearpath/leboncoin-api --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "type": "http", "url": "https://mcp.apify.com/?tools=fetch-actor-details,clearpath/leboncoin-api" } } } ``` The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer ` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations). ## OpenAPI specification Download the OpenAPI definition: https://api.apify.com/v2/actors/nfWPDHJzRb80PsNo1/builds/7NbredRNg5yjwlZeA/openapi.json