Place Match

Return the Foursquare record of a POI (via FSQ_ID) given a Name and Location. Provide a Location by using all the Address parameters, or by LL.

Query Params
string
required

Name of the place to match.

string

Street address of the place to match (e.g. 1060 W Addison St).

string

City, or Locality, where the place is located (e.g. Chicago).

string

State, or Region, where the place is located (e.g. Illinois).

string

The postal code for the address where the place is located (e.g. 60613).

string

The 2-digit country code where the place is located (e.g. US).

string

The latitude/longitude of the venue location. This must be specified as latitude,longitude (e.g., ll=41.9484,-87.6553).

string

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

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

Responses

Response body
object
place
object
string
categories
array of objects
categories
object
int32
string
string
string
icon
object
chains
array of objects
chains
object
string
string
string
date
string
int32
string
string
features
object
geocodes
object
hours
object
hours_popular
array of objects
string
location
object
string
string
photos
array of objects
photos
object
string
date-time
string
string
int32
int32
classifications
array of strings
classifications
tip
object
double
int32
double
related_places
object
social_media
object
stats
object
string
tastes
array of strings
tastes
string
string
tips
array of objects
tips
object
string
date-time
string
string
string
string
int32
int32
string
boolean
string
double
context
object
double
double
400

Unable to resolve address. Please provide a latitude and longitude using the ll parameter.

404

Match not found

Language
Credentials