French address geocoding on the official Base Adresse Nationale (api-adresse.dat
French address geocoding on the official Base Adresse Nationale (api-adresse.data.gouv.fr, Etalab/IGN, continuously updated). Forward: ?q=8 boulevard du port amiens with optional &type=housenumber|street|locality|municipality &citycode=80021 (INSEE filter). Reverse: ?lat=49.897&lon=2.290. &limit=1-10 (default 3). Each match returns normalized label, confidence score, lat/lon, street, postcode, city, INSEE citycode and context. No match returns 400 (not billed). Cached 24h.
Paid test badge: not yet. The checks above are free: we call the tool without paying and read the payment request it sends back. The Verified badge needs paid calls whose answers match the promised output, and nobody can buy a badge.
Endpoint
GET https://data.greeneris.io/v1/fr/geocode
| Category | Everything else |
|---|---|
| Provider host | data.greeneris.io |
| Networks | eip155:8453 |
| Payment schemes | exact |
| Self-reported calls, 30 days | 1 from 1 payers (the provider's figure, not ours) |
Our checks, last 30 days
| Day | Result | HTTP | Asked | Time |
|---|---|---|---|---|
| 2026-09-24 | valid payment request | 402 | $0.001 | 896 ms |
Example input (from the provider)
{
"method": "GET",
"queryParams": {
"limit": 1,
"q": "8 boulevard du port amiens"
},
"type": "http"
}
Promised output schema (from the provider)
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"input": {
"additionalProperties": false,
"properties": {
"method": {
"enum": [
"GET",
"HEAD",
"DELETE"
],
"type": "string"
},
"queryParams": {
"properties": {
"citycode": {
"description": "Filter by 5-char INSEE city code",
"type": "string"
},
"lat": {
"description": "Latitude (reverse mode, with lon)",
"type": "number"
},
"limit": {
"description": "Max matches, 1-10 (default 3)",
"type": "integer"
},
"lon": {
"description": "Longitude (reverse mode, with lat)",
"type": "number"
},
"q": {
"description": "Free-text French address (forward mode)",
"type": "string"
},
"type": {
"description": "Restrict match type",
"enum": [
"housenumber",
"street",
"locality",
"municipality"
],
"type": "string"
}
},
"type": "object"
},
"type": {
"const": "http",
"type": "string"
}
},
"required": [
"type",
"method"
],
"type": "object"
},
"output": {
"properties": {
"example": {
"type": "object"
},
"type": {
"type": "string"
}
},
"required": [
"type"
],
"type": "object"
}
},
"required": [
"input"
],
"type": "object"
}