Place Match

get

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

Return the Foursquare record of a POI (via fsq_place_id) given a name and location.

Query Params

name

string

required

Name of the place to match.

address

string

required

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

city

string

required

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

state

string

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

postal_code

string

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

string

required

The 2-digit country code where the place is located (e.g. US). Only English-speaking countries currently supported.

string

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

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.

Headers

X-Places-Api-Version

string

enum

required

Defaults to 2025-06-17

The version of the API to use.

Allowed:

Responses

400

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

404

Match not found

422

Unsupported country.

500

Internal server error.

200success