# INSEE Commune Data Lookup

> INSEE Commune Data Lookup is a paid API for AI agents from x402-farm.vercel.app, paid per call via x402, $0.01/call, status down (last checked 2026-09-06).

Returns French commune metadata (name, INSEE code, population, population density) for a given commune identifier via the French national statistics reference.

## Facts

- Endpoint: GET https://x402-farm.vercel.app/v1/fr/insee-commune
- Price: $0.01/call
- Payment: x402
- Status: down
- Last checked: 2026-09-06
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/insee-commune-data-lookup-85921bb9
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_axq0wIMgg36phOE0tLNeA

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability insee-commune-data-lookup-85921bb9
```

Example prompt: Can you look up the official INSEE data for the French commune of Pointe-à-Pitre — I need its INSEE code, population, and population density?

## When to prefer this

Use this endpoint when you need authoritative French commune reference data including INSEE codes, population, and density without setting up an account. Ideal for agents enriching French address data, performing demographic lookups, or validating French municipality identifiers on a pay-per-call basis with no subscription required.

## Known failure modes

- Unknown or misspelled commune name returns an error or empty result
- Communes with identical names in different departments may require disambiguation
- Overseas territories and collectivities may have limited or missing data
- No query parameters documented in schema — unclear how to specify the target commune
- Rate limits or payment failures via x402 protocol result in HTTP 402 responses

## How this service works

Pay-per-call APIs for AI agents — x402 protocol, USDC on Base, no account needed.

## Output

A JSON object containing the commune's official name (nom), INSEE code (insee), total population (population), and population density in inhabitants per km² (densite_hab_km2). Example: {"nom":"Pointe-à-Pitre","insee":"97120","population":15040,"densite_hab_km2":5419}.

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "nom": "Pointe-à-Pitre",
  "insee": "97120",
  "population": 15040,
  "densite_hab_km2": 5419
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/insee-commune-data-lookup-85921bb9/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402-farm.vercel.app](https://www.zero.xyz/host/x402-farm.vercel.app/llms.txt)
