Bien'ici Scraper

Scrape real-estate listings from bienici.com — one of France's largest property portals, backed by a consortium of major French banks and estate-agency networks, covering flats, houses, lofts, commercial premises and more, for sale or rent, nationwide.

What does this actor do?

Bien'ici Scraper searches bienici.com by transaction type, property type, location, price, surface area and rooms, returning structured listing data — no login, no API key required. You can also fetch specific listings by their ID or URL.

Output data

Each result is a JSON record with (where available):

• adId, title, description, transactionType (buy/rent), propertyType
• price, priceCurrency (EUR), pricePerSquareMeter
• surfaceArea, landSurfaceArea (houses), roomsQuantity, bedroomsQuantity, bathroomsQuantity, showerRoomsQuantity, toiletQuantity
• floor, floorQuantity, parkingPlacesQuantity, enclosedParkingQuantity, balconyQuantity, terracesQuantity, cellarsOrUndergroundsQuantity, yearOfConstruction
• city, postalCode, departmentCode, district, latitude, longitude
• energyClassification, greenhouseGazClassification (French DPE/GES ratings)
• heating, exposition
• newProperty, hasElevator, isFurnished, hasFirePlace, isDisabledPeopleFriendly, isBienIciExclusive, priceHasDecreased
• hasGarden, hasPool, hasCellar, hasCaretaker, hasAlarm, hasDoorCode, hasIntercom, isCalm, isRecent, isSubjectToRentControl, flatSharing, flatSharingNotAllowed
• isExclusiveSaleMandate, isInCondominium, isCondominiumInProcedure (co-ownership under a major-works/litigation procedure — a mandatory French legal disclosure), hasGeorisquesMention (mandatory natural/technological risk disclosure), hasOpticalFiber, isHighlighted, with360, with3dModel
• energyValue, greenhouseGazValue (numeric DPE/GES values in kWh/m²/year and kgCO2/m²/year, alongside the A–G letter classifications), energyPerformanceDiagnosticDate, minEnergyConsumption/maxEnergyConsumption, averageAnnualEnergyConsumption, epdFinalEnergyConsumption
• photoUrls (list), virtualTourUrls (list — 360° tours / video walkthroughs, where the agency published one)
• agencyName, accountType, reference
• publicationDate, modificationDate, availableDate (rent, move-in date)
• agencyFeePercentage, priceWithoutFees, feesChargedTo (purchaser/seller, sale listings), annualCondominiumFees, condominiumPartsQuantity (sale listings in a co-ownership)
• monthlyCharges, chargesMethod, rentWithoutCharges, rentExtra, agencyRentalFee, inventoryOfFixturesFees, safetyDeposit (rent)
• sourceUrl, recordType, scrapedAt

Fields that bienici.com doesn't provide for a given listing are simply omitted — you'll never see null or empty placeholders.

Input options

Field	Description
mode	search (filter-based search) or byIds (fetch specific listings)
transactionType	buy or rent
propertyTypes	Any combination of flat, house, loft, castle, townhouse, building, premises, parking
locationQuery	Free-text French place name — city, district, or region (e.g. Paris, Lyon, Bordeaux)
priceMin / priceMax	Price range in EUR (total price for sale, monthly rent for rentals)
areaMin / areaMax	Surface-area range in m²
roomsMin / bedroomsMin	Minimum rooms / bedrooms
newPropertyOnly	Only new-build properties
elevatorOnly	Only listings whose building has an elevator
furnishedOnly	Only furnished listings (mainly relevant for rentals)
gardenOnly	Only listings with a garden
poolOnly	Only listings with a swimming pool
parkingOnly	Only listings with at least one parking space
balconyOnly	Only listings with a balcony
terraceOnly	Only listings with a terrace
cellarOnly	Only listings with a cellar/storage room
fireplaceOnly	Only listings with a fireplace
separateToiletOnly	Only listings with a separate toilet (WC separated from the bathroom)
sortBy	relevance, priceAsc, priceDesc, dateDesc, surfaceDesc
keyword	Only keep listings whose title/description/city/district contains this text
adIds	(mode=byIds) Bien'ici ad IDs or full listing URLs
maxItems	Maximum number of listings to return

Example input

{
  "mode": "search",
  "transactionType": "buy",
  "propertyTypes": ["flat"],
  "locationQuery": "Paris",
  "priceMax": 500000,
  "maxItems": 30
}

Example: fetch specific listings

{
  "mode": "byIds",
  "adIds": ["https://www.bienici.com/annonce/immo-facile-60587888"]
}

Use cases

• Market research — track average sale/rent prices per city or arrondissement over time.
• Investment screening — filter by price, surface, and rooms to find undervalued properties.
• Lead generation — pull agency contact details for outreach.
• Energy-efficiency analysis — filter/analyze by DPE (energyClassification) and GES ratings.

FAQ

Does this require a bienici.com account or API key? No. The actor reads bienici.com's public listing search — the same data your browser loads when you search the site.

Can I search outside of France? No — bienici.com only covers properties within France.

Why is agencyFeePercentage / monthlyCharges sometimes missing? Those fields only apply to sale listings (agencyFeePercentage) or rental listings (monthlyCharges, safetyDeposit) respectively, and only when the agency has published them. The actor never invents data.

How many listings can I get per run? Up to maxItems (default 30, max 2000).

Why isn't there an agencyFeeUrl field? bienici.com's API does return a link to the agency's fee schedule PDF, but it's hosted on the agency's own third-party media CDN, which blocks direct (non-browser) requests even with correct headers — the actor omits this field rather than ship a link that returns an error for API consumers.