Sign in
Geocoding

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).

get/api/v1/geocoding/search

Query parameters

qstring required

Free-text query (city name, address, landmark).

Free-text query (city name, address, landmark).

countrystring nullable

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).

limitinteger

Maximum number of results to return (1-50).

Maximum number of results to return (1-50).

addressdetailsboolean

Include the structured address breakdown on every result.

Include the structured address breakdown on every result.

viewboxstring nullable

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"
    ]
  }
}

Changes

Changed in 1 of the 21 revisions of this API.12

  • 4c4530760ba112See the full diff
    • ○

      added the optional property code to the response with the 401 status

      response-optional-property-added

    • ○

      added the optional property code to the response with the 429 status

      response-optional-property-added

    • ○

      added the optional property code to the response with the 503 status

      response-optional-property-added

    • ○

      added the optional property hint to the response with the 401 status

      response-optional-property-added

    • ○

      added the optional property hint to the response with the 429 status

      response-optional-property-added

    • ○

      added the optional property hint to the response with the 503 status

      response-optional-property-added

    • ○

      added the optional property plan to the response with the 401 status

      response-optional-property-added

    • ○

      added the optional property plan to the response with the 429 status

      response-optional-property-added

    • ○

      added the optional property plan to the response with the 503 status

      response-optional-property-added

    • ○

      added the optional property reason to the response with the 401 status

      response-optional-property-added

    • ○

      added the optional property reason to the response with the 429 status

      response-optional-property-added

    • ○

      added the optional property reason to the response with the 503 status

      response-optional-property-added