Search Places
Find points of interest (cafes, supermarkets, parks, ATMs, etc.) near a location. Prefer near.lat+near.lon whenever you already have coordinates — this disambiguates common place names that exist in multiple countries. Use near only when you genuinely have just a place name, and qualify it tightly (e.g. ‘Kings Cross, London’ not ‘Kings Cross’; ‘Lebanon, NH’ not ‘Lebanon’). Add boundary.country to restrict results when the search context is country-bound. For ‘find X near Y’ queries, prefer this over a separate /v1/geocoding/search call.
Authorizations
Your Footstep API key
Query Parameters
What to search for (e.g. 'coffee shop', 'restaurant', 'supermarket', 'train station', 'park')
Place name to search near (e.g. 'Kings Cross, London'). Geocoded internally. Provide either near OR both near.lat and near.lon, not both.
Latitude of search center. Prefer this over near whenever you already have coordinates — viewport centre, last-known location, a prior result. Pair with near.lon.
-90 <= x <= 90Longitude of search center. Pair with near.lat.
-180 <= x <= 180Search radius in kilometres
0.1 <= x <= 50Maximum number of results. Ask for more only when you genuinely want a longer candidate list
1 <= x <= 40Comma-separated ISO 3166-1 alpha-3 country codes to restrict results (e.g. 'GBR' or 'GBR,USA'). Set when the search context is country-bound.