API Docs
Support
Start typing to search…

Place Search

get https://api.foursquare.com/v3/places/search

Search for places in the FSQ Places database using a location and querying by name, category name, telephone number, taste label, or chain name. For example, search for "coffee" to get back a list of recommended coffee shops.

You may pass a location with your request by using one of the following options. If none of the following options are passed, Place Search defaults to geolocation using ip biasing with the optional radius parameter.

  • ll & radius (circular boundary)
  • near (geocodable locality)
  • ne & sw (rectangular boundary)

Query Params
string

A string to be matched against all content for this place, including but not limited to venue name, category, telephone number, taste, and tips.

string

The latitude/longitude around which to retrieve place information. This must be specified as latitude,longitude (e.g., ll=41.8781,-87.6298).

int32
0 to 100000

Sets a radius distance (in meters) used to define an area to bias search results. The maximum allowed radius is 100,000 meters. Radius can be used in combination with ll or ip biased geolocation only. By using radius, global search results will be omitted. If not provided, default radius applied is 22000 meters.

string

Filters the response and returns FSQ Places matching the specified categories. Supports multiple Category IDs, separated by commas.

For a complete list of Foursquare Category IDs, refer to the Category Taxonomy page. [This endpoint prefers the 5-integer style id, but can accept theBSON style id]

string

Filters the response and returns FSQ Places matching the specified chains. Supports multiple chain IDs, separated by commas.

For more information on Foursquare Chain IDs, refer to the Chains page.

string

Filters the response and returns FSQ Places not matching any of the specified chains. Supports multiple chain IDs, separated by commas. Cannot be used in conjunction with exclude_all_chains.

For more information on Foursquare Chain IDs, refer to the Chains page.

boolean

Filters the response by only returning FSQ Places that are not known to be part of any chain. Cannot be used in conjunction with exclude_chains.

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.

int32
1 to 4

Restricts results to only those places within the specified price range. Valid values range between 1 (most affordable) to 4 (most expensive), inclusive.

int32
1 to 4

Restricts results to only those places within the specified price range. Valid values range between 1 (most affordable) to 4 (most expensive), inclusive.

string

Support local day and local time requests through this parameter. To be specified as DOWTHHMM (e.g., 1T2130), where DOW is the day number 1-7 (Monday = 1, Sunday = 7) and time is in 24 hour format.

Places that do not have opening hours will not be returned if this parameter is specified. Cannot be specified in conjunction with open_now.

boolean

Restricts results to only those places that are open now.

Places that do not have opening hours will not be returned if this parameter is specified. Cannot be specified in conjunction with open_at.

string

The latitude/longitude representing the north/east points of a rectangle. Must be used with sw parameter to specify a rectangular search box. Global search results will be omitted.

string

The latitude/longitude representing the south/west points of a rectangle. Must be used with ne parameter to specify a rectangular search box. Global search results will be omitted.

string

A string naming a locality in the world (e.g., "Chicago, IL"). If the value is not geocodable, returns an error.

string

A string containing a list of coordinate pairs which define the edges of the polygon. Each pair must include latitude and longitude separated by a comma, with each pair separated by a tilde ~. Must have at least 4 coordinate pairs and be considered a "closed" polygon.

string

Specifies the order in which results are listed. Possible values are:

  • relevance (default)
  • rating
  • distance

int32
1 to 50

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

string

A user-generated token to identify a session for billing purposes. Learn more about session tokens.

string

A Foursquare Venue ID to use as search bounds so only places within that venue are returned

Responses

Response body
object
results
array of objects
results
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
context
object
geo_bounds
object
400

bad request

401

unauthorized

Updated 11 months ago

Did this page help you?
Language
Credentials

Updated 11 months ago

Did this page help you?