Leboncoin Property Scraper

Extract real estate listings from Leboncoin.fr. This scraper advanced browser automation to collect detailed property information, including prices, locations, property features, seller details, and more.

🏠 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 from "Very Good" to "Renovation 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

🚀 Quick Start

Input Configuration

{
  "search_term": "Paris",
  "buy_rent": "buy",
  "property_types": ["Houses", "Apartments"],
  "min_price": 100000,
  "min_area": 50,
  "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"]
}

Required Input Fields

• search_term: Location to search (city, postal code, or region)
• buy_rent: Transaction type ("buy" or "rent")
• owner_types: Seller type preferences

Optional Input Fields

• property_types: Array of property types to include
• min_price/max_price: Price range in EUR
• min_area/max_area: Living area range in m²
• min_area_field/max_area_field: Land plot area range in m²
• rooms_min/rooms_max: Number of rooms range
• bedrooms_min/bedrooms_max: Number of bedrooms range
• outside_access: Outdoor features (Balcony, Terrace, Garden, Pool)
• floor: Floor preferences
• conditions: Property condition requirements

📊 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

• Page Limit: Currently processes up to 15 pages per search (approximately 525 properties)
• Browser Detection: May occasionally be detected as automated traffic requiring reruns