Description

Returns venues that people often check in to after the current venue. Up to 5 venues are returned in each query, and results are sorted by how many people have visited that venue after the current one. Homes are never returned in results.


Request

GET https://api.foursquare.com/v2/venues/VENUE_ID/nextvenues


Authentication

User or userless authentication.


Parameters

Name Type Description
VENUE_ID 111XXYY222 required ID of venue to retrieve next venues for.

Response Fields

Field Description
id A unique string identifier for this venue.
name The best known name for this venue.
contact An object containing none, some, or all of twitter, phone, and formattedPhone. All are strings.
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.
verified Boolean indicating whether the owner of this business has claimed it and verified the information.
stats Contains checkinsCount (total checkins ever here), usersCount (total users who have ever checked in here), and tipCount (number of tips here).
url URL of the venue’s website, typically provided by the venue manager.
hours Contains the hours during the week that the venue is open along with any named hours segments in a human-readable format. For machine readable hours see venues/hours
menu An object containing url and mobileUrl that display the menu information for this venue.
price An object containing the price tier from 1 (least pricey) - 4 (most pricey) and a message describing the price tier.
rating Numerical rating of the venue (0 through 10). Returned as part of an explore result, excluded in search results. Not all venues will have a rating.
hereNow Information about who is here now. If present, there is always a count, the number of people here. If viewing details and there is a logged-in user, there is also a groups field with friends and others as types.
createdAt Seconds since epoch when the venue was created.
tips Contains the total count of tips and groups with friends and others as groupTypes. Groups may change over time.
beenHere Contains count of the number of times the acting user has been here. Absent if there is no acting user.
shortUrl A short URL for this venue, e.g. http://4sq.com/Ab123D
canonicalUrl The canonical URL for this venue, e.g. https://foursquare.com/v/foursquare-hq/4ab7e57cf964a5205f7b20e3
like Indicates if the current user has liked this venue.

Response

{
  "meta": {
    "code": 200,
    "requestId": "5854c2ec9fb6b7218e054c0b"
  },
  "notifications": [
    {
      "item": {
        "unreadCount": 13
      },
      "type": "notificationTray"
    }
  ],
  "response": {
    "nextVenues": {
      "count": 5,
      "items": [
        {
          "allowMenuUrlEdit": true,
          "beenHere": {
            "lastCheckinExpiredAt": 0
          },
          "categories": [
            {
              "icon": {
                "prefix": "https://ss3.4sqi.net/img/categories_v2/arts_entertainment/movietheater_",
                "suffix": ".png"
              },
              "id": "4bf58dd8d48988d17f941735",
              "name": "Movie Theater",
              "pluralName": "Movie Theaters",
              "primary": true,
              "shortName": "Movie Theater"
            }
          ],
          "contact": {
            "formattedPhone": "(844) 462-7342",
            "phone": "8444627342",
            "twitter": "regalmovies"
          },
          "id": "4ac79e84f964a52086b820e3",
          "location": {
            "address": "8028 Cooper Ave",
            "cc": "US",
            "city": "Glendale",
            "country": "United States",
            "formattedAddress": [
              "8028 Cooper Ave",
              "Glendale, NY 11385"
            ],
            "labeledLatLngs": [
              {
                "label": "display",
                "lat": 40.70828891073062,
                "lng": -73.86827496891706
              }
            ],
            "lat": 40.70828891073062,
            "lng": -73.86827496891706,
            "postalCode": "11385",
            "state": "NY"
          },
          "name": "Regal Cinemas Atlas Park 8",
          "stats": {
            "checkinsCount": 12822,
            "tipCount": 63,
            "usersCount": 4681
          },
          "storeId": "Glendale",
          "url": "http://www.regmovies.com/Theatres/Theatre-Folder/Regal-Atlas-Park-Stadium-8-8074",
          "verified": true
        },
        {
          "allowMenuUrlEdit": true,
          "beenHere": {
            "lastCheckinExpiredAt": 0
          },
          "categories": [
            {
              "icon": {
                "prefix": "https://ss3.4sqi.net/img/categories_v2/food/icecream_",
                "suffix": ".png"
              },
              "id": "4bf58dd8d48988d1c9941735",
              "name": "Ice Cream Shop",
              "pluralName": "Ice Cream Shops",
              "primary": true,
              "shortName": "Ice Cream"
            }
          ],
          "contact": {
            "formattedPhone": "(718) 386-3835",
            "phone": "7183863835",
            "twitter": "coldstone"
          },
          "hasMenu": true,
          "id": "4bdca852ccf52d7f60c3786d",
          "location": {
            "address": "8028 Cooper Ave",
            "cc": "US",
            "city": "Glendale",
            "country": "United States",
            "formattedAddress": [
              "8028 Cooper Ave",
              "Glendale, NY 11385"
            ],
            "labeledLatLngs": [
              {
                "label": "display",
                "lat": 40.70845660678791,
                "lng": -73.86809695017759
              }
            ],
            "lat": 40.70845660678791,
            "lng": -73.86809695017759,
            "postalCode": "11385",
            "state": "NY"
          },
          "menu": {
            "anchor": "View Menu",
            "label": "Menu",
            "mobileUrl": "https://foursquare.com/v/4bdca852ccf52d7f60c3786d/device_menu",
            "type": "Menu",
            "url": "https://foursquare.com/v/cold-stone-creamery/4bdca852ccf52d7f60c3786d/menu"
          },
          "name": "Cold Stone Creamery",
          "stats": {
            "checkinsCount": 864,
            "tipCount": 13,
            "usersCount": 588
          },
          "storeId": "22117",
          "url": "http://www.coldstonecreamery.com/stores/20120",
          "verified": true
        },
        {
          "allowMenuUrlEdit": true,
          "beenHere": {
            "lastCheckinExpiredAt": 0
          },
          "categories": [
            {
              "icon": {
                "prefix": "https://ss3.4sqi.net/img/categories_v2/food/default_",
                "suffix": ".png"
              },
              "id": "4bf58dd8d48988d14e941735",
              "name": "American Restaurant",
              "pluralName": "American Restaurants",
              "primary": true,
              "shortName": "American"
            }
          ],
          "contact": {
            "formattedPhone": "(718) 894-3533",
            "phone": "7188943533"
          },
          "id": "4bb36f6f2397b713a41438b3",
          "location": {
            "address": "7026 88th St",
            "cc": "US",
            "city": "Glendale",
            "country": "United States",
            "crossStreet": "Aubrey Ave.",
            "formattedAddress": [
              "7026 88th St (Aubrey Ave.)",
              "Glendale, NY 11385"
            ],
            "labeledLatLngs": [
              {
                "label": "display",
                "lat": 40.70999926273874,
                "lng": -73.8646973355394
              }
            ],
            "lat": 40.70999926273874,
            "lng": -73.8646973355394,
            "postalCode": "11385",
            "state": "NY"
          },
          "name": "Yerman's Irish Pub",
          "stats": {
            "checkinsCount": 3122,
            "tipCount": 26,
            "usersCount": 765
          },
          "verified": false
        },
        {
          "allowMenuUrlEdit": true,
          "beenHere": {
            "lastCheckinExpiredAt": 0
          },
          "categories": [
            {
              "icon": {
                "prefix": "https://ss3.4sqi.net/img/categories_v2/food/coffeeshop_",
                "suffix": ".png"
              },
              "id": "4bf58dd8d48988d1e0931735",
              "name": "Coffee Shop",
              "pluralName": "Coffee Shops",
              "primary": true,
              "shortName": "Coffee Shop"
            }
          ],
          "contact": {
            "facebook": "22092443056",
            "facebookName": "Starbucks",
            "facebookUsername": "Starbucks",
            "formattedPhone": "(718) 416-1521",
            "phone": "7184161521",
            "twitter": "starbucks"
          },
          "hasMenu": true,
          "id": "4bb208a7f964a5206eb33ce3",
          "location": {
            "address": "8000 Cooper Avenue",
            "cc": "US",
            "city": "Glendale",
            "country": "United States",
            "crossStreet": "at The Shops at Atlas Park",
            "formattedAddress": [
              "8000 Cooper Avenue (at The Shops at Atlas Park)",
              "Glendale, NY 11385"
            ],
            "labeledLatLngs": [
              {
                "label": "display",
                "lat": 40.70833948648347,
                "lng": -73.86914783265831
              }
            ],
            "lat": 40.70833948648347,
            "lng": -73.86914783265831,
            "postalCode": "11385",
            "state": "NY"
          },
          "menu": {
            "anchor": "View Menu",
            "externalUrl": "http://www.starbucks.com/menu",
            "label": "Menu",
            "mobileUrl": "http://www.starbucks.com/menu",
            "type": "Menu",
            "url": "http://www.starbucks.com/menu"
          },
          "name": "Starbucks",
          "stats": {
            "checkinsCount": 4680,
            "tipCount": 27,
            "usersCount": 1292
          },
          "storeId": "11812",
          "url": "http://www.starbucks.com/store/17861/",
          "verified": true
        },
        {
          "allowMenuUrlEdit": true,
          "beenHere": {
            "lastCheckinExpiredAt": 0
          },
          "categories": [
            {
              "icon": {
                "prefix": "https://ss3.4sqi.net/img/categories_v2/food/german_",
                "suffix": ".png"
              },
              "id": "4bf58dd8d48988d10d941735",
              "name": "German Restaurant",
              "pluralName": "German Restaurants",
              "primary": true,
              "shortName": "German"
            }
          ],
          "contact": {
            "facebook": "117242384960950",
            "facebookName": "Zum Stammtisch Restaurant",
            "facebookUsername": "zumstammtisch",
            "formattedPhone": "(718) 386-3014",
            "phone": "7183863014",
            "twitter": "stammtischpork"
          },
          "hasMenu": true,
          "id": "3fd66200f964a520fcf01ee3",
          "location": {
            "address": "6946 Myrtle Ave",
            "cc": "US",
            "city": "Glendale",
            "country": "United States",
            "formattedAddress": [
              "6946 Myrtle Ave",
              "Glendale, NY 11385"
            ],
            "labeledLatLngs": [
              {
                "label": "display",
                "lat": 40.70197759550821,
                "lng": -73.88107466714183
              }
            ],
            "lat": 40.70197759550821,
            "lng": -73.88107466714183,
            "postalCode": "11385",
            "state": "NY"
          },
          "menu": {
            "anchor": "View Menu",
            "externalUrl": "http://zumstammtisch.com/menus.html",
            "label": "Menu",
            "mobileUrl": "http://zumstammtisch.com/menus.html",
            "type": "Menu",
            "url": "http://zumstammtisch.com/menus.html"
          },
          "name": "Zum Stammtisch",
          "stats": {
            "checkinsCount": 2743,
            "tipCount": 42,
            "usersCount": 1562
          },
          "url": "http://zumstammtisch.com",
          "venuePage": {
            "id": "82419672"
          },
          "verified": true
        }
      ]
    }
  }
}