# Saylor Innovations France Commune Lookup

> Saylor Innovations France Commune Lookup is a paid API for AI agents from saylorinnovations.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-29).

Looks up French communes by name or postcode, returning INSEE code, population, department, region, and coordinates

## Facts

- Endpoint: GET https://saylorinnovations.com/api/france/communes?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-29
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/saylor-innovations-france-commune-lookup-e9d8033c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_RYFCh14C6LGLMOEToBVtC

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 saylor-innovations-france-commune-lookup-e9d8033c
```

Example prompt: Can you look up the commune details for 'Lyon' in France — I need the INSEE code, department, region, and coordinates?

## When to prefer this

Choose this endpoint when you need official French administrative data (INSEE codes, department/region hierarchy, population, coordinates) for a commune identified by name or postcode. It is backed by the authoritative French government geo API (geo.api.gouv.fr), making it preferable to generic geocoding services when INSEE codes or official administrative classifications are specifically required. Ideal for enriching French address data, building administrative hierarchies, or validating French locality references.

## Known failure modes

- No matching commune found for given name or postcode — empty communes array returned
- Ambiguous query matching multiple communes — multiple results returned requiring disambiguation
- Invalid or malformed postcode format — may return no results or unexpected matches
- API upstream failure from geo.api.gouv.fr — service may return error or degraded response
- Rate limiting or payment failure via x402 protocol — request rejected before reaching data source

## How this service works

French commune lookup - name or postcode to INSEE code, population, department, region and coordinates from geo.api.gouv.fr

## Output

Returns the interpreted query string, data source attribution, and an array of matching communes — each containing the commune's name, INSEE code, postal code(s), population count, department number and name, region name, and geographic coordinates (latitude/longitude).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "q"
     ],
     "properties": {
      "q": {
       "type": "string",
       "description": "French commune name or five-digit postcode"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "json"
    },
    "example": {
     "type": "object",
     "required": [
      "query",
      "communes"
     ],
     "properties": {
      "query": {
       "type": "string",
       "description": "The query as the server interpreted it"
      },
      "source": {
       "type": "string",
       "description": "Data source the values come from"
      },
      "communes": {
       "type": "array"
      },
      "matched_by": {
       "type": "string",
       "description": "Matched by"
      }
     }
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/saylor-innovations-france-commune-lookup-e9d8033c/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from saylorinnovations.com](https://www.zero.xyz/host/saylorinnovations.com/llms.txt)