Skip to main content
GET
/
v1
/
geocoding
/
places
Find places near a location
curl --request GET \
  --url https://api.footstep.ai/v1/geocoding/places \
  --header 'x-api-key: <api-key>'
{
  "results": [
    {
      "coordinates": {
        "lat": 51.5318,
        "lng": -0.1243
      },
      "label": "Caravan, Granary Square, London, England, United Kingdom",
      "name": "Caravan",
      "country": "United Kingdom",
      "country_code": "GBR",
      "region": "England",
      "locality": "London",
      "distance_meters": 120,
      "confidence": 0.92,
      "place_type": "venue"
    }
  ],
  "query": {
    "query": "coffee shop",
    "near": {
      "lat": 51.5322,
      "lon": -0.124
    },
    "radius": 5,
    "size": 10
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.footstep.ai/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
x-api-key
string
header
required

Your Footstep API key

Query Parameters

​
query
string
required

What to search for (e.g. 'coffee shop', 'restaurant', 'supermarket', 'train station', 'park')

​
near
string

Place name to search near (e.g. 'Kings Cross, London'). Geocoded internally. Provide either near OR both near.lat and near.lon, not both.

​
near.lat
number

Latitude of search center. Use with near.lon when you already have coordinates; otherwise prefer near.

Required range: -90 <= x <= 90
​
near.lon
number

Longitude of search center. Pair with near.lat.

Required range: -180 <= x <= 180
​
radius
number
default:5

Search radius in kilometres

Required range: 0.1 <= x <= 50
​
size
integer
default:5

Maximum number of results. Ask for more only when you genuinely want a longer candidate list

Required range: 1 <= x <= 40
​
boundary.country
string

Comma-separated ISO 3166-1 alpha-3 country codes (e.g. GBR,USA)

Response

Places matching the query

​
results
object[]
required
​
query
object
required