# France Building Roofs · Size by City (`corent1robert/france-building-roofs`) Actor

List French buildings whose roof plan is larger than X m². 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. Open data. No login.

- **URL**: https://apify.com/corent1robert/france-building-roofs.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 large roofs

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 Roofs · Size by City

List **French buildings** whose **roof plan is larger than X m²**. You get a **house number only when it sits on the same cadastral parcel** — plus length × width, height when IGN publishes Z, and optional company flags.

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

Looking for **building height / facades**? Use **[France Building Heights · Facades by City](https://apify.com/corent1robert/france-building-heights)**.\
Looking for **pools or tennis courts** instead? Use **[France Pools & Tennis · Cadastre Plots](https://apify.com/corent1robert/france-pool-tennis-plots)**.

### Who is this for?

| You are… | Typical goal | Suggested setup |
| --- | --- | --- |
| Roofer / solar / insulation | Large roofs in a city | City + min m², verified only |
| Agency / off-market | Big footprints, not amenities | 150–200 m², companies off |
| SCI / wealth workflow | Holdings at the street number | Company lookup on |

**What you get by default:** BD TOPO building id, roof plan m², length × width, parcel IDU, verified BAN address, height when Z exists.

**When to enable company lookup:** you need SIREN / SCI / SAS / association and published directors at that number. Individual owners are **not** in open data.

### What it extracts

One **row per building** (IGN `cleabs`) whose 2D roof outline is ≥ your threshold. Several large buildings on the same parcel stay several rows.

| Field | Meaning |
| --- | --- |
| `roofPlanM2` | 2D outline of that building (m²) |
| `roofLengthM` / `roofWidthM` | Long / short side of the outline, metres |
| `buildingHeightM`, `roofRiseM`, `roofAreaM2` | Height and gable 3D m² when BD TOPO has altitudes — **not** LiDAR |
| `address` + `addressStatus` | `verified` only if the house-number point is inside the parcel |
| `parcelIdu`, `parcelAreaM2` | Cadastre lot under the building |
| `siren`, `companyLegalForm`, `directors` | Optional, verified addresses only |
| `mapsStatus` | `off`, `ok`, or `skipped_quota` |

### How to use

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

### Ready-made examples

| Example | Best for |
| --- | --- |
| [Cannes roofs ≥ 150 m²](https://apify.com/corent1robert/france-building-roofs/examples/cannes-roofs-150) | First run, solar / roofing |
| [Bordeaux roofs ≥ 200 m²](https://apify.com/corent1robert/france-building-roofs/examples/bordeaux-roofs-200) | Larger footprints |
| [Antibes 06400 roofs ≥ 120 m²](https://apify.com/corent1robert/france-building-roofs/examples/antibes-roofs-120) | Postcode territory |
| [Cannes large roofs with SIREN](https://apify.com/corent1robert/france-building-roofs/examples/cannes-roofs-siren) | SCI / directors 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 roof plan (m²) | 150 |
| Unverified house numbers | Drop |
| Company lookup | off |
| Maps public-place flag | off |
| Max rows | 25 (`0` or `null` = no cap; Free plan 20 / run) |

### Output example

```json
{
  "buildingCleabs": "BATIMENT0000000241080159",
  "roofPlanM2": 186,
  "roofLengthM": 18.4,
  "roofWidthM": 10.1,
  "buildingHeightM": 7.5,
  "roofAreaM2": 210,
  "parcelIdu": "06029000CK0027",
  "addressStatus": "verified",
  "address": "68 Avenue du Roi Albert 1er 06400 Cannes",
  "companyLegalForm": null,
  "mapsStatus": "off"
}
```

### Pricing

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

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

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

#### How much does it cost?

| Scenario | Approx. cost (Free) |
| --- | --- |
| 20 verified roofs (first try) | ~$0.03 |
| 1,000 verified roofs | ~$1.29 |
| 1,000 roofs with a SIREN | ~$2.79 |

### Limits (read this)

- Start with **one city**. A whole department paginates tens of thousands of BD TOPO buildings and can hit the run timeout.
- `roofPlanM2` is the **plan** of the outline. `roofAreaM2` is a **gable estimate** from eave/ridge when those altitudes exist — not a LiDAR mesh.
- No particulier owner names. Directors appear only for a **published company** at that number.
- Maps listing detection is skipped when platform Maps quota is exhausted (`mapsStatus: skipped_quota`).

### Is it legal to list French building roofs?

This Actor only uses **public open data** (IGN BD TOPO, IGN cadastre / PCI, BAN, optional SIRENE). It does **not** extract private individual owner names. As with any address-level dataset, make sure your use complies with GDPR and French marketing rules.

### Also available

**[France Building Heights · Facades by City](https://apify.com/corent1robert/france-building-heights)** — buildings taller than X metres (facade / scaffolding).\
**[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)** — plots with a mapped pool or tennis/padel court.\
**[French Property Intel](https://apify.com/corent1robert/french-property-intel-hub)** — DPE, hazards, yield and owner SIREN from a street address.\
**[French DPE F/G · Property Owner SIRENs](https://apify.com/corent1robert/dpe-fg-proprietaires-siren)** — SCI / foncières on class F/G dwellings.

### 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.

## `minRoofPlanM2` (type: `integer`):

Keep buildings whose **2D roof outline** is at least this many square metres (e.g. 150). Not the sloped 3D surface.

## `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"
  ],
  "minRoofPlanM2": 150,
  "unverifiedAddressPolicy": "drop",
  "enrichCompanies": false,
  "excludePublicPlaces": false,
  "maxItems": 25
}
```

# Actor output Schema

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

Roof size, 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"
    ],
    "minRoofPlanM2": 150,
    "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-roofs").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"],
    "minRoofPlanM2": 150,
    "unverifiedAddressPolicy": "drop",
    "enrichCompanies": False,
    "excludePublicPlaces": False,
    "maxItems": 25,
}

# Run the Actor and wait for it to finish
run = client.actor("corent1robert/france-building-roofs").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"
  ],
  "minRoofPlanM2": 150,
  "unverifiedAddressPolicy": "drop",
  "enrichCompanies": false,
  "excludePublicPlaces": false,
  "maxItems": 25
}' |
apify call corent1robert/france-building-roofs --silent --output-dataset

```

## MCP server setup

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

```

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/1iPBLLcQiIQ2gmaJN/builds/iA7bSWaVHsGpfZwuL/openapi.json