Find Geotagging Candidates

get

https://places-api.foursquare.com/geotagging/candidates

Utilize Foursquare's Snap to Place technology to detect where your user's device is and what is around them.

This endpoint will intentionally return lower quality results not found in Place Search. It is not intended to replace Place Search as the primary way to search for top, recommended POIs.

Query Params

fields

string

Indicate which fields to return in the response, separated by commas. If no fields are specified, all Pro Fields are returned by default.

For a complete list of returnable fields, refer to the Places Response Fields page.

string

The latitude/longitude around which to retrieve place information. This must be 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.

hacc

double

The estimated horizontal accuracy radius in meters of the user?s location at the 68th percentile confidence level as returned by the user?s cell phone OS.

altitude

double

The altitude of the user?s location in meters above the World Geodetic System 1984 (WGS84) reference ellipsoid as returned by the user?s cell phone OS.

query

string

A string to be matched against place name for candidates.

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