Bien'ici API

Search Bien'ici's property listings across France and pull prices, energy ratings and agency details as clean JSON.

The API.SH Bien'ici API turns public Bien'ici pages into structured JSON. Search homes and other property for sale and rent in France by place, type, price, area, rooms, bedrooms, land, new or old build, energy class and features such as garden, terrace, lift or parking. Results carry price, price per m², price-drop flag, fees, energy and greenhouse ratings with yearly cost, coordinates and the agency; a listing adds the full description, condominium details, energy diagnostic details and the agency's contact. A places route turns a city or district name into the zone ids search uses.

Get a free API key Try it in the playground

3 endpoints
from $1 / 1,000 calls
1,000 free credits / month
failed calls free

Bien'ici property search

GET https://api.api.sh/bienici/v1/search

{ "success": true }

1 credit · $1 per 1,000 calls

What you can build with the Bien'ici API

Price per m² studies

Search a city or district by property type and size and collect prices and price per m² to compare neighborhoods across France.

/search /places

Energy rating (DPE) analysis

Filter by energy class and read each home's energy and greenhouse ratings with estimated yearly cost to compare running costs across homes.

/search /listing

Price drop and new listing alerts

Run a saved search sorted by date and flag listings marked with a price drop, then open them for full details.

/search /listing

Condominium due diligence

Open a listing for its condominium details (lots, yearly charges, proceedings) and fees before you visit.

/listing

Agency prospecting

Collect the agencies behind listings in an area with their name, phone, RCS number, address and website.

/listing /search

Bien'ici data you get

Field names from real responses. Numbers come parsed, URLs absolute, dates in ISO 8601.

Bien'ici API endpoints and prices

Every Bien'ici endpoint costs 1 credit per call: credits are $1 per 1,000 on a monthly plan, $2 pay-as-you-go. Pricing

Search and discovery1

Bien'ici property search

/bienici/v1/search

$1 · $2 PAYG

1 credit

Products, listings and places2

Bien'ici listing /bienici/v1/listing	$1 · $2 PAYG 1 credit
Bien'ici places /bienici/v1/places	$1 · $2 PAYG 1 credit

Call the Bien'ici API

Bien'ici property search: GET https://api.api.sh/bienici/v1/search

curl "https://api.api.sh/bienici/v1/search?location=Lyon" \
  -H "x-api-key: $APISH_KEY"

import os, requests

res = requests.get(
    "https://api.api.sh/bienici/v1/search",
    params={"location": "Lyon"},
    headers={"x-api-key": os.environ["APISH_KEY"]},
    timeout=120,
)
res.raise_for_status()
data = res.json()

const url = new URL("https://api.api.sh/bienici/v1/search");
url.searchParams.set("location", "Lyon");

const res = await fetch(url, { headers: { "x-api-key": process.env.APISH_KEY } });
if (!res.ok) throw new Error(`${res.status} ${await res.text()}`);
const data = await res.json();

# Google Sheets (API.SH add-on)
=APISH("/bienici/v1/search", "location", "Lyon")

# Zapier, Make, n8n (verified node): pick the API.SH app,
# choose "Bien'ici" and "Bien'ici property search".

# AI agents (Claude, ChatGPT, Cursor): add the
# API.SH MCP server https://api.sh/mcp

Create a free accountConfirm your email and get 1,000 free credits every month. No card needed.
Create an API keyOne key works for all 482 platforms.
Send the requestJSON back in one call. Add output=csv or output=ndjson for files.

Why API.SH for Bien'ici data

Public data only: no Bien'ici login, cookies or account needed
One key and one response shape for Bien'ici and 481 other platforms
Built and maintained by API.SH, not third-party publishers
Pay per call; errors on our side cost nothing
Live status for every endpoint

API.SH vs the official Bien'ici API

Bien'ici has no official public API for its listings; Google's AI overview and French real estate data vendors say the same. Its professional tools are for agencies publishing their own ads. API.SH returns public Bien'ici search and listing data as JSON.

Instead of a Python script or the Apify, piloterr and ScrapingBot Bien'ici scrapers that rank for this search, API.SH gives you place lookup, search and full listings under one key at a fixed price per call.

Bien'ici API questions

What Bien'ici data can I get?+

Place suggestions with zone ids, postal and INSEE codes (/bienici/v1/places), property search for sale and rent with Bien'ici's filters (/bienici/v1/search) and one listing with description, condominium and energy details and the agency's contact (/bienici/v1/listing).

How much does the Bien'ici API cost?+

Every Bien'ici endpoint costs 1 credit per call. On a monthly plan 1,000 credits cost $1 (Starter is $50/month for 50,000 credits). Pay-as-you-go is $2 per 1,000 credits, with top-ups from $15 that never expire.

Is there a free trial?+

Yes. Every account gets 1,000 free credits every month. That is 1,000 calls to /bienici/v1/listing at 1 credit each.

Is there an official Bien'ici API?+

No public one for listing data. Bien'ici's pro services are for agencies publishing ads. API.SH reads the public site and returns listings as JSON.

Do I need a Bien'ici account or login?+

No. API.SH reads public Bien'ici pages only. No endpoint uses a login, cookies or anyone's account. A private seller's name and phone are left out.

Does it return the DPE energy rating?+

Yes. Search results include energy and greenhouse gas ratings with an estimated yearly energy cost, you can filter by energy_class, and a listing adds the diagnostic date, method, consumption and heating where the ad gives them.

How do I search a specific city or district?+

Pass a place name as location, or look it up first with /bienici/v1/places and pass its zone id as zone_id for an exact match.

How do I get started?+

1. Sign up at api.sh. 2. Copy your API key. 3. Call /bienici/v1/search with a city such as location=Lyon. Every parameter and request examples are in the docs at https://api.sh/docs. You can also use the JS or Python SDK, Google Sheets, Zapier, Make, n8n or the MCP server at https://api.sh/mcp.