Bien'ici Scraper — French Real Estate & Rentals

Scrape French real estate listings from Bien'ici — the map-based property portal used by millions across France. Apartments, houses, and rentals in every French city, with price, price/m², surface, rooms, DPE energy rating, photos, GPS, and agency contact.

Why use this scraper

• JSON API, not HTML scraping — Bien'ici is a map-based SPA; this actor calls its internal JSON endpoints directly, so the data is structured and reliable
• No anti-bot, no proxy needed — runs fast from any IP
• Whole country — every French city, both sales (achat) and rentals (location)
• Full details — photo gallery, DPE/GHG energy ratings, rooms, agency name, phone, and email-available flag
• GPS coordinates — approximate lat/lng for every listing (blurred ~50–100 m by the site for privacy)

Supported inputs

• Start URL — paste a Bien'ici search URL (e.g. https://www.bienici.com/recherche/achat/paris-75000/appartement) or a single listing URL (https://www.bienici.com/annonce/ag754691-538488038)
• Filters — transaction type (buy/rent), city slugs, property types, price/surface/rooms bands, new builds only, sort order

Input configuration

Field	Type	Description
startUrl	string	Bien'ici search or listing URL
filterType	select	buy (achat) / rent (location)
locationNames	string[]	City slugs, e.g. ["paris-75000"], ["lyon-69000"]. Bare names ("paris") also work. Empty = all France
propertyTypes	string[]	API codes: flat, house, parking, terrain, building, castle, loft, office, premises, shop, townhouse, annexe, others, programme, residence
minPrice / maxPrice	integer	Price band in euros (sale price, or monthly rent for rentals)
minSurface / maxSurface	integer	Surface band in m²
minRooms / maxRooms	integer	Room count band
newProperty	boolean	New builds only (programme / VEFA)
includeOffMarket	boolean	Include sold/rented listings (default: on-market only)
sortBy	string	publicationDate (default) or relevance
sortOrder	string	desc (default) / asc
fetchFullDetails	boolean	Fetch the detail page for each listing (default: false)
maxItems	integer	Max listings to save (default: 100, free plan: 5)
proxy	object	Optional proxy (usually unnecessary)

Output fields

id, url, title, adType, adTypeFR, propertyType, reference, price, priceWithoutFees, pricePerSquareMeter, surfaceArea, roomsQuantity, city, postalCode, departmentCode, districtName, latitude, longitude, energyClassification, greenhouseGazClassification, hasPool, isInCondominium, newProperty, isExclusiveSaleMandate, feesChargedTo, photo, photos, description, publicationDate, modificationDate, priceHasDecreased, isBienIciExclusive, adCreatedByPro, agencyName, contactName, agencyPhone, hasEmail, source

priceWithoutFees, roomsQuantity, energyClassification, greenhouseGazClassification, photos, description, and the agency contact fields are only populated when fetchFullDetails is on.

Use cases

• Market research — track sale prices and rents across French cities and arrondissements
• Lead generation — extract agency names and phone numbers for outreach
• Investment analysis — compare price/m², DPE energy ratings, and locations
• Relocation — find rentals by city, surface, and room count
• New-build tracking — monitor VEFA programmes with the newProperty filter
• Data enrichment — feed property data into CRM or analytics pipelines

How it works

1. The actor calls Bien'ici's internal JSON API (/realEstateAds.json) with a filters JSON payload — the same call the website's map makes
2. Search results return listing cards with price, location, surface, and a thumbnail
3. When fetchFullDetails is on, each listing is enriched via the detail API (/realEstateAd.json) with the full description, photo gallery, DPE/GHG ratings, rooms, and agency contact
4. Results are pushed to the dataset as structured JSON, deduplicated by listing id

Pricing

This actor uses pay-per-event pricing. You are charged per listing saved to the dataset. The free tier lets you try it with 5 items per run.

⚠️ Disclaimer

This scraper is for educational and research purposes only. Bien'ici is a trademark of its respective owner. This actor is not affiliated with or endorsed by Bien'ici. Users are responsible for complying with Bien'ici's terms of service and applicable data protection laws (including the GDPR for any processing of personal data such as agency contact details).

SEO Keywords

bienici scraper, bien'ici scraper, french real estate scraper, france property scraper, paris apartments, lyon real estate, marseille property, french rentals, appartement achat, location appartement, DPE energy rating, immobilier france, bienici api, bienici data extraction