# France Building Heights · Facades by City (`corent1robert/france-building-heights`) Actor

List French buildings taller than X metres. Snap to IGN cadastre. Keep a BAN address only if the house-number point sits on the same parcel. Optional company at that number. One row per building. Built for facade, scaffolding and insulation. Open data. No login.

- **URL**: https://apify.com/corent1robert/france-building-heights.md
- **Developed by:** [Corentin Robert](https://apify.com/corent1robert) (community)
- **Categories:** Lead generation, Real estate
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.29 / 1,000 verified tall buildings

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

## France Building Heights · Facades by City

List **French buildings taller than X metres**. You get a **house number only when it sits on the same cadastral parcel** — plus IGN height, optional floors, and optional company flags.

**No login. No API key. Address only when it sits on the same parcel.**

Looking for **roof m²**? Use **[France Building Roofs · Size by City](https://apify.com/corent1robert/france-building-roofs)**.\
Looking for **pools or tennis**? Use **[France Pools & Tennis · Cadastre Plots](https://apify.com/corent1robert/france-pool-tennis-plots)**.

### Who is this for?

| You are… | Typical goal | Suggested setup |
| --- | --- | --- |
| Facade / rendering / ITE | Mid-rise streets in a city | City + 9 m, verified only |
| Scaffolding | Buildings that need a tower | 12 m, companies off |
| Copro / syndic workflow | Holdings at the street number | Company lookup on |

This Actor does **not** say whether a facade needs work. It lists buildings **tall enough** to be a facade job, with a reachable address.

### What it extracts

One **row per building** (IGN `cleabs`) whose published **hauteur** is ≥ your threshold. Buildings with no height are skipped.

| Field | Meaning |
| --- | --- |
| `buildingHeightM` | IGN BD TOPO height (metres) |
| `buildingFloors` | Storeys when published — often empty |
| `address` + `addressStatus` | `verified` only if the house-number point is inside the parcel |
| `parcelIdu`, `parcelAreaM2` | Cadastre lot under the building |
| `roofPlanM2` / `roofLengthM` / `roofWidthM` | Plan of that building (bonus, not the filter) |
| `siren`, `companyLegalForm`, `directors` | Optional, verified addresses only |

### How to use

1. Open the Actor in [Apify Console](https://console.apify.com).
2. Enter a **city** (try **Cannes**), keep min height at **9 m** and max rows at 25.
3. Click **Start**.
4. Download CSV / Excel from the dataset.

### Ready-made examples

| Example | Best for |
| --- | --- |
| [Cannes buildings ≥ 9 m](https://apify.com/corent1robert/france-building-heights/examples/cannes-facades-9m) | First run, rendering / ITE |
| [Nice buildings ≥ 12 m](https://apify.com/corent1robert/france-building-heights/examples/nice-facades-12m) | Scaffolding |
| [Antibes 06400 ≥ 9 m](https://apify.com/corent1robert/france-building-heights/examples/antibes-facades-9m) | Postcode territory |
| [Cannes tall buildings with SIREN](https://apify.com/corent1robert/france-building-heights/examples/cannes-facades-siren) | SCI / syndic at the number |

Paste a verified `address` into **[French Property Intel](https://apify.com/corent1robert/french-property-intel-hub)** for DPE, flood/clay, value and yield — billed **per dossier**, not per cadastral row.

### Input

| Field | Default |
| --- | --- |
| City, postcode or department | Cannes |
| Minimum height (m) | 9 |
| Unverified house numbers | Drop |
| Company lookup | off |
| Max rows | 25 (`0` or `null` = no cap; Free plan 20 / run) |

### Output example

```json
{
  "buildingCleabs": "BATIMENT0000000074202033",
  "buildingHeightM": 12.4,
  "buildingFloors": 4,
  "parcelIdu": "06029000DK0111",
  "addressStatus": "verified",
  "address": "32 Corniche du Paradis 06400 Cannes",
  "mapsStatus": "off"
}
```

### Pricing

Pay-per-event (platform usage included — HTTP open data only).

| You get | Free / 1,000 |
| --- | --- |
| Verified tall building | **$1.29** |
| Verified tall building + published company | **$2.79** |
| Unverified (Flag mode) | **$0.39** |

Actor start is $0.00005 / GB. Free Apify accounts export **20 rows per run**.

### Limits (read this)

- Filter on **metres**, not storeys. `nombre_d_etages` is often empty.
- Height is IGN BD TOPO — not a laser survey on site.
- Start with **one city**. A whole department can hit the run timeout.
- No particulier owner names.

### Also available

**[France Building Roofs · Size by City](https://apify.com/corent1robert/france-building-roofs)** — roof plan ≥ X m².\
**[France Garden Plots · Landscapers by City](https://apify.com/corent1robert/france-garden-plots)** — garden ≥ X m².\
**[France Industrial Buildings · Hangars by City](https://apify.com/corent1robert/france-industrial-buildings)** — IGN hangars.\
**[France Pools & Tennis · Cadastre Plots](https://apify.com/corent1robert/france-pool-tennis-plots)** — mapped pool or tennis/padel.\
**[French Property Intel](https://apify.com/corent1robert/french-property-intel-hub)** — DPE, hazards, yield from a street address.

### Support

Questions or a custom run: **corentin@outreacher.fr**

# Actor input Schema

## `locations` (type: `array`):

French **commune name**, **postcode** (06400) or **department** (06). Start with one city — a whole department can time out.

## `minBuildingHeightM` (type: `integer`):

Keep buildings whose IGN BD TOPO **hauteur** is at least this (e.g. 9 ≈ three storeys). Set **1** to keep every building that has a published height. Buildings with no height are always skipped — IGN does not fill 100% of the stock. Do not filter on storeys — that field is often empty.

## `unverifiedAddressPolicy` (type: `string`):

**Drop** (default) keeps only addresses proven on the same parcel. **Flag** also exports neighbours / street-only hits as unverified.

## `enrichCompanies` (type: `boolean`):

When the address is verified, attach SIREN / SCI / SAS / association and published directors. Off by default.

## `excludePublicPlaces` (type: `boolean`):

Mark buildings that look like a public place. Currently skipped if Maps quota is unavailable — rows are never silently deleted.

## `maxItems` (type: `integer`):

How many buildings to export. **0 or null = no cap** (timeout still applies). Free Apify accounts: 20 per run.

## Actor input object example

```json
{
  "locations": [
    "Cannes"
  ],
  "minBuildingHeightM": 9,
  "unverifiedAddressPolicy": "drop",
  "enrichCompanies": false,
  "excludePublicPlaces": false,
  "maxItems": 25
}
```

# Actor output Schema

## `overview` (type: `string`):

Height, parcel, verified address

## `outreachCrm` (type: `string`):

Address + company + directors

## `unverifiedPlots` (type: `string`):

Rows kept when you chose Flag

## `dataset` (type: `string`):

No description

## `output` (type: `string`):

No description

## `runLog` (type: `string`):

No description

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "locations": [
        "Cannes"
    ],
    "minBuildingHeightM": 9,
    "unverifiedAddressPolicy": "drop",
    "enrichCompanies": false,
    "excludePublicPlaces": false,
    "maxItems": 25
};

// Run the Actor and wait for it to finish
const run = await client.actor("corent1robert/france-building-heights").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "locations": ["Cannes"],
    "minBuildingHeightM": 9,
    "unverifiedAddressPolicy": "drop",
    "enrichCompanies": False,
    "excludePublicPlaces": False,
    "maxItems": 25,
}

# Run the Actor and wait for it to finish
run = client.actor("corent1robert/france-building-heights").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "locations": [
    "Cannes"
  ],
  "minBuildingHeightM": 9,
  "unverifiedAddressPolicy": "drop",
  "enrichCompanies": false,
  "excludePublicPlaces": false,
  "maxItems": 25
}' |
apify call corent1robert/france-building-heights --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,corent1robert/france-building-heights"
        }
    }
}

```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/NoaqfiFQZGWLXiJj3/builds/SaDc3P7M8AhgBGKhS/openapi.json