# Bienici Property Scraper 🏠 (`shahidirfan/bienici-property-scraper`) Actor Scrape live real estate listings from Bienici.com. Extract property prices, locations, descriptions, images & contact details. Ideal for market analysis, investment research, competitive pricing, lead generation & property datasets. Clean, structured output ready for analysis. - **URL**: https://apify.com/shahidirfan/bienici-property-scraper.md - **Developed by:** [Shahid Irfan](https://apify.com/shahidirfan) (community) - **Categories:** Real estate, Lead generation, Automation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing Pay per usage This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-usage ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. 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. Actors are written with capital "A". ## 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. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Bien'ici Property Scraper Extract comprehensive property listings from Bien'ici (bienici.com), the French real estate marketplace. Collect prices, surface areas, room counts, energy diagnostics, photos, and more at scale. Perfect for market research, investment analysis, and property monitoring. ### Features - **URL-based scraping** - Use any Bien'ici search URL to start collecting data instantly - **Rich property data** - Extract price, surface area, rooms, bedrooms, bathrooms, energy class, and more - **Photo collection** - Gather all property photo URLs for visual analysis - **Location details** - Get city, postal code, department, GPS coordinates - **Transaction types** - Support for buying (achat) and renting (location) listings - **Property types** - Houses, apartments, new developments, commercial, land, and more - **Automatic pagination** - Collect hundreds of listings across multiple pages ### Use Cases #### Market Research Analyze property prices across different French cities and regions. Compare listing volumes, price per square meter, and property characteristics to identify market trends. #### Investment Analysis Track property values and rental prices in specific areas. Use energy classification data to estimate renovation costs and long-term value. #### Competitive Intelligence Monitor property listings from agencies and private sellers. Understand listing volumes, pricing strategies, and time on market across different property types. --- ### Input Parameters | Parameter | Type | Required | Default | Description | |-----------|------|----------|---------|-------------| | `url` | String | No | - | Full Bien'ici search URL to scrape (overrides other filters) | | `keyword` | String | No | - | Search in property descriptions and titles | | `location` | String | No | - | City or region name (Paris, Lyon, Marseille) | | `transactionType` | String | No | `achat` | Type: `achat` (buy) or `location` (rent) | | `propertyType` | String | No | `maisonvilla` | Property type (house, apartment, new development, etc.) | | `results_wanted` | Integer | No | `20` | Maximum number of listings to collect | | `max_pages` | Integer | No | `10` | Safety cap on API pages (100 results per page) | | `proxyConfiguration` | Object | No | - | Apify Proxy settings for reliable scraping | --- ### Output Data Each item in the dataset contains: | Field | Type | Description | |-------|------|-------------| | `title` | String | Property listing title | | `description` | String | Full property description | | `price` | Number | Sale or rent price in EUR | | `priceWithoutFees` | Number | Price excluding agency fees | | `surfaceArea` | Number | Living surface area (m\u00b2) | | `landSurfaceArea` | Number | Land surface area (m\u00b2) | | `city` | String | City name | | `postalCode` | String | Postal code | | `departmentCode` | String | French department code | | `propertyType` | String | Type (house, flat, program, etc.) | | `adType` | String | Transaction type (buy or rent) | | `roomsQuantity` | Integer | Number of rooms | | `bedroomsQuantity` | Integer | Number of bedrooms | | `bathroomsQuantity` | Integer | Number of bathrooms | | `yearOfConstruction` | Integer | Year built | | `energyClassification` | String | Energy performance rating (A-G) | | `greenhouseGazClassification` | String | Greenhouse gas emission rating (A-G) | | `hasPool` | Boolean | Has swimming pool | | `hasGarden` | Boolean | Has garden | | `hasFirePlace` | Boolean | Has fireplace | | `hasAirConditioning` | Boolean | Has air conditioning | | `photos` | Array | Array of photo URLs | | `lat` | Number | Latitude coordinate | | `lon` | Number | Longitude coordinate | | `reference` | String | Property reference number | | `url` | String | URL to the property listing | | `modificationDate` | String | Last modification date | --- ### Usage Examples #### Basic Scraping with URL Use a Bien'ici search URL to scrape properties: ```json { "url": "https://www.bienici.com/recherche/achat/france/maisonvilla", "results_wanted": 50 } ```` #### Scraping by City and Property Type Search for apartments for rent in Paris: ```json { "location": "Paris", "transactionType": "location", "propertyType": "appartement", "results_wanted": 100 } ``` #### Advanced Full Configuration Combine all filters for targeted scraping: ```json { "location": "Lyon", "keyword": "terrasse", "transactionType": "achat", "propertyType": "appartement", "results_wanted": 200, "max_pages": 5, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": ["RESIDENTIAL"] } } ``` *** ### Sample Output ```json { "title": "CHARTRONS - DUPLEX RENOVE - TERRASSE SUD-OUEST", "price": 470000, "priceWithoutFees": 456350, "city": "Bordeaux", "postalCode": "33300", "departmentCode": "33", "propertyType": "flat", "adType": "buy", "surfaceArea": 102.52, "roomsQuantity": 4, "bedroomsQuantity": 3, "energyClassification": "C", "greenhouseGazClassification": "A", "hasFirePlace": false, "photos": [ "https://file.bienici.com/photo/...a.jpg", "https://file.bienici.com/photo/...b.jpg" ], "lat": 44.8575, "lon": -0.5838, "description": "Duplex rare au coeur de Chartrons...", "url": "https://www.bienici.com/annonce/vente/bordeaux-33300/flat/immo-facile-60587888" } ``` *** ### Tips for Best Results #### Start with a Search URL The easiest way to get started is to visit Bien'ici, set your search filters, and copy the resulting URL. Paste it into the `url` field for instant results. #### Use Specific Locations For faster and more relevant results, include a city name in your search. Broad searches across all of France may return many results but take longer. #### Set Realistic Result Counts Start with 20-50 results for testing, then increase for production runs. The API returns 100 results per page, so 200 results means 2 API calls. *** ### Integrations Connect your data with: - **Google Sheets** - Export for market analysis - **Airtable** - Build searchable property databases - **Slack** - Get alerts for new listings - **Make** - Create automated workflows #### Export Formats - **JSON** - For developers and APIs - **CSV** - For spreadsheet analysis - **Excel** - For business reporting *** ### Frequently Asked Questions #### How many listings can I collect? You can collect all available listings matching your search. The practical limit depends on the search criteria and the total number of matching properties on Bien'ici. #### Can I scrape both buy and rent listings? Yes. Use `transactionType` set to `achat` for purchases or `location` for rentals. You can also use the URL directly from a Bien'ici search page. #### What property types are supported? The scraper supports houses (maisonvilla), apartments (appartement), new developments (programme-neuf), parking, commercial spaces, land, buildings, lofts, castles, and offices. #### Why are some fields missing? Some properties may not have all fields available. For example, land listings won't have room counts, and some properties may not have energy diagnostics data. #### Does this work with any Bien'ici URL? Yes, any valid Bien'ici search URL works. Simply copy the URL from your browser after setting your desired filters and paste it into the `url` field. *** ### Support For issues or feature requests, contact support through the Apify Console. #### Resources - [Apify Documentation](https://docs.apify.com/) - [API Reference](https://docs.apify.com/api/v2) - [Scheduling Runs](https://docs.apify.com/schedules) *** ### Legal Notice This actor is designed for legitimate data collection purposes. Users are responsible for ensuring compliance with website terms of service and applicable laws. Data should be used responsibly and in accordance with applicable regulations. # Actor input Schema ## `url` (type: `string`): Full Bien'ici search URL to scrape (e.g., https://www.bienici.com/recherche/achat/france/maisonvilla). If provided, keyword/location settings are ignored. ## `keyword` (type: `string`): Search keyword(s) in property description or title. ## `location` (type: `string`): City name (e.g., Paris, Lyon, Marseille) or region. ## `propertyType` (type: `string`): Type of property: maisonvilla (house/villa), appartement (apartment), programme-neuf (new development), etc. ## `results_wanted` (type: `integer`): Maximum number of property listings to collect. ## `max_pages` (type: `integer`): Safety cap on number of API pages to fetch (100 results per page). ## `proxyConfiguration` (type: `object`): Use Apify Proxy for reliable scraping. ## Actor input object example ```json { "url": "https://www.bienici.com/recherche/achat/france/maisonvilla", "location": "Paris", "propertyType": "maisonvilla", "results_wanted": 20, "max_pages": 10, "proxyConfiguration": { "useApifyProxy": false } } ``` # Actor output Schema ## `dataset` (type: `string`): Dataset containing all scraped property listings # 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 '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "url": "https://www.bienici.com/recherche/achat/france/maisonvilla", "location": "Paris", "results_wanted": 20 }; // Run the Actor and wait for it to finish const run = await client.actor("shahidirfan/bienici-property-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 '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "url": "https://www.bienici.com/recherche/achat/france/maisonvilla", "location": "Paris", "results_wanted": 20, } # Run the Actor and wait for it to finish run = client.actor("shahidirfan/bienici-property-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "url": "https://www.bienici.com/recherche/achat/france/maisonvilla", "location": "Paris", "results_wanted": 20 }' | apify call shahidirfan/bienici-property-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=shahidirfan/bienici-property-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Bienici Property Scraper 🏠", "description": "Scrape live real estate listings from Bienici.com. Extract property prices, locations, descriptions, images & contact details. Ideal for market analysis, investment research, competitive pricing, lead generation & property datasets. Clean, structured output ready for analysis.", "version": "0.0", "x-build-id": "QjRDXDc32jwQPt0cy" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/shahidirfan~bienici-property-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-shahidirfan-bienici-property-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/shahidirfan~bienici-property-scraper/runs": { "post": { "operationId": "runs-sync-shahidirfan-bienici-property-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/shahidirfan~bienici-property-scraper/run-sync": { "post": { "operationId": "run-sync-shahidirfan-bienici-property-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "url": { "title": "Bien'ici search URL", "type": "string", "description": "Full Bien'ici search URL to scrape (e.g., https://www.bienici.com/recherche/achat/france/maisonvilla). If provided, keyword/location settings are ignored." }, "keyword": { "title": "Keyword", "type": "string", "description": "Search keyword(s) in property description or title." }, "location": { "title": "Location (city or region)", "type": "string", "description": "City name (e.g., Paris, Lyon, Marseille) or region." }, "propertyType": { "title": "Property type", "enum": [ "maisonvilla", "appartement", "programme-neuf", "parking", "local-commercial", "terrain", "immeuble", "loft", "chateau", "bureau" ], "type": "string", "description": "Type of property: maisonvilla (house/villa), appartement (apartment), programme-neuf (new development), etc.", "default": "maisonvilla" }, "results_wanted": { "title": "Maximum results", "minimum": 1, "type": "integer", "description": "Maximum number of property listings to collect.", "default": 20 }, "max_pages": { "title": "Maximum pages", "minimum": 1, "type": "integer", "description": "Safety cap on number of API pages to fetch (100 results per page).", "default": 10 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Use Apify Proxy for reliable scraping.", "default": { "useApifyProxy": false } } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```