Get Trending Venues

Public Beta Feature

This documentation covers a feature currently in Public Beta. Access is available to anyone interested in building personalized experiences for their end-users.

This feature is subject to the Personalization API (Self-Service) Public Beta End user License Agreement.

API Parameters

ll

• Type: string
• Required: Yes
• 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

• Type: 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

• Type: 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.

limit

• Type: int32
• Number of results to return; up to 50.

accept

• Type: string enum
• Defaults to application/json. Allowed: application/json, text/plain.

API Response Structure

200 Response

• Type: object
• Successful response containing a list of trending venues.

meta:

• object
  • code: integer
    • Defaults to 0
    • Status code indicating the result of the trending venues API request.
  • requestId: string
    • Unique request identifier.

response:

• object
• Response object containing trending venues near the user's location.

venues:

• array of objects
• Array of trending venues near the user's location.

Example Venue:

• id: string
  • Unique identifier for trending venues.
• location:
  • object
    • The location of the venues returned by a successful trending venues request.
  • name: string
    • The name of the trending venue.

Example API Request

curl --request GET \
     --url https://api.foursquare.com/v2/venues/trending \
     --header 'accept: application/json'

Example API 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
          }
        ]
      }
    ]
  }
}