🏠 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) — structured filters work better for AI agents — or paste an input_url from your browser. When input_url is set, it overrides the filters. Either way, you get 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 (better for AI agents). input_url always wins when set.
• 🎯 Structured Filters: Sale/rent, property type, city, district, postal code, rooms, and price min/max.
• 📊 Rich Listings: Price, area, rooms/bedrooms, DPE, location, agency, images, and listing URL.
• 🔁 Pagination: Collects listings across result pages until max_properties is reached.

📦 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

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 (better 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",
  "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.
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 name (e.g. paris, lyon, toulouse, france).
district	string	No	—	Optional district (e.g. 11eme, 16eme).
postal_code	string	No	—	Postal code — often helpful (31000 Toulouse, 33000 Bordeaux). Auto-filled for common cities when empty.
rooms	string enum	No	any	studio, 2pieces … 6pieces (applied for apartments; ignored for maisons).
price_min / price_max	integer	No	—	Price bounds in euros.
max_properties	integer	No	50	How many listings to return (1–500).

Notes

• input_url always wins over filters when provided.
• Each run returns at most max_properties listings.
• For complex browser-only criteria, paste the results URL into input_url.