Autocomplete

get

https://places-api.foursquare.com/autocomplete

Returns a list of top places, geos, and/or searches partially matching the provided keyword and location inputs.

Query Params

query

string

required

A search term to be applied against titles. Must be at least 3 characters long.

string

The latitude/longitude around which you wish to retrieve place information. Specified as latitude,longitude (e.g., ll=41.8781,-87.6298). If you do not specify ll, the server will attempt to retrieve the IP address from the request, and geolocate that IP address.

radius

int32

Defines the distance (in meters) within which to return place results. Setting a radius biases the results to the indicated area, but may not fully restrict results to that specified area. If not provided, default radius is set to 5000 meters.

types

string

The types of results to return; any combination of place, search, and/or geo.If no types are specified, all types will be returned.

bias

string

Bias the autocomplete results by a specific type; one of place, search, or geo.

session_token

string

A user-generated token to to group the user's query and the user's selected result into a discrete session for billing purposes. Learn more about session tokens.

If the session_token parameter is omitted, the session is charged per keystroke/request.

limit

int32

1 to 50

The number of results to return, up to 50. Defaults to 10.

Headers

X-Places-Api-Version

string

enum

required

Defaults to 2025-06-17

The version of the API to use.

Allowed:

Response

200success