Leboncoin Universal Scraper

Extracts structured listing data from Leboncoin.fr, the French marketplace. Turns search results into JSON or CSV for analysis, monitoring, or integration.

Categories: Automation, Real Estate, E-commerce

Overview

This actor scrapes Leboncoin based on your search URLs. You provide a search link, and it returns all listings with details like price, location, attributes, and images. It's designed for automated data collection without manual copying.

Key Features

• Flexible Input: Run one or multiple search URLs simultaneously.
• Rich Data Extraction: Captures listing title, description, price, images, location (with coordinates), and category-specific attributes (e.g., surface area, rooms, DPE rating for real estate).
• Pagination Control: Configure max_pages to limit results or set to 0 for no limit.
• Performance: Typically scrapes 100-200 listings per minute.
• Output Formats: Data is available in structured JSON and can be downloaded as CSV.
• Proxy Support: Configure proxies to avoid blocking; using French residential proxies is recommended for high-volume runs.

How to Use

1. Go to Leboncoin.fr and perform a search with your filters (location, price, etc.).
2. From the search results page, copy the full URL from your browser's address bar. It should look like: https://www.leboncoin.fr/recherche?category=9&locations=Paris&price=250000-400000
3. In the actor's Input tab, paste the URL into the urls_list field.
4. Configure any optional settings (like max_pages or proxyConfiguration).
5. Run the actor. Fetch your data from the Output tab once it finishes.

Input Configuration

Configure the actor using a JSON input. Here's the key field:

{
  "urls_list": [
    "https://www.leboncoin.fr/recherche?category=9&locations=Paris"
  ],
  "max_pages": 0,
  "max_age_days": 0,
  "limit_per_page": 35,
  "delay_between_pages": 0,
  "proxyConfiguration": {
    "useApifyProxy": false,
    "proxyUrls": ["http://user:pass@proxy.example.com:8000"]
  }
}

• urls_list (Required): An array of one or more Leboncoin search URLs.
• max_pages: Maximum number of result pages to scrape per URL. 0 means no limit.
• max_age_days: Ignored for this actor; data is always fresh from the live site.
• proxyConfiguration: For using custom proxies. For Apify Proxy, set "useApifyProxy": true.

Output Example

The actor outputs an array of items. Each item is a detailed JSON object for one listing.

{
  "id": 3083651141,
  "subject": "Appartement 2 pièces 28 m²",
  "body": "2 pièces, complètement rénové, Paris 11ème...",
  "url": "https://www.leboncoin.fr/ad/ventes_immobilieres/3083651141",
  "price": 329500,
  "category_name": "Ventes immobilières",
  "location": {
    "city": "Paris",
    "zipcode": "75011",
    "lat": 48.85763,
    "lng": 2.38005
  },
  "attributes": [
    { "key": "real_estate_type", "value_label": "Appartement" },
    { "key": "square", "value_label": "28 m²" },
    { "key": "rooms", "value_label": "2" }
  ],
  "images": ["https://img.leboncoin.fr/api/v1/lbcpb1/images/...jpg"],
  "scraped_at": "2025-10-29 22:29:25",
  "search_url": "https://www.leboncoin.fr/recherche?category=9&locations=Paris"
}

Notes & FAQ

• Cost: The actor is available via a monthly subscription for unlimited runs.
• Legality: It extracts only publicly available data. You are responsible for complying with Leboncoin's Terms of Service and data protection regulations like GDPR.
• Freshness: Data is scraped live at the time of the actor's run.
• Automation: Can be integrated into workflows using the Apify API.
• Support: For issues or questions, use the Issues tab on the actor's page.