Figaro Immobilier Scraper

🏠 Figaro Immobilier Scraper

Want to pull property listings from Figaro Immobilier or analyze the French buy/rent market? This scraper makes it super easy!

Use structured filters (listing type, property type, location, rooms, price) — great for AI agents — or paste an input_url from your browser — great for people. When input_url is set, it overrides the filters. Either way, the scraper reads Figaro’s Nuxt search payload and returns price, surface, rooms, DPE, agency, and photos as CSV or JSON.

💡 Perfect for...

• Buyers & Renters: Monitor apartments and houses by city, room count, and budget.
• Agencies & Investors: Track competitor inventory and pricing across France.
• Market Research: Analyze supply, €/m² signals, and DPE distributions.
• Data Analysts: Export clean structured rows for dashboards and models.
• 🤖 AI Agents: Power bots and OpenClaw workflows with filter-based search (no brittle URL crafting).
• 📚 RAG Systems: Feed listing specs and descriptions into retrieval pipelines.
• 🔗 AI Workflows: Plug into LangChain, AutoGPT, CrewAI, and similar stacks.

✨ Why you'll love this scraper

• 🔗 Input URL or Filters: Paste a Figaro search URL (input_url) if you already filtered in the browser, or use structured filters for agent-friendly runs. input_url always wins when set.
• 🎯 Structured Filters: Sale/rent, property type, city, district, postal code, rooms, and price min/max.
• ⚡ Fast Nuxt Parse: Extracts listings from __NUXT_DATA__ — no headless browser required for SERP cards.
• 📊 Rich Cards: Price, area, rooms/bedrooms, DPE, geo, agency, images, and listing URL.
• 🔁 Pagination: Walks ?page=N until max_properties is reached.
• 🛡️ Resilient Fetch: Tries direct HTTP first, then rotates Apify residential FR proxies if Cloudflare blocks.

📦 What's inside the data?

For every listing you get:

• Core: id, url, reference, transaction, property_type, description
• Pricing & Size: price, price_label, area_m2, rooms, rooms_label, bedrooms
• Location: city, postal_code, department, department_code, latitude, longitude
• Energy: dpe_energy, dpe_energy_category, dpe_ges, dpe_ges_category
• Agency & Media: agency_name, agency_id, image_url, images
• Meta: is_exclusive, is_boosted, first_publication_date, updated_at, origin_site

🚀 Quick start

Option A — Input URL (great for people)

1. Open Figaro Immobilier, apply filters in the browser, copy the results URL.
2. Paste it into input_url.
3. Set max_properties and click Start.

Option B — Structured filters (great for AI agents)

1. Leave input_url empty.
2. Set listing_type, property_type, location (e.g. paris), optional district / postal_code / rooms / price bounds.
3. Set max_properties and click Start.

Export JSON, CSV, or Excel when done.

---

Tech details for developers 🧑‍💻

Input Example (filters)

{
  "listing_type": "vente",
  "property_type": "appartement",
  "location": "paris",
  "district": "11eme",
  "postal_code": "75011",
  "rooms": "2pieces",
  "price_max": 500000,
  "max_properties": 50
}

Input Example (URL override)

{
  "input_url": "https://immobilier.lefigaro.fr/annonces/immobilier-vente-appartement-paris.html?priceMin=200000&priceMax=400000",
  "max_properties": 50
}

Output Example

{
  "id": "103497843",
  "url": "https://immobilier.lefigaro.fr/annonces/annonce-103497843.html",
  "transaction": "vente",
  "property_type": "appartement",
  "price": 366000,
  "area_m2": 33.78,
  "rooms_label": "2 pièces",
  "bedrooms": 1,
  "city": "Paris 11ème (75)",
  "postal_code": "75011",
  "dpe_energy_category": "F",
  "agency_name": "Example Agency",
  "image_url": "https://..."
}

📋 Input reference (detailed)

Parameter	Type	Required	Default	Description
input_url	string	No	—	Optional override. Paste any Figaro Immobilier search URL. When set, overrides all filters below. Best for humans copying from the browser. Also accepts legacy search_url.
listing_type	string enum	No	vente	vente (sale) or location (rent).
property_type	string enum	No	appartement	appartement, maison, parking, terrain, divers, bien (all).
location	string	No	paris	City/place slug (paris, lyon, bordeaux, france).
district	string	No	—	Optional district (11eme, 16eme).
postal_code	string	No	—	Optional postal code (75011, 33000).
rooms	string enum	No	any	studio, 2pieces … 6pieces.
price_min / price_max	integer	No	—	Price bounds in euros (priceMin / priceMax query params).
max_properties	integer	No	50	How many listings to return (1–1000).
search_url	string	No	—	Legacy alias for input_url. Prefer input_url.

Notes

• input_url always wins over filters when provided.
• Filters build SEO paths like /annonces/immobilier-vente-appartement+2pieces-paris+11eme+75011.html.
• Each run returns at most max_properties listings.
• For complex browser-only criteria, paste the results URL into input_url.

🔧 Custom scrapers and agents

If you need a custom web scraper, or custom AI agents and workflows, contact me through tuik.ai. We help businesses cut costs and time by up to 10x.