Bienici Property Scraper 🏠

What does Bien'ici Property Scraper do?

Bien'ici Property Scraper collects public property listing data from Bien'ici, the French real estate marketplace. Provide a Bien'ici search URL or use the available keyword, location, and property-type filters to create a structured dataset of properties for sale or rent.

Each saved record can include the listing title and description, price, surface area, rooms, bedrooms, bathrooms, property type, address information, energy ratings, photos, coordinates, and a direct listing URL when the source provides the corresponding values. The dataset is useful for French real estate market research, investment screening, price comparisons, property monitoring, and data enrichment.

Why use Bien'ici Property Scraper?

• Create structured property datasets - Collect listing records without manually copying individual properties into a spreadsheet.
• Search by URL or filters - Reuse a Bien'ici search page or start with a city, keyword, and property type.
• Support sale and rental research - Bien'ici search URLs can represent purchase, rental, and other supported transaction paths.
• Compare property characteristics - Review prices, areas, room counts, energy classifications, amenities, and location data together.
• Control collection size - Set the maximum number of records and the maximum number of result pages to inspect.
• Export for downstream work - Download the Apify Dataset as JSON, CSV, Excel, XML, or another supported format, or connect it to an Apify workflow.

What data can you extract from Bien'ici?

The Actor saves scalar listing fields returned by Bien'ici and removes empty values. The exact fields present vary by listing because properties do not all publish the same information.

Field	Type	Description
title	String	Listing title when published.
description	String	Property description when published.
price	Number	Sale or rental price in euros when available.
priceWithoutFees	Number	Price excluding agency fees when published.
surfaceArea	Number	Property living area in square metres.
landSurfaceArea	Number	Land area in square metres when available.
city	String	City associated with the listing.
postalCode	String	French postal code.
departmentCode	String	French department code when available.
propertyType	String	Source property type, such as house, flat, or program.
adType	String	Source transaction label, such as buy or rent.
roomsQuantity	Number	Total number of rooms.
bedroomsQuantity	Number	Number of bedrooms.
bathroomsQuantity	Number	Number of bathrooms.
parkingPlacesQuantity	Number	Number of parking places when published.
yearOfConstruction	Number	Construction year when published.
energyClassification	String	Energy performance classification, usually A to G.
greenhouseGazClassification	String	Greenhouse gas emissions classification when published.
hasPool	Boolean	Whether the listing indicates a swimming pool.
hasGarden	Boolean	Whether the listing indicates a garden.
hasFirePlace	Boolean	Whether the listing indicates a fireplace.
hasAirConditioning	Boolean	Whether the listing indicates air conditioning.
onTheMarket	Boolean or null	Market status when Bien'ici publishes it.
photos	Array of strings	Photo URLs published for the listing.
lat	Number	Latitude when Bien'ici provides a position.
lon	Number	Longitude when Bien'ici provides a position.
reference	String	Source property reference when published.
modificationDate	String	Last modification date when published.
source	String	Source identifier, set to bienici.com.
url	String	Bien'ici listing URL generated from the listing identifiers and location data.

Other non-empty scalar fields from the source may also appear in a record. Nested source objects are not copied as nested output fields. Selected status and position values are represented by onTheMarket, lat, and lon.

How to use Bien'ici Property Scraper

1. Open Bien'ici and create a public search for the location, transaction, and property type you need.
2. Copy the search results URL, or choose the filter-based input method.
3. Set results_wanted and max_pages for the size of the run.
4. Optionally enter a keyword and configure Apify Proxy settings.
5. Run the Actor and review the dataset preview.
6. Export the results or connect the dataset to your research, reporting, or automation workflow.

The URL method is the simplest option when you need a rental search or a search with several Bien'ici filters. The URL should contain a Bien'ici search path such as /recherche/achat/... or /recherche/location/.... When url is supplied, its transaction, location, and property type take precedence over the matching filter fields. A keyword can still be supplied as an additional text filter.

Input Parameters

All input fields are optional. Use either url or the filter fields. The current input schema accepts only the fields listed below.

Parameter	Type	Required	Default	Description
url	String	No	None	Full Bien'ici search URL. The URL should include a /recherche/ path. Its transaction, location, and property type take precedence over those filter fields.
keyword	String	No	None	Keyword or keywords to search in property titles or descriptions.
location	String	No	None	City or region name, such as Paris, Lyon, or Marseille, used when url is not supplying the location.
propertyType	String	No	maisonvilla	Property type filter. Options are maisonvilla, appartement, programme-neuf, parking, local-commercial, terrain, immeuble, loft, chateau, and bureau.
results_wanted	Integer	No	20	Maximum number of property records to save. Minimum: 1.
max_pages	Integer	No	10	Maximum number of search result pages to inspect. Each page is requested with up to 100 results. Minimum: 1.
proxyConfiguration	Object	No	{"useApifyProxy": false}	Optional Apify Proxy configuration for the run.

The input schema does not provide a separate transaction-type field. To collect rental listings, use a Bien'ici rental search URL, for example a URL containing /recherche/location/. Without a URL, the filter-based mode defaults to purchase searches.

Usage Examples

Basic search URL

Collect up to 20 house listings from a Bien'ici purchase search covering France:

{
  "url": "https://www.bienici.com/recherche/achat/france/maisonvilla",
  "results_wanted": 20,
  "max_pages": 1
}

Filter-based city search

Collect apartment listings matching a keyword in Marseille:

{
  "location": "Marseille",
  "keyword": "terrasse",
  "propertyType": "appartement",
  "results_wanted": 50,
  "max_pages": 2
}

Rental search from a URL

Collect rental apartments from a Bien'ici search URL. The transaction and property type are read from the URL path:

{
  "url": "https://www.bienici.com/recherche/location/lyon/appartement",
  "results_wanted": 100,
  "max_pages": 3,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}

Sample Output

One dataset item may look like this. Optional fields are omitted when Bien'ici does not publish a value for the listing.

{
  "title": "Appartement 4 pièces avec terrasse",
  "description": "Appartement lumineux situé à proximité des commerces.",
  "price": 325000,
  "priceWithoutFees": 310000,
  "surfaceArea": 82.4,
  "city": "Marseille",
  "postalCode": "13008",
  "departmentCode": "13",
  "propertyType": "flat",
  "adType": "buy",
  "roomsQuantity": 4,
  "bedroomsQuantity": 3,
  "bathroomsQuantity": 1,
  "energyClassification": "C",
  "greenhouseGazClassification": "A",
  "hasPool": false,
  "hasGarden": false,
  "photos": [
    "https://file.bienici.com/photo/example-1.jpg",
    "https://file.bienici.com/photo/example-2.jpg"
  ],
  "lat": 43.255,
  "lon": 5.391,
  "reference": "BI-123456",
  "source": "bienici.com",
  "url": "https://www.bienici.com/annonce/vente/marseille-13008/flat/123456"
}

Tips for Best Results

• Start with a focused URL - Apply the desired filters on Bien'ici before copying the results URL.
• Test with a small limit - Begin with 20 records and one page so you can confirm the location, transaction, and property type.
• Use the page cap deliberately - results_wanted controls saved records, while max_pages limits how many result pages are checked.
• Use a specific location - City searches usually produce more focused datasets than a broad France-wide search.
• Review optional fields across several records - Energy ratings, coordinates, photos, room counts, and other attributes depend on the individual listing.
• Report changed source pages - Bien'ici search pages and listing data can change. If a URL stops returning the expected results, include the URL and run details when reporting the issue.

Data-quality behavior and limitations

• The Actor collects listing data available from Bien'ici search results. It does not guarantee that every field shown on an individual property page is present in the dataset.
• Empty strings, null values, undefined values, and empty arrays are left out of records. Missing fields therefore usually mean that the source did not publish that value for the listing.
• Photo data is reduced to an array of usable photo URLs. Other complex nested source objects are not included as nested objects.
• Bien'ici URL parsing expects a search URL containing /recherche/ and uses the transaction, location, and property segments in that path. A general Bien'ici page or an unrelated URL is not a supported search input.
• Results are saved in source order until results_wanted is reached. The Actor does not promise deduplication across pages or runs.
• If a page cannot be collected, the run may stop after the records already saved. A completed run can therefore contain fewer records than requested.
• Search results can change between runs because listings are added, removed, modified, or no longer on the market.

Integrations and exports

• JSON - Use structured records in applications, scripts, and data pipelines.
• CSV - Analyze listings in spreadsheet software.
• Excel - Share tabular property reports with teams and clients.
• XML - Support systems that require XML exports.
• Apify API - Retrieve dataset items programmatically after a run.
• Webhooks and schedules - Trigger downstream workflows or repeat a collection on a recurring schedule through Apify.

Frequently Asked Questions

Can I collect both sale and rental listings?

Yes. Use a Bien'ici search URL with /recherche/achat/ for purchase listings or /recherche/location/ for rental listings. The current schema does not expose a separate transaction input.

Can I search by city and keyword without a URL?

Yes. Provide location, keyword, and optionally propertyType without url. This is the filter-based input method.

Which property types are available?

The schema provides house or villa, apartment, new development, parking, commercial, land, building, loft, castle, and office values through the propertyType field.

Why are some fields missing?

Fields are missing when the source listing does not publish them or when the corresponding value is empty. This is common for energy ratings, coordinates, photos, land area, amenities, and room details depending on the property type.

Does the Actor collect detail-page-only information?

Not necessarily. The output is based on the data available for the matching Bien'ici search results, so information shown only on a detail page may not appear in the dataset.

Can I export Bien'ici data to CSV or Excel?

Yes. Apify Dataset results can be downloaded in CSV, Excel, JSON, XML, and other supported formats.

Can I schedule recurring property collection?

Yes. You can schedule recurring Actor runs in Apify Console and compare later datasets for changes in inventory, prices, or listing attributes.

Is it legal to scrape Bien'ici?

Collecting public data may be permitted in some situations, but you are responsible for complying with applicable laws, Bien'ici terms of service, privacy requirements, and any restrictions that apply to your use of the data.

Related Actors

• Propertyfinder Scraper - Collect property listings, prices, locations, property details, images, and listing URLs from Property Finder.
• iProperty Scraper - Collect Malaysian property listings for sale or rent with structured real estate fields.
• Fotocasa Property Scraper - Collect property listings from a major Spanish real estate marketplace.

Support

For issues or feature requests, use the Issues tab on the Actor page and include the input URL, filters, result limits, and run details.

Legal Notice

This Actor is intended for legitimate collection of publicly available Bien'ici listing data. Users are responsible for using the data responsibly and complying with applicable laws, website terms, privacy requirements, and other relevant rules. This Actor is not affiliated with or endorsed by Bien'ici.