Nominatim · Example Payload

Nominatim Lookup Example

GeocodingOpenStreetMapMapsLocation ServicesOpen-SourcePublic APIs

Nominatim Lookup Example is an example object payload from Nominatim, with 2 top-level fields. It illustrates the shape of data this provider's APIs accept or return.

Top-level fields

requestresponse

Example Payload

{
  "request": {
    "method": "GET",
    "url": "https://nominatim.openstreetmap.org/lookup?osm_ids=R146656,W104393803,N240109189&format=jsonv2&addressdetails=1",
    "headers": {
      "User-Agent": "my-geocoding-app/1.0 (contact@example.com)",
      "Accept": "application/json"
    }
  },
  "response": [
    {
      "place_id": 257803017,
      "licence": "Data © OpenStreetMap contributors, ODbL 1.0. http://osm.org/copyright",
      "osm_type": "relation",
      "osm_id": 146656,
      "lat": "53.4791301",
      "lon": "-2.2447149",
      "category": "boundary",
      "type": "administrative",
      "place_rank": 16,
      "importance": 0.71614935,
      "addresstype": "city",
      "name": "Manchester",
      "display_name": "Manchester, Greater Manchester, England, United Kingdom",
      "address": {
        "city": "Manchester",
        "county": "Greater Manchester",
        "state": "England",
        "country": "United Kingdom",
        "country_code": "gb"
      },
      "boundingbox": ["53.3401354", "53.5445408", "-2.3199438", "-2.1469829"]
    }
  ]
}

Work with this as data

Every example here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for examples

4 MCP tools reach this

find_examplesBrowse and filter every example in the catalog.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This example

curl "https://apis.io/api/v1/examples/nominatim-lookup-example"

All examples

curl "https://apis.io/api/v1/examples?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.