greatapis

Geocoding — entry 006 of 80

adresse.data.gouv.fr

Verified Aug 2026

The Base Adresse Nationale's API Adresse geocodes and reverse-geocodes French addresses for free with no API key, backed by Etalab and IGN's data.geopf.fr infrastructure (the older api-adresse.data.gouv.fr host still answers directly and does not redirect). Requests and responses use the GeoJSON FeatureCollection format, with each result scored for match confidence and enriched with INSEE city codes, postcodes, and population. A live Origin-header probe confirms open CORS (Access-Control-Allow-Origin: *), so it works directly from browser JavaScript with no proxy.

franceaddress-geocodinggovernment-datageojsonfree
Visit adresse.data.gouv.fr ↗Read the docs ↗More Geocoding
AuthenticationNone requiredCall it straight away — no key, no signup.
HTTPSSupportedTraffic is encrypted in transit.
CORSEnabledCallable directly from browser JavaScript.
PricingFreeNo paid tier — free for the documented use case.
FormatsGeoJSONResponses can be requested as GeoJSON.

GreatAPIs Score

Score94out of 100
Authentication25/25No authentication required
Pricing20/20Free to use
Docs20/20Machine-readable spec file bundled
Formats9/15Single response format
Freshness20/20Verified within 6 months

Embed this badge

Scored 94 on greatapis.com
<a href="https://greatapis.com/api/adresse-data-gouv-fr/"><img src="https://greatapis.com/badge/adresse-data-gouv-fr.svg" alt="Scored 94 on greatapis.com"></a>

Auth quickstart

  1. No key needed — call it now.
Stored keyNo key stored

Your key is stored only in this browser (localStorage) and sent directly to the API — never to greatapis.

Endpoints

Servers
https://data.geopf.fr/geocodage
Auth
BearerAuthProjectAuth
getCapabilities1

Découverte du service

GET/getCapabilitiesDécouvrir le service
Responses
StatusDescriptionSchema
200successful operationGetcapabilities
404Not found—
search2

Géocodage direct (recherche)

GET/searchRecherche par géocodage direct
Parameters
NameInRequiredType
qquerynostring
autocompletequerynostring
indexqueryno—
limitquerynointeger
latquerynonumber
lonquerynonumber
returntruegeometryquerynoboolean
postcodequeryno—
citycodequeryno—
depcodequeryno—
typequerynostring
cityquerynostring
categoryqueryno—
departmentcodequerynostring
municipalitycodequerynostring
oldmunicipalitycodequerynostring
districtcodequerynostring
sectionquerynostring
numberquerynostring
sheetquerynostring
Responses
StatusDescriptionSchema
200successful operation—
400Parse query failed—
POST/search/csvGéocodage direct en masse d’un fichier CSV
Request body

multipart/form-data (required)

Responses
StatusDescriptionSchema
200Géocodage réussiGeocodeCsvResponse
400Échec du géocodage suite à une erreur dans la requête ou dans le fichier CSV—
reverse2

Géocodage inverse

GET/reverseRecherche par géocodage inverse
Parameters
NameInRequiredType
searchgeomquerynostring
lonquerynonumber
latquerynonumber
indexqueryno—
limitquerynointeger
returntruegeometryquerynoboolean
postcodequeryno—
citycodequeryno—
typequerynostring
cityquerynostring
categoryqueryno—
departmentcodequerynostring
municipalitycodequerynostring
oldmunicipalitycodequerynostring
districtcodequerynostring
sectionquerynostring
numberquerynostring
sheetquerynostring
Responses
StatusDescriptionSchema
200successful operation—
400Parse query failed—
POST/reverse/csvGéocodage inversé en masse d’un fichier CSV
Request body

multipart/form-data (required)

Responses
StatusDescriptionSchema
200Géocodage réussiGeocodeCsvResponse
400Échec du géocodage suite à une erreur dans la requête ou dans le fichier CSV—
batch-async10

Géocodage par lot asynchrone

POST/async/projectsCréer un nouveau projet
Parameters
NameInRequiredType
X-Communityheadernostring
Responses
StatusDescriptionSchema
201Projet créé avec succèsProject
401Authentification incorrecte—
403Droits insuffisants—
GET/async/projects/{projectId}Récupérer les informations
Parameters
NameInRequiredType
projectIdpathyesstring
Responses
StatusDescriptionSchema
200Métadonnées du projetProject
401Non autorisé—
404Projet introuvable—
DELETE/async/projects/{projectId}Supprimer un projet
Parameters
NameInRequiredType
projectIdpathyesstring
Responses
StatusDescriptionSchema
204Projet supprimé avec succès—
401Non autorisé—
403Action interdite (le projet est en cours de traitement)—
404Projet introuvable—
POST/async/projects/{projectId}/abortAnnuler un géocodage en attente ou en cours
Parameters
NameInRequiredType
projectIdpathyesstring
Responses
StatusDescriptionSchema
200Annulation prise en compteProject
401Non autorisé—
403Action interdite (le projet n'est pas en cours ou en attente)—
404Projet introuvable—
PUT/async/projects/{projectId}/input-fileUploader un fichier d'entrée pour un projet
Parameters
NameInRequiredType
projectIdpathyesstring
Content-Lengthheadernointeger
Content-Dispositionheadernostring
Request body

application/octet-stream

Responses
StatusDescriptionSchema
200Fichier d'entrée uploadé avec succèsProject
400Fichier invalide (taille excessive ou incorrecte)—
401Non autorisé—
403Action interdite (le projet est en cours de traitement ou terminé)—
404Projet introuvable—
GET/async/projects/{projectId}/input-file/{token}Télécharger le fichier source du projet
Parameters
NameInRequiredType
projectIdpathyesstring
tokenpathyesstring
Responses
StatusDescriptionSchema
200Fichier téléchargé avec succèsGeocodeCsvResponse
GET/async/projects/{projectId}/output-file/{token}Télécharger le fichier résultat du projet
Parameters
NameInRequiredType
projectIdpathyesstring
tokenpathyesstring
Responses
StatusDescriptionSchema
200Fichier téléchargé avec succès—
PUT/async/projects/{projectId}/pipelineDéfinir les paramètres du traitement
Parameters
NameInRequiredType
projectIdpathyesstring
Request body

application/json — Pipeline

Responses
StatusDescriptionSchema
200Pipeline défini avec succèsProject
400Paramètres invalides—
401Non autorisé—
403Action interdite (le projet est en cours de traitement ou terminé)—
404Projet introuvable—
POST/async/projects/{projectId}/resetRé-initialise un géocodage terminé ou en erreur
Parameters
NameInRequiredType
projectIdpathyesstring
Responses
StatusDescriptionSchema
200Ré-initialisation prise en compteProject
401Non autorisé—
403Action interdite (le projet n'est pas terminé ou en erreur)—
404Projet introuvable—
POST/async/projects/{projectId}/startDémander le démarrage du géocodage
Parameters
NameInRequiredType
projectIdpathyesstring
Responses
StatusDescriptionSchema
200Projet mis en attente de géocodageProject
401Non autorisé—
403Action interdite (le projet est en cours de traitement ou terminé ou des éléments sont manquants)—
404Projet introuvable—

Try it

Developer reference
Base URLhttps://data.geopf.fr/geocodage
Rate limit
50 requests/second per IP
Key endpoints
  • GET/search
  • GET/reverse
Availability
Uptime100%
Median latency1043 ms
Last checkUp · 400 · Sep 2026
4 checks since Aug 2026. A person runs this check by hand, not an automated monitor.
Changelog
Spec version1.0.0
Tracked paths14
  • Aug 2026gained an OpenAPI spec
Tracking since Sep 2026. See every tracked change ↗ ·Subscribe with RSS ↗
Featured in
4 collections
GeoJSON-native dataSpec-backed APIsNo key requiredCORS-ready browser APIs
People comparing adresse.data.gouv.fr also look at…
All 80 →
adresse.data.gouv.fr vs Cartes.io
Cartes.io supports 2 response formats, while adresse.data.gouv.fr offers fewer — pick Cartes.io for more integration flexibility.
Compare →
adresse.data.gouv.fr vs API Découpage Administratif (API Geo)
API Découpage Administratif (API Geo) supports 2 response formats, while adresse.data.gouv.fr offers fewer — pick API Découpage Administratif (API Geo) for more integration flexibility.
Compare →
adresse.data.gouv.fr vs GeoJS
GeoJS supports 2 response formats, while adresse.data.gouv.fr offers fewer — pick GeoJS for more integration flexibility.
Compare →
adresse.data.gouv.fr vs OpenStreetMap
OpenStreetMap supports 2 response formats, while adresse.data.gouv.fr offers fewer — pick OpenStreetMap for more integration flexibility.
Compare →
adresse.data.gouv.fr vs Ducks Unlimited
Ducks Unlimited supports 2 response formats, while adresse.data.gouv.fr offers fewer — pick Ducks Unlimited for more integration flexibility.
Compare →
adresse.data.gouv.fr vs ipapi.co
ipapi.co supports 3 response formats, while adresse.data.gouv.fr offers fewer — pick ipapi.co for more integration flexibility.
Compare →
Nominatim
Provides worldwide forward / reverse geocoding
No auth · CORS
Postcodes.io
Postcode lookup & Geolocation for the UK
No auth · CORS
Queimadas INPE
Access to heat focus data (probable wildfire)
No auth · CORS
ViaCep
Brazil RESTful zip codes API
No auth · CORS
Actinia Grass GIS
Actinia is an open source REST API for geographical data that uses GRASS GIS
Basic Auth · CORS
administrative-divisons-db
Get all administrative divisions of a country
No auth · CORS