# Bien'ici Data Scraper

Extract real estates information (price, room, description, etc.) from Bien'ici using URLs as input.

- Template page: [https://www.octoparse.com/template/bien-ici-data-scraper](https://www.octoparse.com/template/bien-ici-data-scraper)
- Categories: Real Estate
- Status: `PUBLISHED`
- Run mode: `BOTH`

## Pricing

Free.

## What is an Octoparse template?

An Octoparse template is a ready-to-use scraping workflow with predefined inputs and structured outputs. Use the exact parameter keys below; do not invent parameters.

## Overview

This ready-to-use template collects structured data from detail pages.

## Output

The current workflow extracts 13 fields, including `Adresse_agence`, `Agence`, `Description`, `Etiquette`, `Info_prix`, `Localisation`, `Note_agence`, `Note_prix`, `Page_URL`, `Photo_URL`, `Prix`, `Titre`, `URL_original`.

## Use Cases

- Use structured results for research, comparison, and monitoring.
- Collect rows without building the extraction workflow from scratch.
- Combine results with other templates for downstream enrichment.
- Review a representative result before starting a large batch.

## Why Octoparse

- **No coding required:** complete URLs (up to 10000) and start the template in local or cloud mode.
- **Flexible export:** review and export results as CSV, Excel, or JSON.

## Input

### URLs (up to 10000)

Required. URLs Constraints: minItems=1; maxItems=10000.

## How to Use

# Bien'ici Data Scraper

## Input
- **URLs (up to 10000)** (required) – Enter one or more Bien'ici listing or search result URLs, one per line.

## Output
The template returns structured data including: title, location, price, price note, description, photo URL, agency name and address, and original page URL. Fields may be empty if the source does not provide them.

## How to Use
1. Open the template and select **Try it** or **Start**.
2. Enter the URLs in the input field.
3. Choose a local or cloud run.
4. Review the returned rows and export the data.

## Limitations
- Collects only data displayed on the listing page; no deeper detail-page data.
- Some fields (e.g. `adresse_agence`, `note_agence`) can be empty.

## Tips
- Start with a few inputs to verify the results before scaling.
- Use the most specific valid URLs to reduce unrelated or duplicate records.
- Use `urL_original`, `titre`, or `localisation` as a deduplication key when available.

## Limitations

Results depend on what the source site exposes at run time. Fields may be empty when a source page does not provide a value. The template enforces the input limits shown above.

## Tips

Use specific, valid inputs and review a representative result before starting a large batch. Remove duplicate inputs when repeated records are not needed.

## FAQ

### What do I need to enter?

Use the exact inputs and limits listed above.

### What data does this template return?

See Output Schema below; availability can vary by source record.

### How is usage billed?

See the Pricing section above for current pricing and billing details.

## Related Templates

- [Leboncoin Data Scraper](https://www.octoparse.com/template/leboncoin-data-scraper)
- [North Data Scraper](https://www.octoparse.com/template/north-data-scraper)
- [Kompass Data Scraper](https://www.octoparse.com/template/kompass-scraper)
- [Vinted Data Scraper (by keywords)](https://www.octoparse.com/template/vinted-data-scraper)
- [Pap.fr Immobilier Data Scraper](https://www.octoparse.com/template/pap-scraper)

## Input Schema

```json
{
  "title": "Bien'ici Data Scraper input",
  "description": "Input parameters configured for the current published template version.",
  "type": "object",
  "schemaVersion": 1,
  "additionalProperties": false,
  "properties": {
    "uRLs": {
      "title": "URLs (up to 10000)",
      "description": "URLs",
      "type": "array",
      "items": {
        "type": "string"
      },
      "minItems": 1,
      "maxItems": 10000,
      "x-octoparse": {
        "apiEnabled": true
      }
    }
  },
  "required": [
    "uRLs"
  ]
}
```

## Input JSON Example

Example 1

```json
{
  "uRLs": [
    "https://www.bienici.com/recherche/location/france/2-pieces-et-plus"
  ]
}
```

Example 2

```json
{
  "uRLs": [
    "https://www.bienici.com/recherche/location/france/2-pieces-et-plus"
  ]
}
```

Example 3

```json
{
  "uRLs": [
    "https://www.bienici.com/recherche/location/france/2-pieces-et-plus"
  ]
}
```

Example 4

```json
{
  "uRLs": [
    "https://www.bienici.com/recherche/location/france/2-pieces-et-plus"
  ]
}
```

Example 5

```json
{
  "uRLs": [
    "https://www.bienici.com/recherche/location/france/2-pieces-et-plus"
  ]
}
```


## Output Schema

```json
{
  "schemaVersion": 1,
  "type": "object",
  "properties": {
    "Adresse_agence": {
      "type": "string",
      "description": ""
    },
    "Agence": {
      "type": "string",
      "description": ""
    },
    "Description": {
      "type": "string",
      "description": ""
    },
    "Etiquette": {
      "type": "string",
      "description": ""
    },
    "Info_prix": {
      "type": "string",
      "description": ""
    },
    "Localisation": {
      "type": "string",
      "description": ""
    },
    "Note_agence": {
      "type": "string",
      "description": ""
    },
    "Note_prix": {
      "type": "string",
      "description": ""
    },
    "Page_URL": {
      "type": "string",
      "description": ""
    },
    "Photo_URL": {
      "type": "string",
      "description": ""
    },
    "Prix": {
      "type": "string",
      "description": ""
    },
    "Titre": {
      "type": "string",
      "description": ""
    },
    "URL_original": {
      "type": "string",
      "description": ""
    }
  },
  "title": "Bien'ici Data Scraper output",
  "description": "Initial output fields derived from the current published implementation. Field descriptions are maintained by Data Center; production field names and types should be refreshed from recent successful runs.",
  "additionalProperties": false
}
```

## Output Example

Example 1

```json
{
  "Adresse_agence": "52 bis boulevard de la République - 92250 La Garenne-Colombes",
  "Agence": "BRACKE IMMOBILIER - La Garenne",
  "Description": "Appartement Colombes 5 pièces, 4 chambres 110 m2.\n- PAS DE COLOCATION -\nCOLOMBES rue Youri Gagarine, au sein d'une magnifique résidence de standing de 2023,\nSPECTACULAIRE DUPLEX 4 CHAMBRES, 4 TERRASSES, loué meublé.\nSitué au 3ème et 4ème étage, ce bien comprend :\n- entrée avec placard\n- vaste pièce de vie 45 m2 env. avec salon et salle à manger hauteur cathédrale, superbe cuisine us haut de gamme ouvrant sur une terrasse de 25 m2 env.. Une 2ème terrasse de 7,80 m2 est accessible depuis le salon.\n- 2 chambres équipées de nombreux rangements,\n- salle de bains avec lave-linge,\n- WC indépendant.\nA l'étage supérieur:\n- 2 chambres avec placards et chacune sa terrasse,\n- salle de bains avec WC.\nLe chauffage et l'eau chaude sont collectifs (inclus dans les charges).\n2 PARKINGS (dont un avec borne pour recharge de véhicule électrique) en sous-sol.\nCalme, lumineux, très beaux volumes et extérieurs. Copropriété d'excellent standing.\nIdéalement situé à 10 minutes à pied du Monoprix et des commerces de la rue Saint Denis, sectorisation scolaire maternelle et élémentaire Ambroise Paré (à 4 min à pied).\nTransports : Bus 164 (Porte de Champerret) et 167 (Pont de Levallois) à 4 min à pied, Gare SNCF de Colombes (ligne J) à 18 min à pied et TramT2 (Parc Pierre Lagravère) à 20 min. Proche A86.\nHonoraires à charge locataire :\nSi bail loi 89 : 1650 € TTC\nSi bail civil (société) : 2400 € TTC",
  "Etiquette": "360°",
  "Info_prix": "Dont 225 € par mois de provisions sur charges - régularisation annuelle",
  "Localisation": "92700 Colombes (Europe)",
  "Note_agence": "4,9/5",
  "Note_prix": "par mois charges comprises",
  "Page_URL": "https://www.bienici.com/annonce/location/colombes/appartement/5pieces/immo-facile-61636353?q=%2Frecherche%2Flocation%2Ffrance%2F2-pieces-et-plus%3Fcamera%3D18_-0.604228_44.796406",
  "Photo_URL": "https://www.bienici.com/cacheForever/b6fe28d42ad80abc05ebfd77bc4a1724b906975d/images/360_old.jpg",
  "Prix": "2 300 €",
  "Titre": "Location appartement meublé 5 pièces 110 m²\n92700 Colombes (Europe)",
  "URL_original": "https://www.bienici.com/recherche/location/france/2-pieces-et-plus"
}
```

Example 2

```json
{
  "Adresse_agence": "107 rue Servient - 69442 Lyon 3e Arrondissement",
  "Agence": "Citya Vendôme Lumière",
  "Description": "À LOUER // APPARTEMENT NEUF // 26 CHEMIN DES VERRIERES 69260 CHARBONNIERES LES BAINS\n\nCitya Vendôme Lumière vous propose à a location ce T2 meublé de standing dans une résidence neuve. D'une superficie de 42 m², cet appartement est parfait pour un couple ou une personne seule à la recherche de confort et de praticité. \n\nL'appartement est entièrement meublé et dispose d'une cuisine aménagée et équipée, vous permettant de vous installer sans tracas. Le salon lumineux et accueillant est un lieu de vie agréable, tandis que la chambre offre un espace intime pour se reposer. Vous trouverez également une salle de bain fonctionnelle, répondant à tous vos besoins quotidiens.\n\nUn grand balcon vient compléter ce bien, vous offrant un espace extérieur pour profiter des journées ensoleillées ou des soirées tranquilles. De plus, un garage est inclus, garantissant un stationnement sécurisé pour votre véhicule.\n\nLe chauffage est individuel et fonctionne au gaz, vous assurant un confort thermique optimal tout au long de l'année. Situé dans un environnement calme, cet appartement ne fait pas partie d'une résidence, ce qui vous garantit une certaine tranquillité.\n\nÀ proximité, vous trouverez de nombreux commerces, notamment un supermarché à moins de 2500 mètres, ainsi que plusieurs boulangeries et pharmacies à moins de 1000 mètres. Les établissements scolaires sont également à proximité, avec des écoles accessibles en moins de 1500 mètres, ce qui est idéal pour les familles.\n\nEnfin, pour les étudiants ou les professionnels, plusieurs universités se situent à moins de 5500 mètres, facilitant ainsi les déplacements. Ce bien est une opportunité à ne pas manquer pour ceux qui recherchent un cadre de vie agréable et pratique. \n Loyer de 1 030,00 euros par mois charges comprises dont 80,00 euros par mois de provision pour charges (soumis à la régularisation annuelle). \n Soit avec Assurance Habitation et Assistance* ( 21.00 euros ) : 1 051,00 euros. \n Les honoraires charge locataire sont de 564,03 euros ( soit 13,12 euros/m² ) dont 130,26 euros pour état des lieux ( soit 3,03 euros/m² ). \n Vous pouvez consulter les barèmes d'honoraires à l'adresse suivante : \n Voir les barèmes des honoraires  \nMontant estimé des dépenses annuelles d'énergie pour un usage standard : entre 399 et 540 euros. Les informations sur les risques auxquels ce bien est exposé sont disponibles sur le site Géorisques : https://www.georisques.gouv.fr.  *Service facultatif. Contribution annuelle \"attentats\" non comprise. Voir conditions en agence.",
  "Etiquette": "VIDÉO",
  "Info_prix": "Dont 80 € par mois de charges",
  "Localisation": "69260 Charbonnières-les-Bains",
  "Note_agence": "4,1/5",
  "Note_prix": "par mois charges comprises",
  "Page_URL": "https://www.bienici.com/annonce/location/charbonnieres-les-bains/appartement/2pieces/citya-immobilier-5041-GES03860006-184?q=%2Frecherche%2Flocation%2Ffrance%2F2-pieces-et-plus%3Fpage%3D2",
  "Photo_URL": "https://player.previsite.net/poster/C7197C38-4886-4887-BE38-D9C381FB6F91.jpg",
  "Prix": "1 030 €",
  "Titre": "Location appartement meublé 2 pièces 43 m²\n69260 Charbonnières-les-Bains",
  "URL_original": "https://www.bienici.com/recherche/location/france/2-pieces-et-plus"
}
```

Example 3

```json
{
  "Adresse_agence": "20 rue Honoré Euzet - 34200 Sète",
  "Agence": "Citya Cadre Royal ",
  "Description": "À LOUER : Appartement T3 situé à Sète. Ce bien immobilier offre une superficie de 67 m², un espace confortable.\nL'appartement se compose de trois pièces. Vous y trouverez un séjour lumineux, deux chambres, avec suffisamment d'espace pour accueillir des meubles et des rangements. Salle bains avec sèche serviette. WC séparé.\nEmplacement de stationnement prévue avec l'appartement : un parking en sous-sol.\nL'appartement est situé dans un environnement calme, tout en restant à proximité des commodités essentielles. Vous pourrez facilement accéder aux commerces, écoles et transports en commun, facilitant ainsi votre quotidien.\nIl est à noter que cet appartement n'est pas meublé.\nCe bien est idéal pour ceux qui recherchent un logement fonctionnel et agréable à vivre, dans une ville dynamique et ensoleillée comme Sète. N'hésitez pas à nous contacter pour plus d'informations.  Le bien est soumis au statut de la copropriété. \n\n Loyer de 935,00 euros par mois charges comprises dont 85,00 euros par mois de provision pour charges (soumis à la régularisation annuelle). \n Soit avec Assurance Habitation et Assistance* ( 24.00 euros ) : 959,00 euros. \n Les honoraires charge locataire sont de 873,21 euros ( soit 13,00 euros/m² ) dont 201,51 euros pour état des lieux ( soit 3,00 euros/m² ). \n Vous pouvez consulter les barèmes d'honoraires à l'adresse suivante : \n Voir les barèmes des honoraires  \nMontant estimé des dépenses annuelles d'énergie pour un usage standard : entre 593 et 803 euros. Prix moyens des énergies indexés en 2021. Les informations sur les risques auxquels ce bien est exposé sont disponibles sur le site Géorisques : https://www.georisques.gouv.fr.  *Service facultatif. Contribution annuelle \"attentats\" non comprise. Voir conditions en agence.",
  "Etiquette": "UNIQUEMENT SUR BIEN’ICI*",
  "Info_prix": "Dont 85 € par mois de charges",
  "Localisation": "34200 Sète (Centre-ville)",
  "Note_agence": "3,9/5",
  "Note_prix": "par mois charges comprises",
  "Page_URL": "https://www.bienici.com/annonce/location/sete/appartement/3pieces/citya-immobilier-52447284200076-GES00720006-506?q=%2Frecherche%2Flocation%2Ffrance%2F2-pieces-et-plus",
  "Photo_URL": "https://file.bienici.com/photo/citya-immobilier-52447284200076-GES00720006-506_box.ics.fr_cit_CITYA_URBANIASETE_tic_location_photo_filigrane-image00016-6299072132767506017.jpg?width=600&height=370&fit=cover",
  "Prix": "935 €",
  "Titre": "Location appartement 3 pièces 67 m²\n34200 Sète (Centre-ville)",
  "URL_original": "https://www.bienici.com/recherche/location/france/2-pieces-et-plus"
}
```

Example 4

```json
{
  "Adresse_agence": "47 RUE DE LA MONTAT - 42100 SAINT-ÉTIENNE",
  "Agence": "IMMO DE FRANCE SAINT ETIENNE ",
  "Description": "F2 PROCHE CENTRE VILLE.\nSAINT-ETIENNE - TARDY - 6 RUE EMILE LITTRE -\nDécouvrez ce superbe appartement de type F2, vaste et Lumineux de 67.85 m² avec Multiples Balcons, idéalement conçu pour allier confort, espace et clarté. Situé au 4ème étage sans ascenseur, il bénéficie d'une magnifique luminosité naturelle et d'un environnement aéré qui récompensent largement la montée des marches. Dès le hall d'entrée, vous serez séduit par la distribution fluide et logique des pièces. L'espace de vie vous invite à la détente avec un séjour accueillant s'ouvrant directement sur un premier balcon. La cuisine, séparée et spacieuse, possède également son propre accès à un second balcon, idéal pour vos petits-déjeuners en plein air. L'espace nuit est un véritable atout pour ce bien. Il se compose d'une grande chambre lumineuse dotée, elle aussi, de son propre balcon privatif. Cette pièce est enrichie d'une charmante alcôve attenante, un espace bonus parfait pour aménager un bureau en télétravail, un grand dressing sur mesure ou un coin lecture cocooning. Une salle d'eau fonctionnelle équipée d'une douche ainsi que des toilettes séparées viennent parfaire l'agencement intérieur.\nCôté praticité et confort au quotidien, l'accès à l'immeuble est sécurisé par un interphone. Le système de chauffage et de production d'eau chaude est individuel au gaz, vous garantissant ainsi une autonomie et une maîtrise totale de votre consommation énergétique.\n\nLes informations sur les risques auxquels ce bien est exposé sont disponibles sur le site Géorisques : www.georisques.gouv.fr.",
  "Etiquette": "360°",
  "Info_prix": "Dont 21 € par mois de provisions sur charges - régularisation annuelle",
  "Localisation": "42100 Saint-Étienne (Tardy - Colline des Pères - Bizillon)",
  "Note_agence": "",
  "Note_prix": "par mois charges comprises",
  "Page_URL": "https://www.bienici.com/annonce/location/saint-etienne/appartement/2pieces/ag420359-542949593?q=%2Frecherche%2Flocation%2Ffrance%2F2-pieces-et-plus",
  "Photo_URL": "https://www.bienici.com/cacheForever/b6fe28d42ad80abc05ebfd77bc4a1724b906975d/images/360_old.jpg",
  "Prix": "537 €",
  "Titre": "Location appartement 2 pièces 67 m²\n42100 Saint-Étienne (Tardy - Colline des Pères - Bizillon)",
  "URL_original": "https://www.bienici.com/recherche/location/france/2-pieces-et-plus"
}
```

Example 5

```json
{
  "Adresse_agence": "2 Place Des Nymphes - 78180 Montigny-le-Bretonneux",
  "Agence": "NESTENN Montigny-le-Bretonneux",
  "Description": "A LOUER : Noisy le Roi, Hameau du Golf, maison 5 pièces en Impasse SUR 1600 m² de terrain.\nPour candidater à ce logement, merci de suivre ces étapes :\n1-Rendez-vous sur le site Nestenn\n2-Sélectionnez le bien concerné\n3- Cliquez sur « Déposer mon dossier »\n4- Visite, après étude de votre dossier\nVotre agence Nestenn vous propose en exclusivité à la location meublée une maison de charme édifiée en 1982 avec des matériaux choisis.\nEn proximité immédiate du renommé Golf de St Nom la Bretèche et à égale distance descentre ville de Noisy le Roi et St Nom la Bretèche.\nLa propriété comprend la maison principale qui dispose d'un séjour cathédrale triple exposition avec cheminée monumentale. La cuisine indépendante est attenante , elle donne accès à une grande cave.\nNous trouvons ensuite un cabinet de toilette avec lave main, et une suite parentale avec son dressing, sa salle de bains et sa chambre avec cheminée.\nA l'étage nous avons un dressing, une mezzanine, une salle de bains avec toilette, un bureau et une chambre.\nAttenant à la bâtisse principale nous avons une pièce de 25 m² donnant sur le jardin avec de grandes baies vitrées, un préau pour les diners dans le jardin mais abrité, un double garage, une buanderie et un bûcher.\nGrand jardin clos arboré sans vis à vis.\nPortail automatique, Ballon eau chaude et tableau électrique neufs.\nUn endroit hors du temps.\nToutes proximité avec à Noisy commerces, tram, médecins , écoles....\nLes informations sur les risques auxquels ce bien est exposé sont disponibles sur le site Géorisques : www.georisques.gouv.fr",
  "Etiquette": "",
  "Info_prix": "Dont 185 € par mois de charges",
  "Localisation": "78590 Noisy-le-Roi",
  "Note_agence": "4,8/5",
  "Note_prix": "par mois charges comprises",
  "Page_URL": "https://www.bienici.com/annonce/location/noisy-le-roi/maison/5pieces/nestenn-1-99937767971?q=%2Frecherche%2Flocation%2Ffrance%2F2-pieces-et-plus%3Fcamera%3D18_1.8680514_48.8271922",
  "Photo_URL": "https://file.bienici.com/photo/nestenn-1-99937767971_media.immo-facile.com_office15_avis_20406_catalog_images_pr_web_3_7_7_6_7_9_7_1_37767971a.jpg_DATEMAJ_12_06_2026-16_45_32?width=600&height=370&fit=cover",
  "Prix": "2 685 €",
  "Titre": "Location maison 5 pièces 141 m²\n78590 Noisy-le-Roi",
  "URL_original": "https://www.bienici.com/recherche/location/france/2-pieces-et-plus"
}
```

## API

`POST https://openapi.octoparse.com/api/agentTools/executeTask`

This is the OpenAPI Agent Tools `executeTask` endpoint. Authenticate with a Bearer token.

Request body:

`templateName` is the template slug; `parameters` is a JSON object string whose keys match Input Schema; `taskName`, `idempotencyKey`, and `maxCollectedRows` are optional.

Obtain a token:

```http
POST https://openapi.octoparse.com/token
Content-Type: application/json

{
  "username": "YOUR_USERNAME",
  "password": "YOUR_PASSWORD",
  "grant_type": "password"
}
```

Use `data.access_token` as `Authorization: Bearer <token>`. After starting, poll `getTaskStatus` and export with `exportData`.

```json
{
  "templateName": "bien-ici-data-scraper",
  "taskName": "Bien'ici Data Scraper",
  "parameters": "{\"uRLs\":[\"https://www.bienici.com/recherche/location/france/2-pieces-et-plus\"]}"
}
```

## Python Example

```python
import json
import requests

OPENAPI_BASE = "https://openapi.octoparse.com"
ACCESS_TOKEN = "YOUR_ACCESS_TOKEN"

parameters = json.loads("{\"uRLs\":[\"https://www.bienici.com/recherche/location/france/2-pieces-et-plus\"]}")

response = requests.post(
    f"{OPENAPI_BASE}/api/agentTools/executeTask",
    headers={
        "Authorization": f"Bearer {ACCESS_TOKEN}",
        "Content-Type": "application/json",
    },
    json={
        "templateName": "bien-ici-data-scraper",
        "taskName": "Bien'ici Data Scraper",
        "parameters": json.dumps(parameters, ensure_ascii=False),
    },
    timeout=60,
)
print(response.status_code)
print(response.json())
```

## HTTP/cURL Example

```bash
curl -X POST "https://openapi.octoparse.com/api/agentTools/executeTask" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  --data-binary @- <<'JSON'
{
  "templateName": "bien-ici-data-scraper",
  "taskName": "Bien'ici Data Scraper",
  "parameters": "{\"uRLs\":[\"https://www.bienici.com/recherche/location/france/2-pieces-et-plus\"]}"
}
JSON
```

## MCP Setup

Connect an MCP-compatible AI client to `https://mcp.octoparse.com` using browser OAuth or an Octoparse API key. Find `bien-ici-data-scraper`, inspect its inputs, create a cloud task with the exact Input Schema keys, and export JSON results.

## Machine-readable Resources

- [Template contract](https://www.octoparse.com/templates/bien-ici-data-scraper.json)
- [Manifest](https://www.octoparse.com/templates/bien-ici-data-scraper-manifest.json)