# Bien'ici Property Ad

## Overview

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

## Description

Fetch a Bien'ici property listing by URL and get price, surface area, DPE energy class, GES emissions rating, photos, floor plan, and agency contact 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/ad' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY'
```

## Example Response

### Apartment in Paris 8ème

```json
{
  "id": "ad-1049382756",
  "url": "https://www.bienici.com/annonce/vente/paris-8e-arrondissement-75008/appartement/ad-1049382756",
  "city": "Paris",
  "floor": 4,
  "price": 875000,
  "rooms": 3,
  "title": "Appartement 3 pièces 68 m² - Paris 8ème - Miromesnil",
  "photos": [
    "https://photos.bienici.com/ad-1049382756-photo-1-1200x900.jpg",
    "https://photos.bienici.com/ad-1049382756-photo-2-1200x900.jpg",
    "https://photos.bienici.com/ad-1049382756-photo-3-1200x900.jpg"
  ],
  "status": "active",
  "ad_type": "buy",
  "address": "Rue de la Boétie",
  "area_m2": 68,
  "toilets": 1,
  "bedrooms": 2,
  "currency": "EUR",
  "has_pool": false,
  "latitude": 48.8742,
  "bathrooms": 1,
  "dpe_class": "D",
  "ges_class": "D",
  "longitude": 2.3103,
  "agency_url": "https://www.bienici.com/agence/barnes-paris-8",
  "department": "75",
  "has_cellar": true,
  "has_garden": false,
  "updated_at": "2026-05-12T08:00:00.000Z",
  "agency_name": "Barnes Paris 8",
  "description": "Situé au 4ème étage avec ascenseur, dans un immeuble haussmannien de caractère rue de la Boétie, bel appartement de 68 m² loi Carrez composé d'un double séjour lumineux avec parquet, d'une cuisine équipée séparée, de deux chambres avec placard, d'une salle de bain et d'un WC séparé. Cave incluse. Charge mensuelle : 380 €.",
  "has_balcony": false,
  "has_parking": false,
  "has_terrace": false,
  "orientation": "south",
  "postal_code": "75008",
  "agency_email": null,
  "agency_phone": "+33 1 47 XX XX XX",
  "has_elevator": true,
  "heating_type": "individual gas",
  "is_new_build": false,
  "land_area_m2": null,
  "mandate_type": "exclusive",
  "price_per_m2": 12868,
  "published_at": "2026-05-06T10:30:00.000Z",
  "total_floors": 6,
  "dpe_value_kwh": 218,
  "property_type": "flat",
  "arrondissement": "8ème Arrondissement",
  "co_exclusivity": false,
  "floor_plan_url": "https://photos.bienici.com/ad-1049382756-plan.jpg",
  "agency_fees_pct": 4.2,
  "ges_value_kgco2": 47,
  "virtual_tour_url": null,
  "price_includes_fees": true
}
```

## Documentation

## Overview

Bien'ici listing pages contain the most complete French property dataset available publicly: Carrez surface area, DPE class and consumption value, GES emissions, agency fee percentage, mandate type, and floor plan. The site runs Cloudflare. Piloterr handles the bypass and returns the full structured record for any listing URL.

## Quickstart

```
GET https://api.piloterr.com/v2/bienici/ad?url=https://www.bienici.com/annonce/vente/paris-8e-arrondissement-75008/appartement/ad-1049382756
```

## Main use cases

- Enrich buyer CRM records with full Bien'ici property data, including DPE class and agency fees, at the moment of buyer interest
- Aggregate DPE consumption values across a department to model energy performance vs. price per m²
- Monitor mandate type changes to detect seller motivation signals in target neighbourhoods
- Build a property comparison tool with full specs, floor plan, and agency contact for shortlisted listings in real time
- Collect GES emissions data across French cities for institutional portfolio carbon exposure analysis