# Bien'ici Property Search

## Overview

| Property | Value |
|----------|-------|
| **Status** | private |
| **Method** | `GET` |
| **Endpoint** | `/v2/bienici/search` |
| **Base URL** | `https://api.piloterr.com` |
| **Credit Cost** | 1 credit per call |
| **Documentation** | https://www.piloterr.com/library/bienici-search |

## Description

Search Bien'ici property listings in France by location and transaction type, returning price, area, DPE energy class, GPS coordinates, and agency data as structured JSON.

## Authentication

- **Key Name:** `x-api-key`
- **Location:** HTTP Header
- **Get an API key:** https://app.piloterr.com/register

## Example Request

```bash
curl --location --request GET 'https://api.piloterr.com/v2/bienici/search' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY'
```

## Example Response

### Apartments for sale in Paris

```json
{
  "meta": {
    "ad_type": "buy",
    "location": "paris",
    "total_pages": 620,
    "current_page": 1,
    "has_next_page": true,
    "total_results": 14872
  },
  "listings": [
    {
      "id": "ad-1049382756",
      "url": "https://www.bienici.com/annonce/vente/paris-8e-arrondissement-75008/appartement/ad-1049382756",
      "city": "Paris 8ème Arrondissement",
      "floor": 4,
      "price": 875000,
      "rooms": 3,
      "title": "Appartement 3 pièces 68 m² Paris 8ème",
      "ad_type": "buy",
      "area_m2": 68,
      "bedrooms": 2,
      "currency": "EUR",
      "latitude": 48.8742,
      "dpe_class": "D",
      "ges_class": "D",
      "longitude": 2.3103,
      "department": "75",
      "agency_name": "Barnes Paris 8",
      "postal_code": "75008",
      "is_new_build": false,
      "price_per_m2": 12868,
      "published_at": "2026-05-06T10:30:00.000Z",
      "property_type": "flat",
      "thumbnail_url": "https://photos.bienici.com/ad-1049382756-photo-1-800x600.jpg"
    },
    {
      "id": "ad-1049503812",
      "url": "https://www.bienici.com/annonce/vente/paris-11e-arrondissement-75011/appartement/ad-1049503812",
      "city": "Paris 11ème Arrondissement",
      "floor": 2,
      "price": 1050000,
      "rooms": 4,
      "title": "Appartement 4 pièces 92 m² Paris 11ème",
      "ad_type": "buy",
      "area_m2": 92,
      "bedrooms": 3,
      "currency": "EUR",
      "latitude": 48.8596,
      "dpe_class": "C",
      "ges_class": "C",
      "longitude": 2.3758,
      "department": "75",
      "agency_name": null,
      "postal_code": "75011",
      "is_new_build": false,
      "price_per_m2": 11413,
      "published_at": "2026-05-09T14:45:00.000Z",
      "property_type": "flat",
      "thumbnail_url": "https://photos.bienici.com/ad-1049503812-photo-1-800x600.jpg"
    }
  ]
}
```

## Documentation

## Overview

Bien'ici is a major French property portal in the Aviv Group. The site runs Cloudflare bot protection. Piloterr handles the bypass and returns paginated property listings with live prices, DPE energy classes, GPS coordinates, room counts, and agency data as structured JSON.

## Quickstart

```
GET https://api.piloterr.com/v2/bienici/search?location=paris&ad_type=buy
```

## Main use cases

- Build a French property price index by arrondissement, tracking live price-per-m² from Bien'ici for sale and rental markets
- Filter listings by DPE class to surface energy-efficient properties for buyers or green mortgage qualification
- Populate a map-based search interface with live, geo-tagged Bien'ici listings across France
- Feed buyer alert emails with new listings published in the last 24 hours across target departments
- Track new-build programme listings by promoter to monitor developer pricing and activity in target cities