Description

Returns a list of venues near the current location with the most people currently checked in. For more robust information about the venues themselves (photos/tips/etc.), please see our venue details endpoint.


Request

GET https://api.foursquare.com/v2/venues/trending


Authentication

User or userless authentication.


Parameters

Name Example Description
ll 44.3,37.2 required unless near is provided. Latitude and longitude of the desired location.
near Lower East Side, NY required unless ll is provided. 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.
limit 10 Number of results to return, up to 50.
radius 100 Radius in meters, up to approximately 2000 meters.

Response Fields

Field Description
id A unique string identifier for this venue.
name The best known name for this venue.
location An object containing none, some, or all of address (street address), crossStreet, city, state, postalCode, country, lat, lng, and distance. All fields are strings, except for lat, lng, and distance. Distance is measured in meters. Some venues have their locations intentionally hidden for privacy reasons (such as private residences). If this is the case, the parameter isFuzzed will be set to true, and the lat/lng parameters will have reduced precision.
categories An array, possibly empty, of categories that have been applied to this venue. One of the categories will have a primary field indicating that it is the primary category for the venue. For the complete category tree, see categories.

Response

{
  "meta": {
    "code": 200,
    "requestId": "5ac51dde351e3d4df64064f8"
  },
  "response": {
    "venues": [
      {
        "id": "5735dc3f498e1ac6a088f324",
        "name": "Union Fare",
        "location": {
          "address": "5 E 17th St",
          "crossStreet": "btwn 5th Ave & Union Sq W",
          "lat": 40.737697,
          "lng": -73.991402,
          "labeledLatLngs": [
            {
              "label": "display",
              "lat": 40.737697,
              "lng": -73.991402
            }
          ],
          "distance": 1802,
          "postalCode": "10003",
          "cc": "US",
          "city": "New York",
          "state": "NY",
          "country": "United States",
          "formattedAddress": [
            "5 E 17th St (btwn 5th Ave & Union Sq W)",
            "New York, NY 10003",
            "United States"
          ]
        },
        "categories": [
          {
            "id": "4bf58dd8d48988d157941735",
            "name": "New American Restaurant",
            "pluralName": "New American Restaurants",
            "shortName": "New American",
            "icon": {
              "prefix": "https://ss3.4sqi.net/img/categories_v2/food/newamerican_",
              "suffix": ".png"
            },
            "primary": true
          }
        ]
      }
    ]
  }
}