# Bien'ici Scraper: France Property Listings (`reventadata/bienici-scraper`) Actor

Scrape Bien'ici property listings for sale or rent in any French city. Price, price per m², surface, rooms, bedrooms, floor, energy and CO2 class, year built, address and approximate coordinates, photos and seller type. Unofficial.

- **URL**: https://apify.com/reventadata/bienici-scraper.md
- **Developed by:** [reventadata](https://apify.com/reventadata) (community)
- **Categories:** Real estate, Automation
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.00 / 1,000 results

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Bien'ici Scraper: French real estate listings

> **Unofficial.** This Actor is not affiliated with, authorised by, endorsed by, or in any
> way officially connected to Bien'ici. "Bien'ici" is a trademark of its respective owner and
> is used here only to describe what this tool reads. It reads the same public data a browser
> does.

Bien'ici Scraper extracts property listings for sale and for rent from bienici.com, the French real estate portal, as clean dataset rows.

### What does it do?

Searches bienici.com for flats, houses and new-build programmes to buy or rent, anywhere in France, and returns one row per listing: price, area, rooms, location, energy class, photos, seller and publication dates. Optionally it adds the agency name, contact person, phone number, company number and address that each listing shows publicly.

### Why use it?

- **Any place in France:** give city names or postal codes ("Lyon", "Paris 11e", "75011"), or leave the field empty for all of France.
- **Beyond the 2,500-ad limit:** Bien'ici stops paging a search after its first 2,500 ads. For larger searches the Actor cuts the search into price ranges and reads them one after the other, so a city with 3,000+ ads is not cut short.
- **Structured columns:** numbers are numbers, booleans are booleans, dates are ISO 8601; missing data is `null`, never a made-up value.
- **Public data only:** nothing from behind a login. Agency and contact details are the ones the site shows publicly on the listing.

### How to use it

1. Choose buy or rent, and enter one or more places (or leave empty for all of France).
2. Optionally set property types, a price range, a sort order and the number of items.
3. Run the Actor and download the results as JSON, CSV, Excel or NDJSON from the dataset.

#### Input

| Field | Type | Description |
|---|---|---|
| `transaction` | string | `buy` (default) or `rent`. |
| `locations` | array | City names or postal codes. Each is looked up on bienici.com; the best match is searched and printed in the run log. |
| `zoneIds` | array | Optional Bien'ici zone ids, added to the places above. |
| `propertyTypes` | array | `flat` and/or `house` (both by default). New-build programmes come back inside these searches, marked `programme`. |
| `minPrice`, `maxPrice` | integer | Optional price limits in euros (monthly rent on a rent search). |
| `sortBy` | string | `relevance` (default), `priceAsc`, `priceDesc` or `newest`. |
| `maxItems` | integer | Maximum number of listings to save (default 100). |
| `splitLargeSearches` | boolean | On by default. Cuts searches above 2,500 ads into price ranges so more than 2,500 items can be read. |
| `fetchContacts` | boolean | Off by default. Adds agency and contact details with one extra request per listing. |
| `proxyConfiguration` | object | Optional. No proxy is used by default. |

#### Sample input

```json
{
    "transaction": "buy",
    "locations": ["75011"],
    "maxItems": 100,
    "sortBy": "newest",
    "fetchContacts": true
}
```

#### Output

Each dataset item contains the fields below (all fields are listed in the dataset schema; empty ones are `null`).

| Field | Type | Description |
|---|---|---|
| `id`, `url` | string | Bien'ici listing id and link. |
| `transaction`, `propertyType` | string | `buy` / `rent`; `flat`, `house` or `programme`. |
| `title`, `description` | string | Listing text. |
| `price`, `priceMax`, `currency` | number / string | Price in euros; `priceMax` is set on new-build programmes, whose price is a range. |
| `pricePerSquareMeter`, `priceWithoutFees` | number | As given by the site. |
| `charges`, `safetyDeposit`, `agencyRentalFee`, `isFurnished` | number / boolean | Rent listings. |
| `surfaceAreaM2`, `rooms`, `bedrooms`, `bathrooms`, `floor`, `floorsInBuilding` | number | Size and layout. |
| `city`, `postalCode`, `departmentCode`, `district` | string | Location. |
| `latitude`, `longitude`, `locationBlurRadiusM` | number | The site shows a blurred map position, not the exact address; this is its centre and radius. |
| `energyClass`, `energyValue`, `greenhouseGasClass`, `greenhouseGasValue` | string / number | DPE and GES. |
| `yearOfConstruction`, `heating`, `exposition`, `annualCondominiumFees` | various | Building details, when given. |
| `hasElevator`, `hasTerrace`, `hasBalcony`, `hasPool`, `hasCellar`, `parkingPlaces` | boolean / number | Amenities, when the listing says. |
| `publishedAt`, `modifiedAt`, `availableFrom` | string | ISO 8601; `publishedAt` is `null` when the site has no real date. |
| `sellerType`, `sellerName`, `sellerId`, `reference` | string | Who lists it, as the search result gives it. |
| `photoCount`, `photos` | integer / array | Photo URLs. |
| `agencyName`, `contactName`, `contactPhone`, `agencyRcs`, `agencyStreet`, `agencyCity`, `agencyPostalCode`, `agencyWebsite`, `agencyId` | string | Only with `fetchContacts`. |

#### Sample output

One row from a real platform run on 2026-11-11 (search `Lyon`, `fetchContacts` off, so the agency and contact columns are `null`; `photos` shortened to 2 items and `description` to 300 characters):

```json
{
  "id": "ag311656-540248687",
  "url": "https://www.bienici.com/annonce/ag311656-540248687",
  "transaction": "buy",
  "propertyType": "flat",
  "title": "Spécial investisseur - Studio meublé en résidence étudiante",
  "description": "Dans la résidence Nexity La Duchère, située dans un quartier calme au nord de Lyon, la résidence bénéficie d'un emplacement privilégié à proximité du pôle universitaire d'excellence technologique, de l'École de Santé et d'un stade d'athlétisme, investissez dans ce studio meublé de 18,22 m², situé au...",
  "price": 40000,
  "priceMax": null,
  "currency": "EUR",
  "pricePerSquareMeter": 2222.222222222222,
  "pricePerSquareMeterMax": null,
  "priceWithoutFees": 40000,
  "priceHasDecreased": false,
  "charges": null,
  "safetyDeposit": null,
  "agencyRentalFee": null,
  "agencyFeePercentage": null,
  "isFurnished": null,
  "surfaceAreaM2": 18,
  "surfaceAreaMaxM2": null,
  "rooms": 1,
  "roomsMax": null,
  "bedrooms": 0,
  "bathrooms": null,
  "floor": 2,
  "floorsInBuilding": 6,
  "city": "Lyon 9e",
  "postalCode": "69009",
  "departmentCode": "69",
  "district": "Lyon 9e Arrondissement - La Duchère",
  "latitude": 45.78734972680843,
  "longitude": 4.794521345968208,
  "locationBlurRadiusM": 125,
  "energyClass": "D",
  "energyValue": 270,
  "greenhouseGasClass": "C",
  "greenhouseGasValue": 24,
  "yearOfConstruction": 2006,
  "heating": null,
  "exposition": null,
  "annualCondominiumFees": 429.999999999996,
  "hasElevator": null,
  "hasTerrace": false,
  "hasBalcony": false,
  "hasPool": null,
  "hasCellar": null,
  "parkingPlaces": null,
  "isNewProperty": false,
  "isBienIciExclusive": false,
  "publishedAt": null,
  "modifiedAt": "2026-10-25T19:46:32.719Z",
  "availableFrom": null,
  "sellerType": "mandatary",
  "sellerName": null,
  "sellerId": null,
  "reference": "338476",
  "photoCount": 5,
  "photos": [
    "https://file.bienici.com/photo/ag311656-540248687_photos.ubiflow.net_311656_540248687_photos_1.jpg_INSOON_EB_5512801818_20260711122226",
    "https://file.bienici.com/photo/ag311656-540248687_photos.ubiflow.net_311656_540248687_photos_2.jpg_INSOON_EB_5512801818_20260711122226"
  ],
  "agencyName": null,
  "contactName": null,
  "contactPhone": null,
  "agencyRcs": null,
  "agencyStreet": null,
  "agencyCity": null,
  "agencyPostalCode": null,
  "agencyWebsite": null,
  "agencyId": null
}
```

### Good to know

- One Bien'ici search can be read only up to its first 2,500 ads. With `splitLargeSearches` on, the Actor cuts a larger search into price ranges. A new-build programme whose price range spans two of them is seen twice and saved once. If more than 2,500 ads share a single price, the surplus cannot be reached and the log says how many.
- If a place name matches nothing, or the site rejects a search, the run stops with an error that names the problem. A search that simply matches nothing ends successfully with a message.
- With `fetchContacts` on, a listing whose contact lookup fails is still saved, with the contact columns empty.

### Pricing

Pay-per-event. The current price is on the Actor's Pricing tab.

### Privacy & Compliance

This Actor reads only publicly accessible data and returns what the site shows. It sends no login. Seller and agency names, phone numbers and addresses that a listing displays publicly are in the rows; nothing private is collected. You are responsible for using the data in line with the site's terms and French data protection law (GDPR) when it relates to individuals.

# Actor input Schema

## `transaction` (type: `string`):

Listings for sale (buy) or for rent (rent).

## `locations` (type: `array`):

City names or postal codes, for example "Lyon", "Paris 11e" or "75011". Each one is looked up on bienici.com and the best match is searched; the matches are listed in the run log. Several places are searched together. Leave this and Zone ids empty to search all of France. A place that matches nothing stops the run with an error.

## `zoneIds` (type: `array`):

Optional. Bien'ici zone ids (for example "-7444" is Paris), added to the places above. The run log prints the zone id of every place you give, so you can reuse it here.

## `propertyTypes` (type: `array`):

Which kinds of property to include: flat (appartement) and/or house (maison). Other Bien'ici categories were not tested and are not offered.

## `minPrice` (type: `integer`):

Optional. Lower price limit in euros; on a rent search it limits the monthly rent. Left out of the request when empty.

## `maxPrice` (type: `integer`):

Optional. Upper price limit in euros; on a rent search it limits the monthly rent. Left out of the request when empty.

## `sortBy` (type: `string`):

Order of the listings: the site's relevance order, price from low to high, price from high to low, or most recently published first.

## `maxItems` (type: `integer`):

Maximum number of listings to save. One Bien'ici search can be read only up to its first 2,500 ads; above that the Actor cuts the search into price bands (see Split large searches).

## `splitLargeSearches` (type: `boolean`):

Bien'ici stops paging a search after its first 2,500 ads. When this is on and you ask for more than 2,500 items from a larger search, the Actor cuts the search into price ranges that each fit, and reads them one after the other (lowest prices first). When it is off, the run reads the first 2,500 and logs how many more match.

## `fetchContacts` (type: `boolean`):

Search results carry no phone number. When this is on, the Actor makes one extra request per listing and fills the agency name, contact name, phone, company number (RCS), address and website that the listing page shows publicly. Slower: about 1 extra request per row.

## `proxyConfiguration` (type: `object`):

Optional. Apify Proxy settings, off by default. Turn on if the site refuses your runs.

## Actor input object example

```json
{
  "transaction": "buy",
  "locations": [
    "Lyon"
  ],
  "propertyTypes": [
    "flat",
    "house"
  ],
  "sortBy": "relevance",
  "maxItems": 10,
  "splitLargeSearches": true,
  "fetchContacts": false,
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}
```

# Actor output Schema

## `dataset` (type: `string`):

Items scraped from the target website.

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "locations": [
        "Lyon"
    ],
    "maxItems": 10
};

// Run the Actor and wait for it to finish
const run = await client.actor("reventadata/bienici-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "locations": ["Lyon"],
    "maxItems": 10,
}

# Run the Actor and wait for it to finish
run = client.actor("reventadata/bienici-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "locations": [
    "Lyon"
  ],
  "maxItems": 10
}' |
apify call reventadata/bienici-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,reventadata/bienici-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/8XT0HHK66GOVEwYs4/builds/qiQJdWD2YOBy7jGBL/openapi.json
