Complete Guide: How to Scrape Bien'ici Listings Using Python
Run the Bien'ici Scraper Apify Actor from Python and turn French real estate searches for flats and houses into structured dataset rows.

This comprehensive guide demonstrates how to extract real estate listings from bienici.com across France using Python: properties for sale and for rent, filtered by location, price, and property type, returned as clean dataset records. The tool powering this workflow is the Bien'ici Scraper Apify Actor (reventadata/bienici-scraper), executed programmatically via the official Apify API client.
Whether you are conducting French property market research, monitoring asking prices across urban districts, or tracking rental yields, programmatic data extraction eliminates manual browsing.
By following this tutorial, you will understand the configuration options the Actor supports, how it resolves locations and handles pagination boundaries, what data columns are returned, and how to automate runs on a recurring schedule. The setup requires only a modern Python environment, an Apify account, and an API token. Every sample record and metric cited throughout this guide originates from a real execution on the live Actor covering residential listings in Lyon, without simulated values or artificial timings.
TL;DR
In this walkthrough you will run reventadata/bienici-scraper from Python with apify-client, pass targeted search filters (locations, transaction, propertyTypes, maxItems), and retrieve structured rows containing pricing, living area, room layout, postal code, arrondissement, energy performance ratings (DPE/GES), and photo links. You will also learn how the Actor automatically cuts searches over 2,500 ads into price bands, how optional agency contact details work, and how to monitor listings on a schedule. The Actor is accessible directly on the Bien'ici Scraper Store page.
Prerequisites and setup
To follow along with this tutorial, ensure you have the following prerequisites in place:
- Python 3.11 or newer installed locally with
pipconfigured. - An Apify account. You can register for free with an email address or through GitHub authentication.
- Your Apify API token, located under Settings > API & Integrations within Apify Console.
Install the official Apify API client package and assign your API token to an environment variable in your terminal:
pip install -U "apify-client~=3.0"
export APIFY_API_TOKEN="your_apify_token_here"
No additional scraping dependencies, headless browsers, or local proxy configurations are needed. The data extraction is handled remotely by the Actor.
Understanding Bien'ici Scraper
Bien'ici is a French real estate platform that indexes property listings across metropolitan France and overseas territories. The Actor searches the platform using public filters and produces structured records containing up to 67 distinct fields.
The Actor supports both purchase (buy) and rental (rent) transactions, and extracts properties categorized as flats (flat) or houses (house). When searching for flats and houses, the site also includes new-build developments (programme), which carry price and surface area ranges. The Actor extracts these ranges cleanly into dedicated minimum and maximum columns (price, priceMax, surfaceAreaM2, surfaceAreaMaxM2).
The site enforces a hard ceiling of 2,500 listings for any single search. When an area or query exceeds 2,500 results, the Actor's splitLargeSearches feature partitions the search across price bands to extract the full volume without truncating results. It handles pagination, deduplication, and schema formatting automatically.
Step-by-step walkthrough
Extracting listings using Python involves setting up your query configuration, invoking the Actor via the Apify client, and reading the resulting dataset.
Step 1: Define your search parameters
The Actor accepts several configuration options:
transaction: Either"buy"or"rent". Values outside this enumeration are refused before the run starts.locations: Array of place names or postal codes (e.g.,["Lyon"],["75011"]). Each location is resolved against the platform's place index. An invalid or unmatched location terminates the run with an informative error. Leaving this field empty searches the whole country.propertyTypes: Allowed values are"flat"and"house". Both are enabled by default.minPriceandmaxPrice: Numeric limits in EUR (monthly rent for rental queries).sortBy: Sorting order:"relevance"(default),"priceAsc","priceDesc", or"newest".maxItems: Total maximum records to store (default is 100).splitLargeSearches: Boolean flag (defaulttrue) allowing the Actor to segment searches over 2,500 ads into price bands.fetchContacts: Boolean flag (defaultfalse) that fetches public agency phone numbers and addresses via an additional request per ad.
Our example run uses a concise input targeting 10 listings in Lyon:
{
"locations": [
"Lyon"
],
"maxItems": 10
}
Step 2: Execute the collection script
The Python script below connects to the Apify platform, executes reventadata/bienici-scraper with the input above, validates that the run completed successfully, and lists the items:
import os
from apify_client import ApifyClient
# 1. Initialise the client with your token from the environment
client = ApifyClient(os.environ["APIFY_API_TOKEN"])
# 2. Describe the search: listings in Lyon, up to 10 items
run_input = {
"locations": [
"Lyon"
],
"maxItems": 10,
}
# 3. Start the Actor and wait for it to finish
run = client.actor("reventadata/bienici-scraper").call(run_input=run_input)
if run is None or run.status != "SUCCEEDED":
status = run.status if run else "unknown"
raise SystemExit(f"Run did not succeed (status: {status}).")
# 4. Read the rows from the run's default dataset
items = client.dataset(run.default_dataset_id).list_items().items
print(f"Retrieved {len(items)} listings.\n")
# 5. Print a summary per listing
for item in items:
city = item.get("city")
price = item.get("price")
area = item.get("surfaceAreaM2")
per_m2 = item.get("pricePerSquareMeter")
per_m2_str = f"{per_m2:.1f} EUR/m2" if per_m2 else "no m2 price"
print(f"{item.get('title')}")
print(f" {city} | {price} EUR | {area} m2 | {per_m2_str} | Energy: {item.get('energyClass')}")
Step 3: Inspect the terminal output
Running the script produces summary lines for each listing. Here are the first three rows from our live run:
Spécial investisseur - Studio meublé en résidence étudiante
Lyon 9e | 40000 EUR | 18 m2 | 2222.2 EUR/m2 | Energy: D
Viager occupé - H72 ans - LYON (69005)
Lyon 5e | 43810 EUR | 60 m2 | no m2 price | Energy: C
STUDIO ETUDIANT LMNP SPECIAL INVEST
Lyon 9e | 44000 EUR | 17 m2 | 2588.2 EUR/m2 | Energy: C
In the second row, the property is listed as a life annuity (lifeAnnuitySale). In French viager listings, the initial lump-sum payment (bouquet) is listed as the price, and the site omits a standard price per square metre, resulting in null. The Actor accurately outputs null rather than manufacturing a value.
Working with the API
The Apify API provides several programmatic mechanisms to trigger and manage runs of reventadata/bienici-scraper from external applications.
When calling the Actor via client.actor("reventadata/bienici-scraper").call(), the client submits a run request and polls until the execution status reaches a terminal state (SUCCEEDED, FAILED, or TIMED-OUT). The returned run object contains metadata such as status, default_dataset_id, and timing information. In our sample run, the Actor achieved SUCCEEDED status in 5.863 seconds of runtime.
If your architecture requires asynchronous execution, you can call .start() instead of .call(), which initiates the run immediately and returns the run object without blocking your application thread. Your code can periodically inspect run status or store the run identifier to retrieve items later using client.dataset(dataset_id).list_items().
Furthermore, you can integrate webhook subscriptions into your workflow. By defining a webhook in Apify Console or via the API, the platform sends an HTTP POST request to your webhook endpoint whenever the Actor run finishes. The webhook payload contains the run resource, including defaultDatasetId, allowing downstream services to ingest newly scraped records without active polling or resource contention.
Advanced usage patterns
For production pipelines and large-scale data harvesting, Bien'ici Scraper provides several advanced configuration strategies:
- Automated Price-Band Slicing: A single search on bienici.com cannot page past 2,500 ads. When extracting an entire department or major city like Paris or Lyon where total listings exceed this limit, leaving
splitLargeSearches: trueensures the Actor cuts the price spectrum into smaller intervals, extracts listings from each band sequentially, and deduplicates records across band boundaries. - Contact Detail Enrichment: By default, search results on the portal omit direct agency telephone numbers. Setting
fetchContacts: trueinstructs the Actor to fetch public agency and agent contact details for each listing, adding attributes such asagencyName,contactPhone, andagencyRcs. This performs one extra request per listing while keeping listings without contact info. - Filtering by French Administrative Zones: You can pass postal codes (such as
"69009"or"75011") directly into thelocationsarray. The Actor looks up the zone identifiers automatically and targets the corresponding municipal boundary, printing resolved zone identifiers in the run log. - Targeted Price Filtering: Setting
minPriceandmaxPricefilters listings at the query level, allowing you to segment queries or isolate specific market tiers directly on the site.
Understanding your data
Every dataset item returned by Bien'ici Scraper conforms to a structured schema with 67 fields:
id,url: Unique ad identifier and listing link.transaction,propertyType: Transaction (buy,rent,lifeAnnuitySale) and property type (flat,house,programme).price,priceMax,currency: Asking price in EUR and upper bound for new developments.surfaceAreaM2,rooms,bedrooms,floor: Property dimensions and layout.city,postalCode,departmentCode,district: Geographic administrative details.latitude,longitude,locationBlurRadiusM: Blurred map position coordinates and radius.energyClass,greenhouseGasClass: Official French energy performance ratings (DPE/GES).photos,photoCount: Image URLs and photo tally.
One row from the run (null fields dropped, description shortened, photos cut to first link):
{
"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...",
"price": 40000,
"currency": "EUR",
"pricePerSquareMeter": 2222.222222222222,
"priceWithoutFees": 40000,
"priceHasDecreased": false,
"surfaceAreaM2": 18,
"rooms": 1,
"bedrooms": 0,
"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,
"annualCondominiumFees": 429.999999999996,
"modifiedAt": "2026-11-13T01:49:23.903Z",
"sellerType": "mandatary",
"reference": "338476",
"photoCount": 5,
"photos": [
"https://file.bienici.com/photo/ag311656-540248687_photos.ubiflow.net_311656_540248687_photos_1.jpg_INSOON_EB_5512801818_20260711122226"
]
}
Fields left empty on the site appear as null.
Troubleshooting guide
- Zero rows returned with SUCCEEDED status: The site answered the query, but no listings matched your filter combination, or the target location has no active listings. Verify your location spelling and check whether broadening price limits returns records.
- Run terminates with FAILED status: A configuration validation failed prior to execution, such as providing an unrecognised transaction type, an invalid location name that matched no place in France, or setting
minPriceabovemaxPrice. The error message indicates the exact field to fix. - Empty contact fields: Fields such as
agencyName,contactPhone, andagencyRcsremainnullwhenfetchContactsisfalse. Enable"fetchContacts": truein your run input if contact data is required. - Fewer rows than requested: If the total available inventory matching your query is smaller than
maxItems, the Actor terminates normally after exhausting matching listings. Rejection counts and duplicate entries are listed in the run log in Apify Console.
Best practices
- Start with modest item limits: When building or testing data pipelines, configure
maxItems: 10to verify data mapping before extracting thousands of items across larger queries. - Use sorting for monitoring: For market alert systems, set
sortBy: "newest"to ensure freshly listed properties appear on the first retrieved pages during scheduled sweeps. - Account for map blurring: Bien'ici displays property locations as circular areas with a blur radius. Use
locationBlurRadiusMwhen plotting properties on map overlays or calculating spatial proximity. - Adhere to terms and compliance: Verify that your data extraction and downstream storage comply with bienici.com terms of service and European General Data Protection Regulation (GDPR) requirements.
Conclusion and next steps
For current pricing and details, see the Store page.
To automate recurring collections, save your input configuration as an Apify task and connect an Apify schedule. Apify datasets can be exported in formats including JSON, CSV, Excel, XML, or NDJSON (dataset docs), and integrated directly into data warehouses, dashboards, or alerting tools.
Resources
- Bien'ici Scraper on Apify Store
- Apify API Client for Python Documentation
- Apify Datasets Guide
- Apify Webhooks Documentation
About the author: reventadata builds and publishes data extraction Actors on the Apify Store.
About the author
- Hi, I'm the engineer behind ReventaData. I build pay-per-event Apify Actors that turn public marketplace, classifieds, jobs and real-estate sites into clean, reliable datasets. Here on Hashnode, I share practical tutorials on collecting structured web data with Python and Apify, and on putting it to work: price tracking, lead lists and market analysis. Explore our turnkey scrapers: https://apify.com/reventadata
Comments
Join the discussionNo comments yet. Be the first to comment.




