Search Nearby Venues

get

https://api.foursquare.com/v2/venues/search

Search for venues near a user's location based on a set radius.

Query Params

string

required

The API version date as documented here; e.g. 20231010

query

string

A string to be searched against a venue's tips, category, etc.

string

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

near

string

A string naming a place in the world. If the near string is not geocodable, returns a failed_geocode error. Otherwise, searches within the bounds of the geocode and adds a geocode object to the response. Required if ll is not specified.

radius

int32

Limit results to venues within this many meters of the specified location. Defaults to a city-wide area. Only valid for requests that use categoryId or query. The maximum supported radius is currently 100,000 meters.

categoryId

string

A comma separated list of categories to limit results to. If you specify categoryId. Specifying a radius may improve results. If specifying a top-level category, all sub-categories will also match the query.

limit

int32

Number of results to return; up to 50.

url

string

A third-party URL which we will attempt to match against our map of venues to URLs.

Headers

string

enum

Defaults to application/json

Generated from available response content types

Allowed:

Responses

Language

Credentials

Query

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

text/plain

200200

400400