search: Search by direct geocoding

API: gouv.fr:french-address-search
Endpoint: /search
Response format: application/json
Auth: unknown
Method: GET
Last Status: 400
Latency: 882ms

Description

Provides geographic coordinates from an address, place name, point of interest, or cadastral parcel. Supports searching across three indexes: address (postal addresses), poi (points of interest), and parcel (cadastral parcels).

Parameters (12)

autocomplete (boolean, query, optional, default: True)

Enable autocomplete mode for real-time user input. Default: true

category (string, query, optional)

Filter for POI index only. Filter by POI category (e.g., administratif, restaurant, cimetière, etc.)

city (string, query, optional)

Filter for address and POI indexes. Filter results by city name.

citycode (string, query, optional)

Filter for address and POI indexes. Filter results by INSEE city code.

index (string, query, optional)

Search index(es) to query. Can be a single index or comma-separated list. Defaults to 'address'.

Constraints: {'enum': ['address', 'poi', 'parcel']}

lat (number, query, optional)

Latitude of a reference point to prioritize closest results (proximity bias).

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

Maximum number of results to return. Default: 10

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

lon (number, query, optional)

Longitude of a reference point to prioritize closest results (proximity bias).

postcode (string, query, optional)

Filter for address and POI indexes. Filter results by postal code.

q (string, query, optional)

Query string describing the location to search for. Examples: '73 Avenue de Paris Saint-Mandé', 'cimetière Vincennes', '75056104AE0003' (for parcel search)

returntruegeometry (boolean, query, optional, default: False)

Return true geometry instead of center point. Default: false

type (string, query, optional)

Filter for address index only. Filter by address type: housenumber, street, locality, or municipality.

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

Examples (1)

Search by direct geocoding openapi-spec 
curl 'https://data.geopf.fr/geocodage/search?q=8+Avenue+des+Champs-%C3%89lys%C3%A9es+Paris&index=address&limit=5&type=municipality&postcode=94160&citycode=94067&city=saint-mand%C3%A9&category=administratif&lon=2.32764&lat=48.835187'
import requests

resp = requests.get(
    "https://data.geopf.fr/geocodage/search",
    params={
        'q': '8 Avenue des Champs-Élysées Paris',
        'index': 'address',
        'limit': '5',
        'type': 'municipality',
        'postcode': '94160',
        'citycode': '94067',
        'city': 'saint-mandé',
        'category': 'administratif',
        'lon': '2.32764',
        'lat': '48.835187',
    },
)
data = resp.json()
import zingu_apis

api = zingu_apis.api("gouv")
result = api.fetch("search", q="8 Avenue des Champs-Élysées Paris", index="address", limit=5, type="municipality", postcode=94160, citycode=94067, city="saint-mandé", category="administratif", lon=2.32764, lat=48.835187)

for item in result:
    print(item)
const resp = await fetch("https://data.geopf.fr/geocodage/search?q=8+Avenue+des+Champs-%C3%89lys%C3%A9es+Paris&index=address&limit=5&type=municipality&postcode=94160&citycode=94067&city=saint-mand%C3%A9&category=administratif&lon=2.32764&lat=48.835187");
const data = await resp.json();

Probe History

Latency

Status Codes

TimeStatusLatencySize
2026-04-16 04:09:45.160674 400 882ms
2026-04-15 00:35:37.901986 400 2340ms
2026-04-14 02:23:27.516276 400 385ms
2026-04-12 12:38:03.211174 400 234ms
2026-04-10 02:33:19.384125 400 241ms
2026-04-09 02:51:12.577959 400 2857ms