Bien'ici API

Bien'ici sales and rentals with map location and energy data, as JSON

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.

no credit card1,000 free credits · instant API key · pay by card or crypto
Missing a Bien'ici endpoint, or need a source we don't have yet?Contact us real people · same-day reply.
B
/bienici/v1

2 active endpoints. Every call is 1 credit.

  • POST/bienici/v1/search
  • POST/bienici/v1/listing

What Bien'ici endpoints does ReefAPI ship?

2 live read endpoints. Read-only data API: no writes, no account actions, no dashboard access on the target site.

2 endpoints

search

1 cr

Search Bien'ici (bienici.com) property listings for sale or rent in France.

required
transaction
optional
query, property_type, city, zipcode, price_min, price_max, surface_min, surface_max, rooms_min, rooms_max, bedrooms_min, new_build, sort, page, limit, page_token, include_pii, max_rotations

listing

1 cr

One Bien'ici listing by id or URL.

required
ad_id
optional
include_pii, max_rotations

Every parameter, every allowed value →

Bien'ici API

2 of 2 endpoints, ready to run

View docs ↗

Bien'ici listings in a town with price, coordinates, energy class and charges

1 credit1 required · 3 optional
POST/bienici/v1/search
idle
// Press "Try it" and this pane shows exactly what the
// live site returned this second — including an empty
// result, if that is the truth. No key, no account.

How the Bien'ici API works

Bien'ici is a normal ReefAPI surface — the same four rules that hold for every other engine on the key.

01
Authenticate
x-api-key header

No OAuth app, no request signing, no per-site account. One key covers all 587 engines.

02
Call
POST /bienici/v1/…

Every route is a POST with a JSON body. Parameters are validated against the published schema before anything is charged.

03
Pay
1 credit per call

Credits, not seats. Failed and blocked calls are never charged, and cache hits cost nothing.

04
Read
{ ok, data, meta, error }

One envelope everywhere. meta carries latency_ms, record_count and the endpoint that answered.

From a Bien'ici search to a map of listings with their running costs

Search a town with the site's own filters, narrow by words in the ad, then open the listings you want in full.

01search?city=Lyon&transaction=sale&surface_min=100
GET/bienici/v1/search?city=Lyon&transaction=sale&surface_min=100

Up to 100 listings a page, each with price, price per m², surface, rooms, energy and GHG class, charges, fees, coordinates and photos.

02search?city=Bordeaux&transaction=sale&query=piscine
GET/bienici/v1/search?city=Bordeaux&transaction=sale&query=piscine

Only listings whose title or description contains the words; the next page continues from next_page_token.

03listing?ad_id=<ad_id>
GET/bienici/v1/listing?ad_id=<ad_id>

The full listing with the agency name and SIREN, rent and charges split, deposit, inventory fees and the price range of a new-build programme.

Bien'ici listings for a town placed on a map, with price, energy rating and running costs on every row.

request
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"}'
response envelope
{
  "ok": true,
  "data": { … },
  "meta": {
    "api": "bienici",
    "endpoint": "search",
    "mode": "live",
    "latency_ms": …,
    "record_count": …
  },
  "error": null
}

Bien'ici coverage, measured

Every line below was read from live bienici.com answers on 2026-10-29.

Filters that bite

Lyon sales, 3,797 listings unfiltered: price up to 250,000 gave 1,533; at least 100 m² 975; houses 138; 4 rooms or more 1,343; postcode 69003 709; new-build 148. No returned row broke its filter.

Value check

Three listings opened in a browser matched, among them a house at 980,000 € with 6 rooms, 180 m², 5 bedrooms, 2 bathrooms, built in 1935, and a furnished rental at 1,280 € with 80 € charges, 893 € fees, a 207 € inventory fee and a 2,400 € deposit.

Location

Every listing carries coordinates with the precision Bien'ici gives it: exact, blurred within a stated radius, or town only. coordinates_precision says which.

Keywords

Bien'ici has no keyword search of its own, so query is matched on title and description over up to 600 listings per call; total is then null and next_page_token continues. A postcode inside a town with several postcodes (Bordeaux 33100) works the same way.

Search rows vs listing

Search rows carry nearly every field, energy, charges and fees included. The agency's SIREN, and the title the site generates when the agency left it blank, come from listing.

New-build

Programmes publish a price range: price is the lowest, price_max the highest and price_is_from is true.

Limits

A search serves its first 2,500 results, up to 100 a page; France-wide totals are approximate. Contact persons' names and phone numbers are not returned by default.

What people build with Bien'ici

The jobs this data is most often used for.

2

endpoints

1

credit per call

01

Real-estate investors use Bien'ici to search Bien'ici (bienici.com) property listings for sale or rent in France.

02

Brokerage tools use Bien'ici to get one Bien'ici listing by id or URL.

03

Property dashboards use Bien'ici to compare listings, property details, prices, locations and market inventory, all from one ReefAPI key and credit pool.

What Bien'ici data costs

The cheapest call here is 1 credit, so $15/mo (Pro) buys 10,000 of them — $1.50 per 1,000 credits. Credits roll over and never expire, and failed or blocked calls are not charged.

Full pricing →
$0.67–$1.50 / 1,000 credits
  • 1,000 free credits on signup, no card
  • One key, all 587 APIs, one credit pool
  • Failed and blocked calls are never charged
  • Credits roll over and never expire

Call it in two lines

Sign up, get 1,000 credits and one key that works on every engine. Then this is the whole protocol.

curl
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"}'
python
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"])
FAQ

Have a question? We got answers.

The questions people actually ask before wiring up Bien'ici.

Get a free key →
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.

26 Real Estate APIs on the same key

One key, one credit pool, one response envelope. If you are pulling Bien'ici, you are one call away from the rest of the category — no second contract, no second integration.

Already paying for something else?Bien'ici vs Bright Data

Need something this API does not do?

Name the endpoint, the field, or a source we do not carry yet. We ship new APIs every week and you would be first to get the key. Real people read every message and reply the same day.

0/4000

No account needed · we reply from [email protected]

Try it on your own data before you pay anything

The call above is the real endpoint, not a recording. A free key gives you 1,000 credits, the other 586 APIs, and the same envelope everywhere.

Endpoints, parameters and credit costs on this page are read from the live catalog and cannot drift from what the API accepts. Field notes were captured on 2026-10-29.