Bien'ici API & Scraper
Bien'ici API returns live Bien'ici data as clean JSON for bien'ici The primary endpoint, search, returns listings records including ad id, reference, title, status and price.
2 actionsLive JSON1,000 free credits$0.67–$1.50 / 1,000 creditsMCP-ready
🤖 Using an AI assistant? Copy this link into ChatGPT / Claude / Cursor — it reads every endpoint and parameter instantly and tells you if this API fits your use case.
Developers reach for it when they need to compare listings, property details, prices, locations and market inventory without maintaining one-off scraping code or separate API contracts. If you were about to build or fix a Bien'ici scraper, this API is the maintained alternative — it returns the same data as clean JSON, with the proxies, rotation and anti-bot handling already solved. This page covers the live example, request shape, response shape and available actions: search, listing. Every request uses the same ReefAPI envelope, one API key and one shared credit pool, so it fits alongside the rest of your data stack.
Live example
Real request and response JSON
Captured from the indexed primary action, search, on .
Captured request
{
"method": "POST",
"url": "https://api.reefapi.com/bienici/v1/search",
"headers": {
"x-api-key": "$REEF_KEY",
"content-type": "application/json"
},
"body": {
"transaction": "sale",
"city": "Lyon"
}
}Captured response
{
"ok": true,
"meta": {
"api": "bienici",
"endpoint": "search",
"mode": "live",
"latency_ms": 812.8,
"record_count": 24,
"bytes": 286553,
"cache_hit": false,
"stop_reason": "limit_reached",
"charged_credits": 1,
"version": "0.1.0",
"request_id": "020c87ef250e42f8",
"queue_ms": 2.4,
"fetched_at": "2026-10-29T21:34:45.505Z"
},
"data": {
"listings": [
{
"ad_id": "netty-pietrapolis-house-72158",
"reference": "VM72158-PIETRAPOLIS",
"title": "Maison de charme à Montchat",
"url": "https://www.bienici.com/annonce/netty-pietrapolis-house-72158",
"status": "on_market",
"price": 980000,
"currency": "EUR",
"price_is_from": false,
"price_max": null,
"price_not_published": false,
"price_has_decreased": false,
"published_at": "2026-09-18T16:22:03.796Z",
"updated_at": "2026-10-29T18:04:59.100Z",
"location": {
"city": "Lyon 3e",
"zipcode": "69003",
"district": "Monchat",
"department_id": "69",
"department": null,
"region_id": null,
"region": null,
"country": "FR",
"latitude": 45.743045,
"longitude": 4.892752,
"coordinates_precision": "exact",
"coordinates_radius_m": null,
"coordinates_withheld": false
},
"seller": {
"type": "pro",
"account_type": "agency",
"name": "PIETRAPOLIS LYON 7",
"name_withheld": false,
"siren": null,
"has_phone": null,
"phone": null
},
"thumbnail": "https://file.bienici.com/photo/netty-pietrapolis-house-72158_img.netty.immo_productw_pietrapolis_5_VM72158_17896585554_VM72158_26_original.jpg",
"image_count": 16,
"images": [
"https://file.bienici.com/photo/netty-pietrapolis-house-72158_img.netty.immo_productw_pietrapolis_5_VM72158_17896585554_VM72158_26_original.jpg",
"https://file.bienici.com/photo/netty-pietrapolis-house-72158_img.netty.immo_productw_pietrapolis_5_VM72158_17907176734_VM72158_28_original.jpg",
"https://file.bienici.com/photo/netty-pietrapolis-house-72158_img.netty.immo_productw_pietrapolis_5_VM72158_17896490984_VM72158_3_original.jpg"
],
"description": "Une maison de charme avec une rénovation soignée\nVous rêvez d'une maison avec une belle adresse, spacieuse, et lumineuse?\nDans un quartier résidentiel et recherché, à quelques minutes à pied du château de Montchat, des commerces, des écoles et des transports, venez découvrir cette maison entièrement rénovée de 180 m2 de surface totale, dont 130 m2 carrez.\nElle se compose au niveau principal d'une belle pièce de vie lumineuse réunissant salon et salle à manger, ainsi que d'une cuisine indépendante aménagée avec verrière, d'une salle de bains et de WC.\nÀ l'étage, trois chambres, dont une suite p",
"property": {
"property_type": "house",
"property_subtype": null,
"transaction": "sale",
"is_new_build": false,
"is_prestige": false,
"surface_m2": 180,
"surface_max_m2": null,
"land_surface_m2": 212,
"rooms": 6,
"bedrooms": 5,
"bathrooms": 2,
"shower_rooms": null,
"toilets": 2,
"floor": null,
"floors_in_building": 2,
"elevator": null,
"balcony": null,
"terrace": null,
"garden": true,
"pool": false,
"cellar": true,
"parking_spaces": null,
"features": [
"[trimmed-depth]",
"[trimmed-depth]",
"[trimmed-depth]"
],
"energy_class": "C",
"energy_class_status": "rated",
"ghg_class": "C",
"ghg_class_status": "rated",
"energy_consumption_kwh_m2": 179,
"ghg_emissions_kg_m2": 7,
"annual_energy_cost_min": 2080,
"annual_energy_cost_max": 2870,
"energy_diagnostic_date": null,
"heating_type": null,
"building_year": 1935,
"orientation": "Nord Sud",
"furnished": null,
"available_from": null,
"price_per_m2": 5444.44,
"rent_excluding_charges": null,
"monthly_charges": null,
"charges_method": null,
"charges_included": null,
"security_deposit": null,
"rental_fees": null,
"inventory_fees": null,
"agency_fees_paid_by": "seller",
"agency_fees_pct": null,
"price_excluding_fees": 980000,
"annual_condo_charges": null,
"condo_lots": null,
"condo_in_procedure": false,
"rent_control": null,
"fibre": "deploye",
"virtual_tour_url": "https://my.matterport.com/show/?m=y7YewgNPkMZ",
"is_exclusive_mandate": true
}
},
{
"ad_id": "ag753296-556460375",
"reference": "f9cb2b",
"title": "Lyon 2e – Cordeliers / Quai Jean Moulin | Bel appartement haussmannien de 113 m² au calme absolu",
"url": "https://www.bienici.com/annonce/ag753296-556460375",
"status": "on_market",
"price": 595000,
"currency": "EUR",
"price_is_from": false,
"price_max": null,
"price_not_published": false,
"price_has_decreased": false,
"published_at": "2026-10-28T08:14:16.507Z",
"updated_at": "2026-10-28T08:14:16.507Z",
"location": {
"city": "Lyon 2e",
"zipcode": "69002",
"district": "Cordeliers Bellecour",
"department_id": "69",
"department": null,
"region_id": null,
"region": null,
"country": "FR",
"latitude": 45.764307,
"longitude": 4.837987,
"coordinates_precision": "exact",
"coordinates_radius_m": null,
"coordinates_withheld": false
},
"seller": {
"type": "pro",
"account_type": "mandatary",
"name": null,
"name_withheld": false,
"siren": null,
"has_phone": null,
"phone": null
},
"thumbnail": "https://file.bienici.com/photo/ag753296-556460375_photos.ubiflow.net_753296_556460375_photos_1.jpg_INSOON_EB_5512801818_20261028081747",
"image_count": 18,
"images": [
"https://file.bienici.com/photo/ag753296-556460375_photos.ubiflow.net_753296_556460375_photos_1.jpg_INSOON_EB_5512801818_20261028081747",
"https://file.bienici.com/photo/ag753296-556460375_photos.ubiflow.net_753296_556460375_photos_2.jpg_INSOON_EB_5512801818_20261028081747",
"https://file.bienici.com/photo/ag753296-556460375_photos.ubiflow.net_753296_556460375_photos_3.jpg_INSOON_EB_5512801818_20261028081747"
],
"description": "Au cœur de la Presqu'île, à deux pas de la place des Cordeliers et des berges du Rhône, découvrez ce grand appartement de 113 m² carrez, situé au 4e étage sur 5 avec ascenseur au sein d'un superbe immeuble haussmannien de standing, parfaitement entretenu.\n\nActuellement configuré en bureaux professionnels, ce bien particulièrement calme dispose de tous les atouts pour être réaménagé en une magnifique résidence familiale de 2 ou 3 chambres.\n\nLe bien et son potentiel\nSurface : 113 m² habitables.\n\nAgencement actuel : trois grands bureaux indépendants, un espace reprographie / stockage, une cuisine",
"property": {
"property_type": "apartment",
"property_subtype": null,
"transaction": "sale",
"is_new_build": false,
"is_prestige": false,
"surface_m2": 113,
"surface_max_m2": null,
"land_surface_m2": null,
"rooms": 4,
"bedrooms": 2,
"bathrooms": 1,
"shower_rooms": null,
"toilets": 1,
"floor": 4,
"floors_in_building": 5,
"elevator": true,
"balcony": false,
"terrace": false,
"garden": null,
"pool": false,
"cellar": false,
"parking_spaces": null,
"features": [
"[trimmed-depth]"
],
"energy_class": null,
"energy_class_status": "not_subject",
"ghg_class": null,
"ghg_class_status": "not_subject",
"energy_consumption_kwh_m2": null,
"ghg_emissions_kg_m2": null,
"annual_energy_cost_min": null,
"annual_energy_cost_max": null,
"energy_diagnostic_date": null,
"heating_type": "individuel",
"building_year": 1910,
"orientation": "ouest",
"furnished": null,
"available_from": "2026-09-23T00:00:00.000Z",
"price_per_m2": 5265.49,
"rent_excluding_charges": null,
"monthly_charges": null,
"charges_method": null,
"charges_included": null,
"security_deposit": null,
"rental_fees": null,
"inventory_fees": null,
"agency_fees_paid_by": "seller",
"agency_fees_pct": null,
"price_excluding_fees": 580500,
"annual_condo_charges": 2184,
"condo_lots": null,
"condo_in_procedure": null,
"rent_control": null,
"fibre": "deploye",
"virtual_tour_url": "https://tour.giraffe360.com/23845f595d614e819abd3f292e52bd9f/?nocookie",
"is_exclusive_mandate": true
}
},
{
"ad_id": "ag753296-551309441",
"reference": "1e8812",
"title": "Appartement 174 m2 , 4 chambres , garage , charme de l ancien, SAXE",
"url": "https://www.bienici.com/annonce/ag753296-551309441",
"status": "on_market",
"price": 980000,
"currency": "EUR",
"price_is_from": false,
"price_max": null,
"price_not_published": false,
"price_has_decreased": false,
"published_at": "2026-09-25T08:01:38.942Z",
"updated_at": "2026-10-28T04:01:31.413Z",
"location": {
"city": "Lyon 3e",
"zipcode": "69003",
"district": "Voltaire - Part Dieu",
"department_id": "69",
"department": null,
"region_id": null,
"region": null,
"country": "FR",
"latitude": 45.763529,
"longitude": 4.84764,
"coordinates_precision": "exact",
"coordinates_radius_m": null,
"coordinates_withheld": false
},
"seller": {
"type": "pro",
"account_type": "mandatary",
"name": null,
"name_withheld": false,
"siren": null,
"has_phone": null,
"phone": null
},
"thumbnail": "https://file.bienici.com/photo/ag753296-551309441_photos.ubiflow.net_753296_551309441_photos_1.jpg_INSOON_EB_5512801818_20260925085736",
"image_count": 17,
"images": [
"https://file.bienici.com/photo/ag753296-551309441_photos.ubiflow.net_753296_551309441_photos_1.jpg_INSOON_EB_5512801818_20260925085736",
"https://file.bienici.com/photo/ag753296-551309441_photos.ubiflow.net_753296_551309441_photos_2.jpg_INSOON_EB_5512801818_20260925085736",
"https://file.bienici.com/photo/ag753296-551309441_photos.ubiflow.net_753296_551309441_photos_3.jpg_INSOON_EB_5512801818_20260925101535"
],
"description": "Exclusivité :\n\nEntre la Presqu'île, les Halles Paul Bocuse et la Part-Dieu, cet appartement traversant de 174 m² (loi Carrez) se situe au deuxième étage d'un immeuble bourgeois de 1914. Un lieu d'exception aux prestations d'époque préservées : volumes majeurs, hauteur sous plafond, parquets d'origine, moulures et cheminées d'apparat.\n\nGrâce à sa double destination, ce bien s'adapte à vos projets : une résidence familiale d'exception ou le siège raffiné d'une profession libérale.\n\nL'Appartement\n— Espaces de réception : un vaste séjour baigné de lumière et une salle à manger au charme intemporel",
"property": {
"property_type": "apartment",
"property_subtype": null,
"transaction": "sale",
"is_new_build": false,
"is_prestige": false,
"surface_m2": 174,
"surface_max_m2": null,
"land_surface_m2": null,
"rooms": 7,
"bedrooms": 4,
"bathrooms": 2,
"shower_rooms": null,
"toilets": 2,
"floor": 2,
"floors_in_building": 3,
"elevator": true,
"balcony": true,
"terrace": false,
"garden": null,
"pool": false,
"cellar": true,
"parking_spaces": 4,
"features": [
"[trimmed-depth]",
"[trimmed-depth]",
"[trimmed-depth]"
],
"energy_class": "C",
"energy_class_status": "rated",
"ghg_class": "C",
"ghg_class_status": "rated",
"energy_consumption_kwh_m2": 1,
"ghg_emissions_kg_m2": null,
"annual_energy_cost_min": null,
"annual_energy_cost_max": null,
"energy_diagnostic_date": null,
"heating_type": "individuel",
"building_year": 1914,
"orientation": "nord",
"furnished": null,
"available_from": "2026-07-27T00:00:00.000Z",
"price_per_m2": 5632.18,
"rent_excluding_charges": null,
"monthly_charges": null,
"charges_method": null,
"charges_included": null,
"security_deposit": null,
"rental_fees": null,
"inventory_fees": null,
"agency_fees_paid_by": "seller",
"agency_fees_pct": null,
"price_excluding_fees": 955500,
"annual_condo_charges": 2712,
"condo_lots": 5,
"condo_in_procedure": null,
"rent_control": null,
"fibre": "deploye",
"virtual_tour_url": "https://tour.giraffe360.com/beb679defccd47e59bdeb4a9cef161e5/?nocookie",
"is_exclusive_mandate": true
}
}
],
"count": 24,
"total": 3797,
"page": 1,
"limit": 24,
"has_more": true,
"next_page_token": "[redacted-secret]",
"sort_applied": "relevance",
"location_applied": {
"zone_ids": [
"-120965"
],
"name": "Lyon",
"type": "city",
"postal_codes": [
"69000"
]
},
"text_match": null
}
}Actions
What the Bien'ici API does
| Action | Description | Concrete use case | Key params |
|---|---|---|---|
| search | Search Bien'ici (bienici.com) property listings for sale or rent in France: price (from-price on new-build programmes), price per m², surface, land, rooms, bedrooms, floor, energy and GHG class, heating, building year, charges and deposit, agency fees, town, postcode, district and map position, agency, photos and description. Filter by transaction, property type, town or postcode, price, surface, rooms, bedrooms, new build and keywords; sort by relevance, newest, price or surface; paginated. | Real-estate investors call search to search Bien'ici (bienici.com) property listings for sale or rent in France. | transaction, query, property_type, city, zipcode, ... |
| listing | One Bien'ici listing by id or URL: price, price per m², surface, land, rooms, bedrooms, bathrooms, floor, elevator, energy (DPE) and GHG class with kWh and CO2 figures and the annual energy bill range, heating, building year, charges, deposit, fees, rent control, transaction and property type, town, postcode, district, map position and its precision, photos, description, publication date and the agency (name, RCS). | Brokerage tools call listing to get one Bien'ici listing by id or URL. | ad_id, include_pii, max_rotations |
Code samples
Call search from your stack
curl -X POST https://api.reefapi.com/bienici/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"transaction":"sale","city":"Lyon"}'import requests
r = requests.post(
"https://api.reefapi.com/bienici/v1/search",
headers={"x-api-key": REEF_KEY},
json={
"transaction": "sale",
"city": "Lyon"
},
)
print(r.json()["data"])const res = await fetch("https://api.reefapi.com/bienici/v1/search", {
method: "POST",
headers: {
"x-api-key": process.env.REEF_KEY,
"content-type": "application/json",
},
body: JSON.stringify({
"transaction": "sale",
"city": "Lyon"
}),
});
const { ok, data, meta, error } = await res.json();MCP one-liner
Ask your MCP-connected assistant: call reefapi.bienici.search with {"transaction":"sale","city":"Lyon"}.Use cases
Who uses this API and why
- Real-estate investors use Bien'ici to search Bien'ici (bienici.com) property listings for sale or rent in France.
- Brokerage tools use Bien'ici to get one Bien'ici listing by id or URL.
- Property dashboards use Bien'ici to compare listings, property details, prices, locations and market inventory, all from one ReefAPI key and credit pool.
FAQ
Questions developers ask before integrating
What is the Bien'ici API?
Bien'ici API is a ReefAPI endpoint group for bien'ici It returns live JSON through POST requests under /bienici/v1.
Is the Bien'ici API free to try?
Yes. ReefAPI starts with 1,000 free credits, no card required. Bien'ici calls use the same shared credit balance as every other ReefAPI engine.
Do I need a Bien'ici login or account?
No login to Bien'ici is needed for the API response. You call ReefAPI with your x-api-key header, and the playground can run live examples before you create a production key.
How fresh is the Bien'ici data?
The page example is captured from a live search call, and production requests fetch live data through ReefAPI rather than a static sample.
How many credits does the Bien'ici API use?
Bien'ici actions currently cost 1 credit per successful call. Failed or blocked calls are free. All APIs draw from one credit pool.
Can I call Bien'ici from an AI assistant or MCP client?
Yes. Connect ReefAPI once through MCP and your assistant can call bienici actions with the same key, credit pool and JSON envelope used by normal REST requests.
Is the Bien'ici API a Bien'ici scraper?
It is the managed alternative to a DIY Bien'ici scraper. Instead of building and maintaining your own scraper — proxies, headless browsers, captcha and constant breakage — you call one ReefAPI endpoint and get the same bien'ici back as clean JSON.
Why does my Bien'ici scraper keep getting blocked?
Most Bien'ici scrapers break on anti-bot defenses, rate limits and IP bans that need rotating residential proxies and browser fingerprinting to clear. ReefAPI handles all of that for you — no proxies, no captchas, no maintenance — and returns live JSON. Blocked calls are free.