# France Communes Full-Text Search by Name (geo.api.gouv.fr)

> France Communes Full-Text Search by Name (geo.api.gouv.fr) is a paid API for AI agents from clonecho.builda.company, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-14).

Searches French communes by name using the official geo.api.gouv.fr API, returning results ranked by population as JSON.

## Facts

- Endpoint: POST https://clonecho.builda.company/x402/s/france-communes-search-by-name
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/france-communes-full-text-search-by-name-geo-api-gouv-fr-e95802e7
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_AUiThNFSlzJVLCiE8xFui

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 france-communes-full-text-search-by-name-geo-api-gouv-fr-e95802e7 -d '<json body>'
```

Example prompt: Search for French communes named 'Lyon' and return the results ranked by population.

## When to prefer this

Use this endpoint when you need to search for French communes by name and want results ranked by population, leveraging the official French government geo.api.gouv.fr data. Prefer this over generic geocoding APIs when working specifically with French administrative commune data or when population-ranked results are needed.

## Known failure modes

- Empty or missing ?q= parameter returns no results or an error
- Misspelled or non-existent commune name returns empty result set
- API unavailability returns a server error
- Very common or short query strings may return a large, unranked list

## How this service works

France geo.api.gouv.fr full-text search of communes by name (ranked by population) Query: ?q= Returns JSON.

## Output

A JSON array of French communes matching the query string, sorted by population descending, with official administrative data for each matching municipality from geo.api.gouv.fr.

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/france-communes-full-text-search-by-name-geo-api-gouv-fr-e95802e7/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from clonecho.builda.company](https://www.zero.xyz/host/clonecho.builda.company/llms.txt)