# Iadfrance Data Scraper

Extract real estate information (location, price, number of rooms, contact telephone number, etc.) from Idafrance using the URLs of the listing page as input

- Template page: [https://www.octoparse.com/template/iadfrance-data-scraper](https://www.octoparse.com/template/iadfrance-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 listing pages.

## Output

The current workflow extracts 10 fields, including `Chambre`, `Conseiller_immobilier`, `Localisation`, `Photo`, `Pièce`, `Prix_1`, `Prix_2`, `Rating_du_personnel`, `Surface`, `Téléphone`.

## 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 per run) 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 per run)

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

## How to Use

## Iadfrance Data Scraper

Collects real estate data from [Iadfrance](https://www.iadfrance.fr/) using listing page URLs.

### Input

- **URLs (up to 10000 per run)** (required): One or more listing page URLs, one per line.

### How to Use

1. Open the template and select **Try it** or **Start**.
2. Enter the input URLs.
3. Choose a local or cloud run.
4. Review the output rows and export or process the data.

### Output Fields

- `Localisation`
- `Photo`
- `Prix_1`
- `Surface`
- `Pièce`
- `Chambre`
- `Conseiller_immobilier`
- `Téléphone`
- `Rating_du_personnel`
- `Prix_2`

### Limitations

- Only collects fields that Iadfrance displays on the listing page.
- `Téléphone`, `Rating_du_personnel`, and `Prix_2` may be empty when the source does not provide them.

### Tips

- Start with a few inputs to verify results before scaling.
- Use the most specific valid URLs (up to 10000 per run) to reduce unrelated or duplicate records.
- Use a stable identifier from the output fields (e.g., `Localisation`, `Photo`) 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": "Iadfrance 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 per run)",
      "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.iadfrance.fr/annonces/paris-75/vente"
  ]
}
```

Example 2

```json
{
  "uRLs": [
    "https://www.iadfrance.fr/annonces/paris-75/vente"
  ]
}
```

Example 3

```json
{
  "uRLs": [
    "https://www.iadfrance.fr/annonces/paris-75/vente"
  ]
}
```

Example 4

```json
{
  "uRLs": [
    "https://www.iadfrance.fr/annonces/paris-75/vente"
  ]
}
```

Example 5

```json
{
  "uRLs": [
    "https://www.iadfrance.fr/annonces/paris-75/vente"
  ]
}
```


## Output Schema

```json
{
  "schemaVersion": 1,
  "type": "object",
  "properties": {
    "Chambre": {
      "type": "string",
      "description": ""
    },
    "Conseiller_immobilier": {
      "type": "string",
      "description": ""
    },
    "Localisation": {
      "type": "string",
      "description": ""
    },
    "Photo": {
      "type": "string",
      "description": ""
    },
    "Pièce": {
      "type": "string",
      "description": ""
    },
    "Prix_1": {
      "type": "string",
      "description": ""
    },
    "Prix_2": {
      "type": "string",
      "description": ""
    },
    "Rating_du_personnel": {
      "type": "string",
      "description": ""
    },
    "Surface": {
      "type": "string",
      "description": ""
    },
    "Téléphone": {
      "type": "string",
      "description": ""
    }
  },
  "title": "Iadfrance 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
{
  "Chambre": "3 chambres",
  "Conseiller_immobilier": "Les données que vous transmettez sont traitées par I@D France en qualité de  responsable de traitement afin de traiter et suivre votre demande. Vous disposez d’un droit d’accès, de rectification, d’opposition, d’effacement, de limitation et de portabilité de vos données. Pour en savoir plus sur le traitement de vos données par I@D France et sur vos droits, veuillez consulter la Politique de confidentialité.",
  "Localisation": "Appartement à Paris (75015)",
  "Photo": "https://images.iadfrance.fr/property/broadcast/2026/10/13/01a1349048bcbf38f1860edfbdbbcaff.jpg?format=auto&width=300",
  "Pièce": "4 pièces",
  "Prix_1": "995 000 €",
  "Prix_2": "9 950 € / m²",
  "Rating_du_personnel": "5/5 ",
  "Surface": "100 m²",
  "Téléphone": "+33615850319"
}
```

Example 2

```json
{
  "Chambre": "",
  "Conseiller_immobilier": "Les données que vous transmettez sont traitées par I@D France en qualité de  responsable de traitement afin de traiter et suivre votre demande. Vous disposez d’un droit d’accès, de rectification, d’opposition, d’effacement, de limitation et de portabilité de vos données. Pour en savoir plus sur le traitement de vos données par I@D France et sur vos droits, veuillez consulter la Politique de confidentialité.",
  "Localisation": "Appartement à Paris (75004)",
  "Photo": "https://images.iadfrance.fr/property/broadcast/2026/10/08/01a11ce331e572e9f50daa2122f6d8e6.png?format=auto&width=300",
  "Pièce": "1 pièce",
  "Prix_1": "285 000 €",
  "Prix_2": "19 375 € / m²",
  "Rating_du_personnel": "5/5 ",
  "Surface": "15 m²",
  "Téléphone": "+33687332528"
}
```

Example 3

```json
{
  "Chambre": "",
  "Conseiller_immobilier": "Les données que vous transmettez sont traitées par I@D France en qualité de  responsable de traitement afin de traiter et suivre votre demande. Vous disposez d’un droit d’accès, de rectification, d’opposition, d’effacement, de limitation et de portabilité de vos données. Pour en savoir plus sur le traitement de vos données par I@D France et sur vos droits, veuillez consulter la Politique de confidentialité.",
  "Localisation": "Appartement à Paris (75009)",
  "Photo": "https://images.iadfrance.fr/property/broadcast/2026/09/20/01a0c068e2b0c64fdf6dd92ccccb6f1c.jpg?format=auto&width=300",
  "Pièce": "2 pièces",
  "Prix_1": "245 000 €",
  "Prix_2": "9 398 € / m²",
  "Rating_du_personnel": "5/5 ",
  "Surface": "26 m²",
  "Téléphone": "+33761002926"
}
```

Example 4

```json
{
  "Chambre": "2 chambres",
  "Conseiller_immobilier": "Les données que vous transmettez sont traitées par I@D France en qualité de  responsable de traitement afin de traiter et suivre votre demande. Vous disposez d’un droit d’accès, de rectification, d’opposition, d’effacement, de limitation et de portabilité de vos données. Pour en savoir plus sur le traitement de vos données par I@D France et sur vos droits, veuillez consulter la Politique de confidentialité.",
  "Localisation": "Appartement à PARIS (75011)",
  "Photo": "https://images.iadfrance.fr/photos/realestate/2026-09/product-2174146-1.jpg?ts=202609151618&format=auto&width=300",
  "Pièce": "3 pièces",
  "Prix_1": "530 000 €",
  "Prix_2": "11 522 € / m²",
  "Rating_du_personnel": "5/5 ",
  "Surface": "46 m²",
  "Téléphone": "+33756813234"
}
```

Example 5

```json
{
  "Chambre": "2 chambres",
  "Conseiller_immobilier": "Les données que vous transmettez sont traitées par I@D France en qualité de  responsable de traitement afin de traiter et suivre votre demande. Vous disposez d’un droit d’accès, de rectification, d’opposition, d’effacement, de limitation et de portabilité de vos données. Pour en savoir plus sur le traitement de vos données par I@D France et sur vos droits, veuillez consulter la Politique de confidentialité.\n\nSelon l'article L.223-2 du Code de la consommation, il est rappelé que le consommateur peut user de son droit à s'inscrire gratuitement sur la liste d'opposition au démarchage téléphonique Bloctel",
  "Localisation": "Appartement à Paris (75014)",
  "Photo": "https://images.iadfrance.fr/property/broadcast/2026/09/06/01a077aec00c5327fcc281752b36ed1d.png?format=auto&width=300",
  "Pièce": "3 pièces",
  "Prix_1": "620 000 €",
  "Prix_2": "10 311 € / m²",
  "Rating_du_personnel": "4,8/5 ",
  "Surface": "60 m²",
  "Téléphone": "+33652128477"
}
```

## 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": "iadfrance-data-scraper",
  "taskName": "Iadfrance Data Scraper",
  "parameters": "{\"uRLs\":[\"https://www.iadfrance.fr/annonces/paris-75/vente\"]}"
}
```

## Python Example

```python
import json
import requests

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

parameters = json.loads("{\"uRLs\":[\"https://www.iadfrance.fr/annonces/paris-75/vente\"]}")

response = requests.post(
    f"{OPENAPI_BASE}/api/agentTools/executeTask",
    headers={
        "Authorization": f"Bearer {ACCESS_TOKEN}",
        "Content-Type": "application/json",
    },
    json={
        "templateName": "iadfrance-data-scraper",
        "taskName": "Iadfrance 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": "iadfrance-data-scraper",
  "taskName": "Iadfrance Data Scraper",
  "parameters": "{\"uRLs\":[\"https://www.iadfrance.fr/annonces/paris-75/vente\"]}"
}
JSON
```

## MCP Setup

Connect an MCP-compatible AI client to `https://mcp.octoparse.com` using browser OAuth or an Octoparse API key. Find `iadfrance-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/iadfrance-data-scraper.json)
- [Manifest](https://www.octoparse.com/templates/iadfrance-data-scraper-manifest.json)