Endpoint Playground

Try the Geocoding Lookup API

Test Crawlora's Geocoding Lookup API with realistic prefilled parameters. Generate a cURL request, inspect the expected structured JSON response, and open the full docs or pricing page when you are ready to integrate this public web data extraction endpoint into your application.

Endpoint facts

Method: GET
API path: /geocoding/lookup
Platform: Geocoding
Auth: apiKey
Credits: 1 credit/request
Required params: osm_ids
Common optional params: accept_language, addressdetails, extratags, namedetails

Geocoding Lookup API documentation Geocoding platform page Crawlora API pricing Try Geocoding Reverse API Try Geocoding Search API

Prefilled cURL

curl "https://api.crawlora.net/api/v1/geocoding/lookup?osm_ids=W23102165&accept_language=en&addressdetails=true" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Request parameters visible to crawlers

Parameter	Type	Required	Prefilled value	Description
osm_ids	string	Yes	W23102165	Comma-separated OSM ids such as W34633854,N123,R456
accept_language	string	No	en	Preferred result language, forwarded to Nominatim
addressdetails	boolean	No	true	Include address details, defaults to true
extratags	boolean	No		Include OSM extra tags
namedetails	boolean	No		Include multilingual name details

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "query": "W34633854",
    "results": [
      {
        "place_id": 358220252,
        "osm_type": "way",
        "osm_id": 34633854,
        "lat": "40.7484421",
        "lon": "-73.9856589",
        "category": "office",
        "type": "yes",
        "place_rank": 30,
        "importance": 0.5803438355141769,
        "addresstype": "office",
        "name": "Empire State Building",
        "display_name": "Empire State Building, 350, 5th Avenue, New York, United States",
        "address": {
          "office": "Empire State Building",
          "house_number": "350",
          "road": "5th Avenue",
          "city": "New York",
          "state": "New York",
          "postcode": "10118",
          "country": "United States",
          "country_code": "us"
        },
        "extratags": {
          "website": "https://www.esbnyc.com",
          "wikidata": "Q9188"
        },
        "namedetails": {
          "name": "Empire State Building",
          "name:en": "Empire State Building"
        }
      }
    ]
  }
}

Public Playground

Preview the endpoint before sending a live request

Sample responses, schemas, request previews, and code snippets are visible before sign in. Create an account when you are ready to save an API key and run authenticated requests.

Set up API key Endpoint docs

Endpoint

Choose one catalog endpoint for this request.

3 shown

Group

Method

Auth

Endpoint

GETapiKey1 credit/requestgeocoding.lookupResponseDocGeocoding

GET /geocoding/lookup

Lookup Nominatim OSM ids

Returns typed Nominatim JSONv2 places for comma-separated OSM ids such as W34633854,N123,R456.

API key required. Paste a full key or rotate one from the API Keys page.

Set up API key

View docs

API key

API key required for live requests. Your key is only used to send requests from this Playground.

not configured

Active Playground key: not configured

Manage API keys in Console

Required query parameters

osm_ids

requiredstring

Comma-separated OSM ids such as W34633854,N123,R456

Add an API key to send a live request.

If an active API key is configured, Copy cURL includes it. Share links never include API keys.

View docs

Sample responseGET

Shown before your first request. Add an API key and send a request to see the live response, status, latency, and headers.

{
  "code": 200,
  "msg": "OK",
  "data": {
    "query": "W34633854",
    "results": [
      {
        "place_id": 358220252,
        "osm_type": "way",
        "osm_id": 34633854,
        "lat": "40.7484421",
        "lon": "-73.9856589",
        "category": "office",
        "type": "yes",
        "place_rank": 30,
        "importance": 0.5803438355141769,
        "addresstype": "office",
        "name": "Empire State Building",
        "display_name": "Empire State Building, 350, 5th Avenue, New York, United States",
        "address": {
          "office": "Empire State Building",
          "house_number": "350",
          "road": "5th Avenue",
          "city": "New York",
          "state": "New York",
          "postcode": "10118",
          "country": "United States",
          "country_code": "us"
        },
        "extratags": {
          "website": "https://www.esbnyc.com",
          "wikidata": "Q9188"
        },
        "namedetails": {
          "name": "Empire State Building",
          "name:en": "Empire State Building"
        }
      }
    ]
  }
}

Endpoint details

Returns typed Nominatim JSONv2 places for comma-separated OSM ids such as W34633854,N123,R456.

Method: GET
Path: /geocoding/lookup
Authentication: apiKey
Credit cost: 1 credit/request
Platform: Geocoding
Parameters: 6 documented fields

Request parameters

osm_ids:queryaccept_language:queryaddressdetails:queryextratags:querynamedetails:queryx-api-key:header

Response schema fields

codedatadata.querydata.resultsdata.results[].addressdata.results[].address.ISO3166-2-lvl4data.results[].address.ISO3166-2-lvl6data.results[].address.citydata.results[].address.countrydata.results[].address.country_codedata.results[].address.countydata.results[].address.house_number

Sample response summary

{
  "code": 200,
  "msg": "OK",
  "data": {
    "query": "W34633854",
    "results": [
      {
        "place_id": 358220252,
        "osm_type": "way",
        "osm_id": 34633854,
        "lat": "40.7484421",
        "lon": "-73.9856589",
        "category": "office",
        "type": "yes",
        "place_rank": 30,
        "importance": 0.5803438355141769,
        "addresstype": "office",
        "name": "Empire State Building",
        "display_name": "Empire State Building, 350, 5th Avenue, New York, United States",
        "address": {
          "office": "Empire State Building",
          "house_number": "350",
          "road": "5th Avenue",
          "city": "New York",
          "state": "New York",
          "postcode": "10118",
          "country": "United States",
          "country_code": "us"
        },
        "extratags": {
          "website": "https://www.esbnyc.com",
          "wikidata": "Q9188"
        },
        "namedetails": {
          "name": "Empire State Building",
          "name:en": "Empire State Building"
        }
      }
    ]
  }
}

cURL example

curl "https://api.crawlora.net/api/v1/geocoding/lookup?osm_ids=<osm_ids>" \
  -H "x-api-key: $CRAWLORA_API_KEY"

View endpoint docs Open platform page Browse all endpoints Pricing Reverse geocode coordinates Search Nominatim places

Try the Geocoding Lookup API

Endpoint facts

Method: GET
API path: /geocoding/lookup
Platform: Geocoding
Auth: apiKey
Credits: 1 credit/request
Required params: osm_ids
Common optional params: accept_language, addressdetails, extratags, namedetails

Geocoding Lookup API documentation Geocoding platform page Crawlora API pricing Try Geocoding Reverse API Try Geocoding Search API

Prefilled cURL

curl "https://api.crawlora.net/api/v1/geocoding/lookup?osm_ids=W23102165&accept_language=en&addressdetails=true" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Request parameters visible to crawlers

Parameter	Type	Required	Prefilled value	Description
osm_ids	string	Yes	W23102165	Comma-separated OSM ids such as W34633854,N123,R456
accept_language	string	No	en	Preferred result language, forwarded to Nominatim
addressdetails	boolean	No	true	Include address details, defaults to true
extratags	boolean	No		Include OSM extra tags
namedetails	boolean	No		Include multilingual name details

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "query": "W34633854",
    "results": [
      {
        "place_id": 358220252,
        "osm_type": "way",
        "osm_id": 34633854,
        "lat": "40.7484421",
        "lon": "-73.9856589",
        "category": "office",
        "type": "yes",
        "place_rank": 30,
        "importance": 0.5803438355141769,
        "addresstype": "office",
        "name": "Empire State Building",
        "display_name": "Empire State Building, 350, 5th Avenue, New York, United States",
        "address": {
          "office": "Empire State Building",
          "house_number": "350",
          "road": "5th Avenue",
          "city": "New York",
          "state": "New York",
          "postcode": "10118",
          "country": "United States",
          "country_code": "us"
        },
        "extratags": {
          "website": "https://www.esbnyc.com",
          "wikidata": "Q9188"
        },
        "namedetails": {
          "name": "Empire State Building",
          "name:en": "Empire State Building"
        }
      }
    ]
  }
}

{ "code": 200, "msg": "OK", "data": { "query": "W34633854", "results": [ { "place_id": 358220252, "osm_type": "way", "osm_id": 34633854, "lat": "40.7484421", "lon": "-73.9856589", "category": "office", "type": "yes", "place_rank": 30, "importance": 0.5803438355141769, "addresstype": "office", "name": "Empire State Building", "display_name": "Empire State Building, 350, 5th Avenue, New York, United States", "address": { "office": "Empire State Building", "house_number": "350", "road": "5th Avenue", "city": "New York", "state": "New York", "postcode": "10118", "country": "United States", "country_code": "us" }, "extratags": { "website": "https://www.esbnyc.com", "wikidata": "Q9188" }, "namedetails": { "name": "Empire State Building", "name:en": "Empire State Building" } } ] } }

Endpoint details

Returns typed Nominatim JSONv2 places for comma-separated OSM ids such as W34633854,N123,R456.

Method: GET
Path: /geocoding/lookup
Authentication: apiKey
Credit cost: 1 credit/request
Platform: Geocoding
Parameters: 6 documented fields

Request parameters

osm_ids:queryaccept_language:queryaddressdetails:queryextratags:querynamedetails:queryx-api-key:header

Response schema fields

Sample response summary

{
  "code": 200,
  "msg": "OK",
  "data": {
    "query": "W34633854",
    "results": [
      {
        "place_id": 358220252,
        "osm_type": "way",
        "osm_id": 34633854,
        "lat": "40.7484421",
        "lon": "-73.9856589",
        "category": "office",
        "type": "yes",
        "place_rank": 30,
        "importance": 0.5803438355141769,
        "addresstype": "office",
        "name": "Empire State Building",
        "display_name": "Empire State Building, 350, 5th Avenue, New York, United States",
        "address": {
          "office": "Empire State Building",
          "house_number": "350",
          "road": "5th Avenue",
          "city": "New York",
          "state": "New York",
          "postcode": "10118",
          "country": "United States",
          "country_code": "us"
        },
        "extratags": {
          "website": "https://www.esbnyc.com",
          "wikidata": "Q9188"
        },
        "namedetails": {
          "name": "Empire State Building",
          "name:en": "Empire State Building"
        }
      }
    ]
  }
}

cURL example

curl "https://api.crawlora.net/api/v1/geocoding/lookup?osm_ids=<osm_ids>" \
  -H "x-api-key: $CRAWLORA_API_KEY"

View endpoint docs Open platform page Browse all endpoints Pricing Reverse geocode coordinates Search Nominatim places