French Address Search

How to Use This API

1. Search by City or Street

Searching for "Paris" returns matching addresses with coordinates, postcodes, and city context:

https://api-adresse.data.gouv.fr/search/?q=paris

2. Search with Full Address and Limit

Search for a specific street in Lyon with 5 results:

https://api-adresse.data.gouv.fr/search/?q=5+Rue+de+la+R%C3%A9publique+Lyon&limit=5

Parameters: q (query), limit (max results, default 5), autocomplete (0 or 1), lat/lon (prefer results near this location).

3. Reverse Geocoding — Coordinates to Address

https://api-adresse.data.gouv.fr/reverse/?lon=2.349&lat=48.853

Returns the nearest address to the given GPS coordinate.

4. JavaScript — Autocomplete Search Field

function searchAddress(query) {
  const url = `https://api-adresse.data.gouv.fr/search/` +
    `?q=${encodeURIComponent(query)}&limit=5&autocomplete=1`;
  return fetch(url).then(r => r.json());
}
searchAddress('15 rue de la paix').then(data => {
  data.features.forEach(f => {
    console.log(f.properties.label, '→',
      f.geometry.coordinates[0] + ',' + f.geometry.coordinates[1]);
  });
});

5. Python — Batch Geocode from CSV

import requests, csv

addresses = ['5 Rue de la République Lyon', '10 avenue des Champs-Élysées Paris']
for addr in addresses:
    r = requests.get('https://api-adresse.data.gouv.fr/search/', params={'q': addr, 'limit': 1})
    if r.status_code == 200 and r.json()['features']:
        coords = r.json()['features'][0]['geometry']['coordinates']
        print(f"{addr} → {coords[1]}, {coords[0]}")