Forward geocode a free-text query
Convert a free-text query (city name, address, landmark) into a list of matching OpenStreetMap places with coordinates and optional address breakdown. Intended for one-shot lookups, not live autocomplete - OSM policy prohibits as-you-type usage against the public Nominatim instance. Data is (C) OpenStreetMap contributors (ODbL 1.0).
Query parameters
Free-text query (city name, address, landmark).
Free-text query (city name, address, landmark).
Comma-separated ISO 3166-1 alpha-2 country codes to restrict results (e.g. US,GB,DE).
Comma-separated ISO 3166-1 alpha-2 country codes to restrict results (e.g. US,GB,DE).
Maximum number of results to return (1-50).
Maximum number of results to return (1-50).
Include the structured address breakdown on every result.
Include the structured address breakdown on every result.
Optional bias bounding box minLon,minLat,maxLon,maxLat. When set, results are restricted to this box.
Optional bias bounding box minLon,minLat,maxLon,maxLat. When set, results are restricted to this box.
Response
Matching places sorted by importance, (C) OpenStreetMap contributors (ODbL 1.0).
Example response
{
"meta": {
"endpoint": "/api/v1/fred/us/cpi",
"data_time": "2026-04-16T14:30:00Z",
"response_time": "2026-04-16T14:30:12Z",
"provider": "Sugra API v1.0.1",
"source": "sugra_crypto",
"attribution": "Short interest and Reg SHO daily short volume data is owned by and sourced from FINRA (Financial Industry Regulatory Authority).",
"fallback_chain": [
"sugra_crypto",
"sugra_finance"
]
}
}