search: Search for addresses

API: gouv.fr:api-adresse
Endpoint: /search
Response format: application/geo+json
Auth: unknown
Method: GET
Last Status: 200
Latency: 416ms

Description

Returns a GeoJSON FeatureCollection of addresses matching the search query. Each result includes coordinates (lat/lon), full address label, street name, postal code, city, and a relevance score. Use this to geocode addresses (convert address text to coordinates).

From spec: Geocode an address query to get matching locations with coordinates. Returns a GeoJSON FeatureCollection.

Usage Tips

- Maximum results: 20 per request (use limit parameter) - Supports house numbers, streets, localities, and municipalities - Add type=housenumber to filter for exact addresses - Coordinates are in EPSG:4326 (WGS84) format

Parameters (8)

autocomplete (integer, query, optional, default: 1)

Enable/disable autocomplete (0=exact match, 1=autocomplete)

Constraints: {'enum': [0, 1]}

citycode (string, query, optional)

Filter by city/commune INSEE code (5 characters)

lat (number, query, optional)

Latitude for proximity bias (WGS84)

limit (integer, query, optional, default: 10)

Maximum number of results to return (1-20)

Constraints: {'minimum': 1, 'maximum': 20}

lon (number, query, optional)

Longitude for proximity bias (WGS84)

postcode (string, query, optional)

Filter by postal code (5 digits)

q (string, query, required)

Address query string to geocode (e.g., '20 avenue de Segur Paris')

type (string, query, optional)

Filter results by address type

Constraints: {'enum': ['housenumber', 'street', 'locality', 'municipality']}

Examples (2)

Search for Paris municipality probe-gate

Demonstrates basic address search returning municipality results

curl 'https://api-adresse.data.gouv.fr/search?q=Paris'
import requests

resp = requests.get(
    "https://api-adresse.data.gouv.fr/search",
    params={
        'q': 'Paris',
    },
)
data = resp.json()
import zingu_apis

api = zingu_apis.api("api-adresse")
result = api.fetch("search", q="Paris")

for item in result:
    print(item)
const resp = await fetch("https://api-adresse.data.gouv.fr/search?q=Paris");
const data = await resp.json();
Search for specific address with house number filter probe-gate

Demonstrates searching for a specific street address with type filter

curl 'https://api-adresse.data.gouv.fr/search?q=20+avenue+de+Segur&type=housenumber'
import requests

resp = requests.get(
    "https://api-adresse.data.gouv.fr/search",
    params={
        'q': '20 avenue de Segur',
        'type': 'housenumber',
    },
)
data = resp.json()
import zingu_apis

api = zingu_apis.api("api-adresse")
result = api.fetch("search", q="20 avenue de Segur", type="housenumber")

for item in result:
    print(item)
const resp = await fetch("https://api-adresse.data.gouv.fr/search?q=20+avenue+de+Segur&type=housenumber");
const data = await resp.json();

Probe History

Latency

Status Codes

TimeStatusLatencySize
2026-04-16 03:04:25.242886 200 416ms
2026-04-16 01:54:17.515020 200 310ms
2026-04-15 02:42:30.710761 200 282ms
2026-04-15 02:32:42.263159 200 304ms
2026-04-14 03:07:03.668328 200 281ms
2026-04-14 02:20:25.591258 200 371ms
2026-04-12 16:40:53.767493 200 226ms
2026-04-12 15:23:23.645475 200 236ms
2026-04-10 02:08:06.099337 200 186ms
2026-04-10 00:20:04.648905 200 186ms
2026-04-09 03:02:59.332970 200 736ms
2026-04-09 02:36:08.032328 200 336ms