# France Pool-Ready Plots · Builders by City (`corent1robert/france-pool-ready-plots`) Actor

List French cadastral plots with a house, garden ≥ X m² (lot minus footprints) and no OSM swimming pool on the lot. Keep a BAN address only if the house-number point sits on the same parcel. Optional company at that number. One row per plot. Built for pool builders. Open data. No login.

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

## Pricing

from $1.29 / 1,000 verified pool-ready plots

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 Pool-Ready Plots · Builders by City

List **French cadastral plots with a house, a garden ≥ X m², and no OpenStreetMap swimming pool on the lot**. Garden = official lot area minus building footprints. You get a **house number only when it sits on the same parcel**.

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

Looking for plots that **already have a pool**? Use **[France Pools & Tennis · Cadastre Plots](https://apify.com/corent1robert/france-pool-tennis-plots)**.\
Looking for **any large garden** (including empty lots)? Use **[France Garden Plots · Landscapers by City](https://apify.com/corent1robert/france-garden-plots)**.

### Who is this for?

| You are… | Typical goal | Suggested setup |
| --- | --- | --- |
| Pool builder / liner / cover | Houses with room for a pool | City + 800 m², verified only |
| Heat-pump / outdoor kitchen | Deep lots, reachable number | 1 500 m² |
| SCI / property outreach | Holdings at the street number | Company lookup on |

This Actor does **not** say a client will buy a pool. It lists **houses with a large garden and no mapped pool**, with a reachable address.

### What it extracts

One **row per cadastral parcel** that has **at least one building**, **garden ≥ your threshold**, and **no OSM `leisure=swimming_pool`** whose center sits on the lot.

| Field | Meaning |
| --- | --- |
| `gardenM2` | PCI contenance minus PCI building plan on that lot |
| `gardenSharePct` | Garden as % of the lot |
| `hasOsmPool` | Always `false` on exported rows |
| `googleMapsUrl` / `openStreetMapUrl` | Open the plot |
| `parcelAreaM2`, `buildingFootprintM2`, `buildingCount` | Lot vs bâti (`buildingCount` ≥ 1) |
| `address` + `addressStatus` | `verified` only if the house-number point is inside the parcel |
| `parcelIdu` | Cadastre IDU |
| `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 garden at **800 m²** and max rows at 25.
3. Click **Start**.
4. Download CSV / Excel from the dataset.

### Ready-made examples

| Example | Best for |
| --- | --- |
| [Cannes pool-ready ≥ 800 m²](https://apify.com/corent1robert/france-pool-ready-plots/examples/cannes-pool-ready-800) | First run, builders |
| [Nice pool-ready ≥ 1 500 m²](https://apify.com/corent1robert/france-pool-ready-plots/examples/nice-pool-ready-1500) | Larger gardens |
| [Antibes 06400 ≥ 800 m²](https://apify.com/corent1robert/france-pool-ready-plots/examples/antibes-pool-ready-800) | Postcode territory |
| [Cannes pool-ready with SIREN](https://apify.com/corent1robert/france-pool-ready-plots/examples/cannes-pool-ready-siren) | SCI 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 garden (m²) | 800 |
| Unverified house numbers | Drop |
| Company lookup | off |
| Max rows | 25 (`0` or `null` = no cap; Free plan 20 / run) |

### Output example

```json
{
  "city": "Cannes",
  "postalCode": "06400",
  "address": "68 Avenue du Roi Albert 1er 06400 Cannes",
  "addressStatus": "verified",
  "gardenM2": 2094,
  "gardenSharePct": 83.6,
  "hasOsmPool": false,
  "buildingCount": 2,
  "parcelAreaM2": 2504,
  "parcelIdu": "06029000CK0027",
  "googleMapsUrl": "https://www.google.com/maps/search/?api=1&query=68%20Avenue%20du%20Roi%20Albert%201er%2006400%20Cannes"
}
```

### Pricing

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

| You get | Free / 1,000 |
| --- | --- |
| Verified pool-ready plot | **$1.29** |
| Verified pool-ready plot + 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)

- Garden is **PCI geometry**, not a site survey (driveways count as garden).
- “No pool” means **no OSM swimming pool** whose mapped center sits on the parcel. Private unmapped pools are not seen.
- Empty lots are **excluded** — there must be at least one PCI building centroid on the parcel.
- Start with **one city**. Loading parcels + buildings + Overpass for a whole department can hit the run timeout.
- No particulier owner names.

### Also available

**[France Pools & Tennis · Cadastre Plots](https://apify.com/corent1robert/france-pool-tennis-plots)** — lots that already have a mapped pool or tennis/padel.\
**[France Garden Plots · Landscapers by City](https://apify.com/corent1robert/france-garden-plots)** — garden ≥ X m², including empty lots.\
**[France Building Roofs · Size by City](https://apify.com/corent1robert/france-building-roofs)** — roof plan ≥ X m².\
**[France Industrial Buildings · Hangars by City](https://apify.com/corent1robert/france-industrial-buildings)** — IGN hangars.\
**[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.

## `minGardenM2` (type: `integer`):

Keep parcels whose garden is at least this. Garden = PCI **contenance** minus PCI building footprints whose centroid sits on the lot. Empty lots are excluded.

## `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 plots that look like a public place. Currently skipped if Maps quota is unavailable — rows are never silently deleted.

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

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

## Actor input object example

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

# Actor output Schema

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

Garden m², house on lot, no OSM pool, 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"
    ],
    "minGardenM2": 800,
    "unverifiedAddressPolicy": "drop",
    "enrichCompanies": false,
    "excludePublicPlaces": false,
    "maxItems": 25
};

// Run the Actor and wait for it to finish
const run = await client.actor("corent1robert/france-pool-ready-plots").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"],
    "minGardenM2": 800,
    "unverifiedAddressPolicy": "drop",
    "enrichCompanies": False,
    "excludePublicPlaces": False,
    "maxItems": 25,
}

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

```

## MCP server setup

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

```

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/LrePwqmjipTAddrJo/builds/jbTKUpwnrmK9j0vRG/openapi.json
