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:

{
    "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:

{
    "location": "Paris",
    "transactionType": "location",
    "propertyType": "appartement",
    "results_wanted": 100
}

Advanced Full Configuration

Combine all filters for targeted scraping:

{
    "location": "Lyon",
    "keyword": "terrasse",
    "transactionType": "achat",
    "propertyType": "appartement",
    "results_wanted": 200,
    "max_pages": 5,
    "proxyConfiguration": {
        "useApifyProxy": true,
        "apifyProxyGroups": ["RESIDENTIAL"]
    }
}

---

Sample Output

{
    "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
• API Reference
• Scheduling Runs

---

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.