French Real Estate Aggregator — Bien'ici, Notaires, Century 21, iad, Orpi

One search, five French real-estate sources, one clean schema. The Actor queries Bien'ici (national portal, professional and private listings), Immobilier des notaires (notary offices, including interactive auctions and off-market sales), Century 21, iad and Orpi (agency networks) for the same place and filters, then returns normalised listings: price, price per m², surface, land, rooms, bedrooms, property type, postcode, distance from the searched place, energy class, seller type, exclusivity, photos, publication date. The same property advertised on several boards is merged (alsoOn, alsoOnUrls).

Search by city with a radius ("Marseille", "Aix-en-Provence"), arrondissement ("Marseille 8e", "Paris 11e"), postcode ("13008"), département ("13", "Gironde") or region ("Île-de-France"), sale or rental, with price, surface and rooms filters. Detail mode opens each listing for the full description, DPE, floor, year built, charges, property tax, features, agency and phone where published.

Who uses it

• Agencies and mandataries ("pige"): what comes on the market in a sector, across networks, every morning.
• Investors and buyers' agents: price per m² by postcode, price drops, exclusivities, notary sales below market.
• Proptech, valuation and data teams: a single normalised French feed instead of five scrapers.
• Local media, economic development, researchers: market depth and price levels per commune.
• AI agents: "3-room flats under 300 000 € within 5 km of Aix-en-Provence, sorted by distance, with DPE".

Output example

{
  "source": "century21",
  "id": "11570864838",
  "url": "https://www.century21.fr/trouver_logement/detail/11570864838/",
  "title": "Appartement F3 à vendre",
  "transaction": "buy",
  "propertyType": "flat",
  "price": 159000,
  "pricePerSquareMeter": 4035.53,
  "surface": 39.4,
  "rooms": 3,
  "city": "MARSEILLE",
  "postcode": "13010",
  "department": "13",
  "energyClass": "C",
  "greenhouseGasClass": "C",
  "sellerType": "professional",
  "sellerName": "CENTURY 21 Longchamp Immobilier",
  "sellerPhone": "04 91 86 44 24",
  "reference": "1064",
  "isExclusive": true,
  "floor": 6,
  "charges": 213,
  "propertyTax": "2526",
  "hasElevator": true,
  "description": "13010 / CAPELETTE En plein cœur du 10e arrondissement…",
  "descriptionIsFull": true,
  "alsoOn": ["bienici"],
  "alsoOnUrls": ["https://www.bienici.com/annonce/ag130-123456"],
  "scrapedAt": "2026-09-17T18:40:00.000Z"
}

Bien'ici rows add GPS coordinates, DPE and district; notary rows add the office phone, fees and an isAuction flag; iad rows add the advisor; Orpi rows add the price-per-m² as published and the neighbourhood.

Input

Field	Type	Description
location	string	City, arrondissement, postcode, département or region (required).
radiusKm	integer	Around a city (default 10).
transaction	buy / rent
propertyTypes	string[]	flat, house, land, parking, building, commercial.
minPrice, maxPrice	integer	EUR (monthly rent for rentals).
minArea, maxArea, minRooms	integer
sources	string[]	bienici, notaires, century21, iad, orpi (default all).
maxItemsPerSource	integer	Default 100.
maxItems	integer	Default 300, 0 = unlimited.
dedupe	boolean	Merge the same property across boards (default true).
fetchDetails	boolean	Full listings (Bien'ici, Century 21, iad).

Examples:

{ "location": "Marseille 8e", "transaction": "buy", "propertyTypes": ["flat"], "maxPrice": 400000, "minRooms": 3, "fetchDetails": true }

{ "location": "Aix-en-Provence", "radiusKm": 15, "propertyTypes": ["house"], "minArea": 100, "sources": ["bienici", "notaires", "iad"] }

{ "location": "Gironde", "transaction": "rent", "propertyTypes": ["flat"], "maxItemsPerSource": 300, "maxItems": 0 }

Pricing

Pay per event: one listing event per exported row, one listing detail event per row when fetchDetails is on, plus a small Actor start fee. The boards are read through their public pages and JSON endpoints: no browser, no residential proxies, a city search finishes in under a minute.

Notes

• Places are resolved with the French government geo API; the radius uses commune centroids for boards without coordinates and exact GPS for Bien'ici.
• Century 21 is read by postcode pages, iad by département pages, Orpi by city and arrondissement pages (about 30 listings per page), the notaries through their public listings API.
• Private sellers are never named or identified; professional sellers (agencies, networks, notary offices) are named as published. No personal contact data is collected.
• Listings belong to the boards and their advertisers; use the output for research, monitoring and prospecting in compliance with each site's terms.