Sign in Get API key
Bien'ici API

Bien'ici Scraper API for French Property Search, Details, and New Builds

Scrappa is an independent Bien'ici API with 7 read-only endpoints covering the whole French property search cycle: search properties for sale (achat), for rent (location), and new builds (neuf); read a single listing in full; check which individual lots are still available inside a new-build programme; list one agency's ads; and resolve place names to the zone ids a scoped search consumes. Scrappa is not affiliated with or endorsed by Bien'ici.

500 free credits
No card needed
From $0.20 / 1k
Pay as you go
Structured JSON
Ready for apps
API key access
Test in minutes
Start for free View documentation
Browse endpoints Try first endpoint
7
Endpoints
France
Coverage
$0.20
Per 1k requests

Try it now

Make one request. Inspect structured JSON.

Use the first endpoint in this API family with a Scrappa API key. Every account includes 500 free monthly credits, so you can validate the response shape before buying credits.

Get free API key Try in Playground Open docs
Request preview
Request 
curl -X GET "https://scrappa.co/api/bienici/search?transaction_type=rent&zone_ids[]=-7444&size=2" \
  -H "Accept: application/json" \
  -H "X-API-KEY: YOUR_API_KEY"
JSON response 
{
  "success": true,
  "data": {
    "realEstateAds": [
      {
        "id": "ag750725-49688129",
        "reference": "602996",
        "transactionType": "rent",
        "propertyType": "flat",
        "price": {"min": null, "max": null, "currency": null, "disclosed": false, "unit": "total"},
        "surfaceArea": 40,
        "roomsQuantity": 2,
        "city": "Paris",
        "postalCode": "75007"
      }
    ],
    "returnedCount": 1
  },
  "meta": {"endpoint_family": "search"}
}

What you can build

Structured data for real applications. Here are some ideas.

Property Search Apps

Build an apartment or house finder for France with live achat and location ads, filtered by price, area, rooms, bedrooms, energy class, and features.

New-Build Availability

Show which flats, parking spaces, and cellars are still available in a new-build programme, with per-lot price ranges, status, and delivery dates.

Agency Monitoring

Track the ad inventory of a specific agency or network and follow how its buy and rent listings change over time.

Location Resolution

Turn a French place name into the zone ids, INSEE code, and postal codes a scoped search consumes, for search forms and relocation tools.

Available endpoints

Everything you need in one API.

GET

Property Search

/api/bienici/search

Search achat, location, and neuf listings by zone, property type, price, area, rooms, and features

Try in Playground View docs
GET

Listing Detail

/api/bienici/listing

Full detail for one listing including description, photos, energy rating, and coordinates

Try in Playground View docs
GET

New-Build Programme Units

/api/bienici/programme-units

Per-lot availability inside a new-build programme with price ranges and delivery dates

Try in Playground View docs

Scrappa vs Bien'ici partner data access

See how Scrappa compares to the official API.

Search all public listings
Scrappa:
Bien'ici partner data access: Own listings only
Achat, location, and neuf
Scrappa:
Bien'ici partner data access: Feed limited to your own stock
New-build programme lots
Scrappa:
Bien'ici partner data access: Not included
Authentication
Scrappa: API key only
Bien'ici partner data access: Contract and integration review
Partner agreement needed
Scrappa:
Bien'ici partner data access:
Location zone id resolution
Scrappa:
Bien'ici partner data access: Not exposed
Price per 1k requests
Scrappa: $0.20
Bien'ici partner data access: Contract pricing
Setup time
Scrappa: Minutes
Bien'ici partner data access: Weeks (contract)

Key features

Achat, location, and neuf search through one endpoint
Full listing detail with photos, description, and energy rating
Per-lot availability inside new-build programmes
Listings for one agency by its Bien'ici account id
Location resolution to the zone ids a scoped search consumes
Prices normalized from scalars and ranges into a single min/max shape
Structured contact fields removed; seller-written description text passed through

Frequently asked questions

Resolve the place name with the locations endpoint first to get its zone ids, then pass those as zone_ids on the search endpoint. Search deliberately does not resolve free text for you, because that would spend a second upstream lookup inside one billable request. The locations call is a separate endpoint with its own credit.

New-build listings price as a range while ordinary listings price as a single figure, so the raw value is either a number or a range. Every ad is normalized into the same shape. When an owner has not published a figure, disclosed is false and min and max are null rather than 0.

The structured agent contact block is not returned — it is removed from every response. Each ad's description is the seller's own upstream text, passed through unchanged, so a phone number or email address the seller typed into the ad text is published as written. The agency business identifier is kept, because that is what the agency listings endpoint needs to scope results to one agency.

Yes. Search with transaction_type=new_build, take a programme ad id, and pass it to the programme units endpoint to get the individual flats, parking spaces, and cellars still available, each with its own price range, status, and delivery date.

Fields depend on what the owner or agency filled in, so optional values such as land surface area or year of construction are null when absent. Read every field by name and treat a null as not supplied.

Yes. Every Scrappa account includes 500 free credits per month, so you can test the 7 Bien'ici endpoints before buying credit packs or moving to a subscription.

Each request uses one Scrappa credit, and paid usage starts at $0.20 per 1,000 requests. Failed requests are not billed.

Start using the Bien'ici API

Sign up and get 500 free credits. No credit card required.

Create Free Account View Documentation