Leboncoin Property Scraper (Pay-Per-Event)

Extract real estate listings from Leboncoin.fr. This is a pay-per-event scraper that uses advanced browser automation to collect detailed property information, including prices, locations, property features, seller details, and more. You only pay for successful property extractions.

🏠 Features

Comprehensive Data Extraction

• Basic Property Info: Listing ID, title, description, URL, publication dates
• Pricing: Property prices in EUR with detailed breakdowns
• Location Data: City, zipcode, region, department, GPS coordinates
• Property Details: Type, living area, land area, rooms, bedrooms, bathrooms
• Energy Ratings: DPE (energy performance) and GES (greenhouse gas) ratings
• Property Features: Condition, heating mode, outdoor access, parking spaces
• Seller Information: Owner name, type (private/professional), ratings, contact details
• Images: Number of photos and main property image URL

Advanced Filtering Options

• Location: Search by city, postal code, or region.
• Property Types: Houses, Apartments, Land, Parking, Other
• Price Range: Minimum and maximum price filters
• Size Filters: Living area and land plot surface area ranges
• Room Configuration: Number of rooms and bedrooms (min/max)
• Property Features: Outside access (balcony, terrace, garden, pool)
• Floor Preferences: Ground floor, upper floors, top floor
• Condition: Property condition options (Very Good, Good, Refurbished, In need of refreshing, Renovation work required)
• Owner Type: Filter by private sellers or professionals

Anti-Detection Features

• Camoufox Browser: Advanced anti-detection browser automation
• Human-like Behavior: Random delays, mouse movements, scrolling
• Stealth Navigation: Progressive form filling and UI interactions
• Proxy Support: Built-in support for residential proxies
• French Localization: Proper locale and language settings

💰 Pay-Per-Event Pricing Model

This scraper operates on a pay-per-event pricing model, meaning you only pay for successfully extracted property listings. This ensures cost-effective scraping where you're charged based on actual results rather than execution time or attempts.

• Cost Control: Set max_properties (20-1000) to control your maximum spend
• Efficient: No charges for failed attempts or empty results
• Transparent: Pay only for properties that are successfully scraped and saved

🚀 Quick Start

Input Configuration

{
  "search_term": "Paris",
  "buy_rent": "buy",
  "property_types": ["Houses", "Apartments"],
  "min_price": 100000,
  "max_price": 500000,
  "min_area": 50,
  "min_area_field": 0,
  "rooms_min": 2,
  "rooms_max": 5,
  "bedrooms_min": 1,
  "bedrooms_max": 3,
  "outside_access": ["Balcony", "Terrace"],
  "floor": ["Ground Floor"],
  "conditions": ["Very Good", "Good"],
  "owner_types": ["Private", "Professional"],
  "max_properties": 200
}

Required Input Fields

• search_term (string, required): Location to search (e.g., "Paris", "09000", "Ariège (09)")

Optional Input Fields

• buy_rent (string, default: "buy"): Transaction type - "buy" or "rent"
• property_types (array, default: ["Houses", "Apartments"]): Property types to include - ["Houses", "Apartments", "Land", "Parking", "Other"]
• min_price (integer, default: 0): Minimum price in EUR
• max_price (integer, default: 10000000): Maximum price in EUR
• min_area (integer, default: 0): Minimum living area in m²
• min_area_field (integer, default: 0): Minimum land plot surface in m²
• rooms_min (integer, default: 1): Minimum number of rooms
• rooms_max (integer, default: 8): Maximum number of rooms
• bedrooms_min (integer, default: 1): Minimum number of bedrooms
• bedrooms_max (integer, default: 8): Maximum number of bedrooms
• outside_access (array, default: []): Outdoor features - ["Balcony", "Terrace", "Garden", "Pool"]
• floor (array, default: []): Floor preferences - ["Ground Floor", "Upper Floor", "Last Stage"]
• conditions (array, default: []): Property condition requirements - ["Very Good", "Good", "Refurbished", "In need of refreshing", "Renovation work required"]
• owner_types (array, default: ["Private", "Professional"]): Seller type - ["Private", "Professional"]
• max_properties (integer, default: 200, min: 20, max: 1000): Maximum number of properties to scrape

📊 Output Data Structure

Each property listing includes the following fields:

Basic Information

{
  "list_id": 3003510840,
  "subject": "Pavillon de 5 Pièces Gondoles Sud",
  "url": "https://www.leboncoin.fr/ad/ventes_immobilieres/3003510840",
  "body": "Detailed property description...",
  "status": "active",
  "first_publication_date": "2025-08-07 09:00:21",
  "expiration_date": "2025-10-06 09:00:21"
}

Location Data

{
  "country_id": "FR",
  "region_name": "Ile-de-France",
  "department_name": "Val-de-Marne",
  "city": "Choisy-le-Roi",
  "zipcode": "94600",
  "latitude": 48.76261,
  "longitude": 2.42434
}

Property Details

{
  "price": 443000,
  "real_estate_type": "Maison",
  "square": "100",
  "land_plot_surface": "373",
  "rooms": "5",
  "bedrooms": "3",
  "nb_bathrooms": "1",
  "building_year": "1958",
  "energy_rate": "E",
  "global_condition": "Bon état"
}

Seller Information

{
  "store_id": "65179260",
  "user_id": "b6bde5e9-d96a-4dc5-93a3-9589efd38d6b",
  "owner_type": "private",
  "owner_name": "Christian",
  "no_salesmen": true,
  "rating_score": "0.99",
  "rating_count": "19"
}

⚠️ Limitations & Known Issues

• Property Limit: The scraper respects the max_properties setting (default: 200, range: 20-1000) and will stop once the limit is reached
• Page Limit: Currently processes up to 15 pages per search if max_properties allows
• Browser Detection: May occasionally be detected as automated traffic requiring reruns
• Pay-Per-Event Model: You are charged per successfully extracted property listing