🏠 French-Property.com Scraper

Want to pull property listings from French-Property.com or explore the French buy/rent market for expats and buyers? This scraper makes it easy.

Use structured filters — the same choices as on the website (popular areas, regions, departments, property type, bedrooms, prices, features) — or paste an input_url from your browser. When input_url is set, it overrides the filters. Either way, you get price, size, bedrooms, location, agency, DPE, and photos as CSV or JSON.

💡 Perfect for...

• Buyers & Renters: Monitor houses and apartments by region, department, and budget.
• Agencies & Investors: Track inventory and pricing across popular French areas.
• Market Research: Compare supply in Dordogne, Brittany, Paris, the Alps, and more.
• Data Analysts: Export clean structured rows for dashboards and models.
• 🤖 AI Agents: Power bots and 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 French-Property.com 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.
• 🎯 Website-matched filters: Popular locations, regions, departments, property type, bedroom min/max, price ladder, land size, swimming pool / outbuildings, and sort order.
• 📊 Rich Listings: Price, habitable & land size, bedrooms/bathrooms, region/department/city, agency, DPE, 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, title, description
• Pricing & Size: price, price_label, area_m2, land_m2, bedrooms, bathrooms
• Location: city, postal_code, department, region, location_full
• Energy: dpe_energy, dpe_energy_category, dpe_ges, dpe_ges_category
• Agency & Media: agency_name, image_url, images

🚀 Quick start

Option A — Input URL

1. Open French-Property.com, 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. Choose listing_type, property_type, and a location (popular_location, region, and/or department). Optionally add a city.
3. Set bedrooms, price, features if you want, then max_properties and click Start.

Export JSON, CSV, or Excel when done.

---

Input examples

Filters

{
  "listing_type": "vente",
  "property_type": "house",
  "department": "dordogne",
  "minimum_bedrooms": "3",
  "price_min": 100000,
  "price_max": 400000,
  "max_properties": 50
}

URL override

{
  "input_url": "https://www.french-property.com/properties-for-sale?departments=dordogne&property_types_all=house",
  "max_properties": 50
}

Output example

{
  "id": "1687-192",
  "url": "https://www.french-property.com/sale-property/1687-192",
  "transaction": "vente",
  "price": 249500,
  "area_m2": 123,
  "land_m2": 450,
  "bedrooms": 4,
  "bathrooms": 2,
  "city": "Bouteilles-Saint-Sébastien",
  "department": "Dordogne (24)",
  "region": "Aquitaine",
  "dpe_energy_category": "E",
  "agency_name": "Wright French Properties",
  "image_url": "https://cdn4.french-property.com/..."
}

📋 Input reference

Parameter	Type	Required	Default	Description
input_url	string	No	—	Optional override. Paste any French-Property.com search URL. When set, overrides all filters below.
listing_type	string enum	No	vente	vente (for sale) or location (for rent).
property_type	string enum	No	house	All, house, apartment, business, land.
popular_location	string enum	No	Any	Popular area from the website (34 options).
region	string enum	No	Any	French region (29 options).
department	string enum	No	dordogne	French department (96 options).
city	string	No	—	Optional city/town (e.g. Bergerac, Nice).
postal_code	string	No	—	Optional postal code.
minimum_bedrooms / maximum_bedrooms	string enum	No	Any / Unlimited	Bedroom bounds (same ladder as the site).
price_min / price_max	string enum	No	No min/max	Price ladder from €50,000 to €5,000,000.
minimum_land_size / maximum_land_size	integer	No	—	Land size bounds.
land_size_unit	string enum	No	m²	m², acres, or hectares.
swimming_pool / outbuildings	boolean	No	false	Feature filters.
sort_by	string enum	No	Default	Lowest/highest price, most recent, or most land.
max_properties	integer	No	50	How many listings to return (1–1000).

Notes

• input_url always wins over filters when provided.
• Location selects match the website lists; use city when you need a specific town.
• Each run returns at most max_properties listings.