🏠 French Real Estate Scraper — Immobilier France

Scrape French real estate listings from Bien'ici (primary) and Trovit (fallback) — no residential proxy required for Bien'ici.

🔍 What It Does

This Apify Actor scrapes property listings from French real estate platforms, extracts structured data, and outputs it for analysis, market research, or lead generation.

Supported Platforms

• Bien'ici — Modern property search platform with structured listings (primary target)
• Trovit — Aggregated real estate classifieds (fallback)

📋 Features

• Bien'ici-first design — Works from datacenter IPs without proxy (no Cloudflare)
• Trovit fallback — Automatically falls back to Trovit if Bien'ici has no results
• Smart filtering — Filter by city, property type, price range, rooms, and surface area
• Rich data extraction — Title, price, surface, rooms, bedrooms, address, city, zipCode, description, images, energy class (DPE), agency
• French price parsing — Handles '450 000 €', '1 200 €/mois', NB (non communiqué)
• Property types — Appartement and maison
• Smart pagination — Configurable pages per site with URL-based deduplication
• Anti-detection — Random delays (3-8s), session pooling, max 2 concurrent browsers
• Detail page enrichment — Visits individual listing pages for full descriptions and images
• Optional proxy — Built-in Apify proxy support for enhanced reliability

🏗️ Input Parameters

Parameter	Type	Default	Description
city	string	Paris	Target city (e.g., 'Lyon', 'Marseille')
propertyType	string	appartement	appartement or maison
minPrice	integer	—	Minimum price in euros
maxPrice	integer	—	Maximum price in euros
minRooms	integer	—	Minimum number of rooms
maxRooms	integer	—	Maximum number of rooms
minSurface	integer	—	Minimum surface in m²
maxSurface	integer	—	Maximum surface in m²
maxPages	integer	3	Pages per site
useProxy	boolean	false	Enable Apify proxy

📊 Output Data

Each listing includes:

{
  "title": "Appartement T3 Paris 15ème",
  "price": 450000,
  "surface": 65,
  "rooms": 3,
  "bedrooms": 2,
  "address": "15 rue de Rivoli, 75001 Paris",
  "city": "Paris",
  "zipCode": "75001",
  "source": "bienici",
  "url": "https://www.bienici.com/annonces/achat/...",
  "images": ["https://res.bienici.com/...jpg"],
  "description": "Bel appartement avec vue sur la tour Eiffel...",
  "energyClass": "C",
  "agency": "Century 21 Paris",
  "scrapedAt": "2026-07-04T12:00:00.000Z"
}

🚀 Usage

On Apify Platform

1. Go to Apify Console
2. Search for "French Real Estate Scraper"
3. Click Try actor
4. Fill in the input form (city, filters, etc.)
5. Click Start

Via API

curl -X POST "https://api.apify.com/v2/acts/french-realestate-scraper/runs" \
  -H "Content-Type: application/json" \
  -d '{
    "city": "Paris",
    "propertyType": "appartement",
    "minPrice": 200000,
    "maxPrice": 500000,
    "minRooms": 2,
    "maxPages": 5
  }'

Locally

# Clone the repository
git clone https://github.com/your-org/french-realestate-scraper.git
cd french-realestate-scraper

# Install dependencies
npm install

# Run tests
npm test

# Run locally (requires APIFY_TOKEN environment variable)
node src/main.js

🔧 Technical Details

• Crawler: PlaywrightCrawler (headless Chromium)
• Concurrency: Max 2 concurrent browsers
• Session Pool: 30 sessions with auto-retirement on blocks
• Request Delay: Random 3-8 seconds between requests
• Deduplication: URL-based dedup across all sites
• Error Handling: Captcha detection, session retirement, retry logic
• Crawlee: v3.12+ (valid options only — no throwOnBlockedRequest, maxUsageSecs, etc.)

🛡️ Anti-Detection Features

• Random delays between requests (3-8 seconds)
• Session pool with automatic retirement on blocks
• Browser fingerprint rotation
• Configurable proxy support (residential/datacenter)

📦 Dependencies

• Apify SDK — Apify runtime
• Crawlee — Web crawling framework
• Playwright — Browser automation
• JSDOM — DOM testing (dev)

🐳 Docker

# Build
docker build -t french-realestate-scraper .

# Run
docker run -e APIFY_TOKEN=your_token french-realestate-scraper

💰 Pricing

Pay-per-use, no monthly fees:

	Price
Actor start	$0.01
Per result	$0.001

💡 Example: A run returning 500 results costs $0.51 total ($0.01 start + 500 × $0.001).

📄 License

MIT License

---

Keywords: immobilier, France, scraping, real estate, apartment, house, property, Bienici, Trovit, French property, immobilier France, real estate scraper, property listings, Paris real estate, Lyon property, Marseille immobilier, French apartments, maison France, DPE, energy rating, property search France