Pricing

from $0.99 / 1,000 annonces

Try for free

Go to Apify Store

Leboncoin Scraper (API) Pro 🇫🇷 - Annonces & Prix

Try for free

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.

Pricing

from $0.99 / 1,000 annonces

Rating

4.9

(5)

Developer

ClearPath

Actor stats

Bookmarked

421

Total users

Monthly active users

9 hours ago

Last modified

Categories

E-commerce

Automation

Real estate

You can access the Leboncoin Scraper (API) Pro 🇫🇷 - Annonces & Prix programmatically from your own applications by using the Apify API. You can also choose the language preference from below. To use the Apify API, you’ll need an Apify account and your API token, found in API & Integrations in Apify Console.

Python

JavaScript

CLI

OpenAPI

HTTP

MCP

{
  "openapi": "3.0.1",
  "info": {
    "version": "0.0",
    "x-build-id": "yAMoT92bQQuu4kJ7C"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/clearpath~leboncoin-api/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-clearpath-leboncoin-api",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/acts/clearpath~leboncoin-api/runs": {
      "post": {
        "operationId": "runs-sync-clearpath-leboncoin-api",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor and returns information about the initiated run in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/runsResponseSchema"
                }
              }
            }
          }
        }
      }
    },
    "/acts/clearpath~leboncoin-api/run-sync": {
      "post": {
        "operationId": "run-sync-clearpath-leboncoin-api",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "inputSchema": {
        "type": "object",
        "properties": {
          "adLimit": {
            "title": "Nombre max d'annonces",
            "minimum": 10,
            "maximum": 10000,
            "type": "integer",
            "description": "Nombre maximum d'annonces à extraire. S'applique à tous les modes (URL, mot-clé, URLs d'annonces).",
            "default": 100
          },
          "includeSeller": {
            "title": "Profils vendeurs détaillés",
            "type": "boolean",
            "description": "Récupère le profil complet du vendeur : taux de réponse, badges, avis.<br><br>Facturé 2,99 $ / 1 000 profils vendeurs récupérés.<br>Peut ralentir l'exécution au-delà de 100 annonces.",
            "default": true
          },
          "searchUrl": {
            "title": "URL de recherche",
            "type": "string",
            "description": "Collez une URL de recherche leboncoin.fr. Tous les filtres (catégorie, prix, localisation, marque, etc.) sont extraits automatiquement.<br><br>Prioritaire sur la recherche par mot-clé."
          },
          "adDetailUrls": {
            "title": "URLs d'annonces",
            "maxItems": 100,
            "type": "array",
            "description": "URLs d'annonces individuelles à scraper.<br><br>Prioritaire sur l'URL de recherche et la recherche par mot-clé. Maximum 100 URLs par exécution.",
            "items": {
              "type": "string"
            }
          },
          "searchQuery": {
            "title": "Mot-clé",
            "type": "string",
            "description": "Recherche par mot-clé. Ignoré si une URL de recherche est fournie."
          },
          "excludeKeywords": {
            "title": "Mots à exclure",
            "type": "string",
            "description": "Mots à exclure des titres, séparés par des virgules."
          },
          "category": {
            "title": "Catégorie",
            "enum": [
              "0",
              "8",
              "9",
              "10",
              "11",
              "13",
              "2001",
              "1",
              "2",
              "3",
              "4",
              "5",
              "7",
              "1002",
              "6",
              "14",
              "17",
              "15",
              "43",
              "18",
              "72",
              "22",
              "53",
              "42",
              "79",
              "24",
              "29",
              "27",
              "30",
              "75",
              "71",
              "12",
              "56",
              "38"
            ],
            "type": "string",
            "description": "Catégorie principale de recherche.",
            "default": "0"
          },
          "location": {
            "title": "Localisation",
            "type": "string",
            "description": "Ville ou département. Vide = toute la France.<br><br>Exemples : <code>Paris</code>, <code>Lyon 69</code>, <code>Strasbourg 67</code>"
          },
          "radius": {
            "title": "Rayon de recherche (km)",
            "minimum": 0,
            "maximum": 200,
            "type": "integer",
            "description": "Rayon autour de la localisation choisie.",
            "default": 5
          },
          "sortBy": {
            "title": "Trier par",
            "enum": [
              "relevance",
              "time",
              "price"
            ],
            "type": "string",
            "description": "Ordre de tri des résultats.",
            "default": "relevance"
          },
          "price_min_filter": {
            "title": "Prix minimum (€)",
            "minimum": 0,
            "type": "integer",
            "description": "Filtre prix minimum en euros."
          },
          "price_max_filter": {
            "title": "Prix maximum (€)",
            "minimum": 0,
            "type": "integer",
            "description": "Filtre prix maximum en euros."
          },
          "search_in_title_only": {
            "title": "Rechercher dans le titre uniquement",
            "type": "boolean",
            "description": "Limite la recherche aux titres d'annonces (ignore le contenu).",
            "default": false
          },
          "seller_type": {
            "title": "Type de vendeur",
            "enum": [
              "all",
              "pro",
              "private"
            ],
            "type": "string",
            "description": "Filtrer par type de vendeur.",
            "default": "all"
          },
          "urgent": {
            "title": "Annonces urgentes uniquement",
            "type": "boolean",
            "description": "Afficher uniquement les annonces marquées « Urgent ».",
            "default": false
          },
          "donation": {
            "title": "Dons uniquement (gratuit)",
            "type": "boolean",
            "description": "Afficher uniquement les annonces gratuites.",
            "default": false
          },
          "shippable": {
            "title": "Inclure annonces livrables",
            "type": "boolean",
            "description": "Inclut les annonces avec livraison possible.<br><br><b>Attention :</b> 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.",
            "default": true
          },
          "category_id": {
            "title": "Sous-catégorie (ID)",
            "pattern": "^[0-9]*$",
            "type": "string",
            "description": "ID numérique d'une sous-catégorie spécifique. Prioritaire sur la catégorie principale.<br><br>Voir la <a href=\"https://apify.com/clearpath/leboncoin-api#input-parameters\" target=\"_blank\">liste des IDs</a>."
          },
          "includePhone": {
            "title": "Numéros de téléphone",
            "type": "boolean",
            "description": "Récupère le numéro de téléphone du vendeur pour chaque annonce (recherche ou URLs d'annonces).<br><br>Facturé 9,99 $ / 1 000 numéros récupérés.<br><b>Requis :</b> un compte leboncoin.fr (gratuit).<br>Les identifiants sont chiffrés et jamais stockés.",
            "default": false
          },
          "email": {
            "title": "Email leboncoin",
            "type": "string",
            "description": "Email de votre compte leboncoin.fr. Requis si « Numéros de téléphone » est activé."
          },
          "password": {
            "title": "Mot de passe leboncoin",
            "type": "string",
            "description": "Mot de passe de votre compte leboncoin.fr. Chiffré, jamais visible dans les logs."
          },
          "twoFactorCode": {
            "title": "Code de vérification / 2FA",
            "type": "string",
            "description": "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.<br><br>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": {
            "title": "Mode",
            "enum": [
              "standard",
              "monitor"
            ],
            "type": "string",
            "description": "Mode de scraping.<br><br><b>Standard :</b> scraping classique.<br><b>Monitor :</b> détecte uniquement les nouvelles annonces depuis la dernière exécution.",
            "default": "standard"
          },
          "telegramUserId": {
            "title": "Telegram User ID",
            "type": "string",
            "description": "Votre ID Telegram pour les notifications (mode Monitor uniquement).<br>Obtenez-le via <code>@userinfobot</code> sur Telegram."
          },
          "telegramNotificationLimit": {
            "title": "Limite de notifications Telegram",
            "minimum": 1,
            "maximum": 30,
            "type": "integer",
            "description": "Nombre maximum de notifications Telegram par exécution (anti-spam).",
            "default": 10
          },
          "webhookUrl": {
            "title": "Webhook URL",
            "type": "string",
            "description": "Endpoint HTTPS qui reçoit un POST JSON regroupant toutes les nouvelles annonces détectées (mode Monitor uniquement). Compatible Make, Zapier, n8n ou tout serveur HTTP.<br><br>HTTPS obligatoire. Un seul appel par exécution."
          },
          "webhookSecret": {
            "title": "Webhook secret (optionnel)",
            "type": "string",
            "description": "Si renseigné, chaque requête inclut un header <code>X-Webhook-Signature: sha256=&lt;hex&gt;</code> calculé en HMAC-SHA256 sur le corps brut. Permet de vérifier l'authenticité côté serveur. Chiffré, jamais visible dans les logs."
          },
          "webhookNotificationLimit": {
            "title": "Limite d'annonces par webhook",
            "minimum": 1,
            "maximum": 500,
            "type": "integer",
            "description": "Nombre maximum d'annonces incluses dans le payload du webhook. Au-delà, le tableau est tronqué et <code>truncated: true</code> apparaît dans le payload.",
            "default": 100
          }
        }
      },
      "runsResponseSchema": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "actId": {
                "type": "string"
              },
              "userId": {
                "type": "string"
              },
              "startedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "finishedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "status": {
                "type": "string",
                "example": "READY"
              },
              "meta": {
                "type": "object",
                "properties": {
                  "origin": {
                    "type": "string",
                    "example": "API"
                  },
                  "userAgent": {
                    "type": "string"
                  }
                }
              },
              "stats": {
                "type": "object",
                "properties": {
                  "inputBodyLen": {
                    "type": "integer",
                    "example": 2000
                  },
                  "rebootCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "restartCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "resurrectCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "computeUnits": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "options": {
                "type": "object",
                "properties": {
                  "build": {
                    "type": "string",
                    "example": "latest"
                  },
                  "timeoutSecs": {
                    "type": "integer",
                    "example": 300
                  },
                  "memoryMbytes": {
                    "type": "integer",
                    "example": 1024
                  },
                  "diskMbytes": {
                    "type": "integer",
                    "example": 2048
                  }
                }
              },
              "buildId": {
                "type": "string"
              },
              "defaultKeyValueStoreId": {
                "type": "string"
              },
              "defaultDatasetId": {
                "type": "string"
              },
              "defaultRequestQueueId": {
                "type": "string"
              },
              "buildNumber": {
                "type": "string",
                "example": "1.0.0"
              },
              "containerUrl": {
                "type": "string"
              },
              "usage": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "integer",
                    "example": 1
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "usageTotalUsd": {
                "type": "number",
                "example": 0.00005
              },
              "usageUsd": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "number",
                    "example": 0.00005
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}

Leboncoin Scraper (API) Pro 🇫🇷 - Annonces & Prix OpenAPI definition

OpenAPI is a standard for designing and describing RESTful APIs, allowing developers to define API structure, endpoints, and data formats in a machine-readable way. It simplifies API development, integration, and documentation.

OpenAPI is effective when used with AI agents and GPTs by standardizing how these systems interact with various APIs, for reliable integrations and efficient communication.

By defining machine-readable API specifications, OpenAPI allows AI models like GPTs to understand and use varied data sources, improving accuracy. This accelerates development, reduces errors, and provides context-aware responses, making OpenAPI a core component for AI applications.

You can download the OpenAPI definitions for Leboncoin Scraper (API) Pro 🇫🇷 - Annonces & Prix from the options below:

OpenAPI.json

If you’d like to learn more about how OpenAPI powers GPTs, read our blog post.

You can also check out our other API clients:

Leboncoin Scraper (API) Pro 🇫🇷 - Annonces & Prix API in Python

Leboncoin Scraper (API) Pro 🇫🇷 - Annonces & Prix API in JavaScript

Leboncoin Scraper (API) Pro 🇫🇷 - Annonces & Prix API through CLI

Leboncoin Scraper (API) Pro 🇫🇷 - Annonces & Prix API

Leboncoin Listings Scraper

piotrv1001/leboncoin-listings-scraper

Leboncoin Listings Scraper scrapes listings from leboncoin.fr search results, capturing titles, prices, images, location, seller info, category attributes, and optional full details — ideal for price tracking, market research, and competitive analysis of France's largest classifieds marketplace.

FalconScrape

5.0

Advanced Leboncoin scraper

saswave/advanced-leboncoin-scraper

Leboncoin scraper. Collect product from any search website leboncoin.fr Advanced Web crawler for ecommerce leboncoin. Extract phonenumber from detail pages. For market research, price monitoring, competitive analysis, business intelligence. Efficient data extraction and reduced runtime costs.

SASWAVE

756

5.0

Leboncoin.fr Scraper | $1 / 1k | Fast & Reliable

fatihtahta/leboncoin-fr-scraper

Extract clean, structured data from France’s top classifieds site Leboncoin.fr. Get listings for real estate, cars, jobs, and more with rich outputs including pricing, location, seller details and more. Ideal for market research, lead gen or price tracking.

Fatih Tahta

588

3.6

Leboncoin Scraper Ppe

silentflow/leboncoin-scraper-ppr

Scrape Leboncoin classified ads with pay-per-result pricing. Extract prices, full descriptions, seller phone numbers and GPS coordinates from France's largest marketplace. Covers real estate, cars, jobs, fashion and electronics. Pay only for ads successfully scraped, residential proxies included.

SilentFlow

410

5.0

Leboncoin Immobilier Phone Leads Scraper

mostafa-ennadi/leboncoin-immobilier-phone-leads-scraper

💰$1 per 1,000 annonces, Extract Leboncoin real estate ads with phone numbers using filters like city, price range, property type, furnished status, rooms, bedrooms, surface, energy rating, outdoor features, floor, orientation, condition, keywords, and seller type. Export results in JSON or CSV.

mostafa ennadi

5.0

Leboncoin Universal Scraper

scrapifier/leboncoin-universal-scraper

⚡ Extract unlimited Leboncoin listings in seconds! Just drop your search URL and instantly get rich, structured data — ready for market insights, real estate deals, pricing intel, or lead generation. Stop copying listings manually — automate it all and stay ahead!

Scrapifier

147

2.7

Seloger Scraper

silentflow/seloger-scraper

Scrape SeLoger.com - France's #1 real estate portal. Extract apartments, houses, rentals in Paris, Lyon, Marseille. Get prices, DPE energy class, photos, agency phone & email. Monitor new listings with Delta mode. Export Excel, CSV, JSON.

SilentFlow

French License Plate Lookup

freecamp008/french-license-plate-lookup

Look up detailed information about French vehicles by license plate. Retrieves structured data such as brand, model, year, specifications, history, and more. Obtenez des informations détaillées sur les véhicules immatriculés en France à partir de leur plaque d’immatriculation.

Camp8 fr0

Leboncoin & SeLoger Real Estate Scraper — Agency Leads (FR)

ccdeveloppement/real-estate-scraper

Scrape French real-estate listings from Leboncoin & SeLoger — with the seller's agency name, phone & email per listing. Plus price, €/m², surface, DPE, GPS. For lead generation, pige & prospecting. Export JSON/CSV/Excel. Contacts vendeurs + annonces, paiement au résultat.

Cyril Canon

Immoweb Scraper

ivanvs/immoweb-scraper

Extract data from immoweb.be for data on thousands of apartments and house listings. Scrape house location, extract descriptions, images, prices, contact number, addresses, names, and all other listing details. Unlimited and extremely fast!