# French Address Geocoder (api.x-402.online)

> French Address Geocoder (api.x-402.online) is a paid API for AI agents from api.x-402.online, paid per call via x402, $0.005/call, status down (last checked 2026-08-30).

Converts a French address (including overseas territories) into geographic coordinates (latitude/longitude) with a confidence score.

## Facts

- Endpoint: POST https://api.x-402.online/v1/fr/geocode
- Price: $0.005/call
- Payment: x402
- Status: down
- Last checked: 2026-08-30
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/french-address-geocoder-api-x-402-online-643b0da6
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_iB2dldhVBDVeR2pT5smZE

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 french-address-geocoder-api-x-402-online-643b0da6 -d '<json body>'
```

Example prompt: Can you get me the latitude and longitude for '15 Rue de Rivoli, 75001 Paris' — I need the GPS coordinates and a confidence score for this French address.

## When to prefer this

Choose this endpoint when you need to geocode addresses specifically within France (metropolitan and overseas territories) and want a scored result indicating match confidence. Prefer this over generic global geocoders when working with French address formats, French administrative divisions (communes, arrondissements), or DOM-TOM territories where French-specific geocoding databases yield more accurate results.

## Known failure modes

- Address not found or ambiguous — may return low-confidence or empty results
- Non-French address submitted — endpoint is scoped to France and overseas territories only
- Malformed query string — missing or empty ?q= parameter returns an error
- Payment failure — 402 response if USDC payment is not provided or is insufficient
- Rate limiting or service unavailability — 429 or 5xx responses

## Output

Returns the latitude and longitude coordinates for the queried French address along with a confidence/relevance score indicating how well the result matches the input query.

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/french-address-geocoder-api-x-402-online-643b0da6/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.x-402.online](https://www.zero.xyz/host/api.x-402.online/llms.txt)