Description

Gives the full details about a venue including location, mayorship, tags, tips, and categories.

If the venue ID given is one that has been merged into another “master” venue, the response will show data about the “master” instead of giving you an error.


Request

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


Authentication

User or userless authentication. Authenticated users will also receive information about who is here now.


Parameters

Name Example Description
VENUE_ID XXX123YYY required ID of the venue to retrieve

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
popular Contains the hours during the week when people usually go to the venue.
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.
storeId The manager’s internal identifier for the venue.
description Description of the venue provided by venue owner.
createdAt Seconds since epoch when the venue was created.
mayor user who is the mayor (absent if there is no mayor), and count, the number of times they have checked in within the last 60 days.
tips Contains the total count of tips and groups with friends and others as groupTypes. Groups may change over time.
listed A grouped response of lists that contain this venue. Contains a summary string representing the acting user’s relationship to these lists. If an acting user is present, groups may include todos, created, edited, followed, friends, and others. If this venue is on the acting user’s todo list, those items will be included in the todos group.
tags An array of string tags applied to this venue.
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
photos A count and groups of photos for this venue. Group types are checkin and venue. Not all items will be present.
likes The count of users who have liked this venue, and groups containing any friends and others who have liked it. The groups included are subject to change.
like Indicates if the current user has liked this venue.
dislike Indicates if the current user has disliked this venue.
phrases List of phrases commonly seen in this venue’s tips, as well as a sample tip snippet and the number of tips this phrase appears in.
attributes Attributes associated with the venue, such as price tier, whether the venue takes reservations, and parking availability.
roles Present if and only if the current user has at least one assigned role for this venue. The value is a list of all of the current user’s assigned roles for this venue. Possible values for each element of the list are manager and employee. Subject to change as additional roles may be defined.
flags Present only for venues returned in Explore search results. Current flags include: outsideRadius: A boolean indicating that the venue is outside the radius specified by the original query. Explore may return venues outside the requested radius in the case of a high-quality “exact match” to the query (e.g. if the user searches for [ace bar] in Brooklyn, we will still find the popular Ace Bar venue in Manhattan and return it with outsideRadius: true).exactMatch: A boolean indicating that the venue name was a strong match for the specified query (either it was an exact string match, or there was a large overlap between the query and the given venue’s name).
page user is the branded page associated with the venue. If the venue is part of a chain, this will be a user object referring to the chain. For venues that are being managed and not part of a chain, this will contain a user object that uniquely refers to this venue.

Response

{
  "meta": {
    "code": 200,
    "requestId": "59a45921351e3d43b07028b5"
  },
  "response": {
    "venue": {
      "id": "412d2800f964a520df0c1fe3",
      "name": "Central Park",
      "contact": {
        "phone": "2123106600",
        "formattedPhone": "(212) 310-6600",
        "twitter": "centralparknyc",
        "instagram": "centralparknyc",
        "facebook": "37965424481",
        "facebookUsername": "centralparknyc",
        "facebookName": "Central Park"
      },
      "location": {
        "address": "59th St to 110th St",
        "crossStreet": "5th Ave to Central Park West",
        "lat": 40.78408342593807,
        "lng": -73.96485328674316,
        "postalCode": "10028",
        "cc": "US",
        "city": "New York",
        "state": "NY",
        "country": "United States",
        "formattedAddress": [
          "59th St to 110th St (5th Ave to Central Park West)",
          "New York, NY 10028",
          "United States"
        ]
      },
      "canonicalUrl": "https://foursquare.com/v/central-park/412d2800f964a520df0c1fe3",
      "categories": [
        {
          "id": "4bf58dd8d48988d163941735",
          "name": "Park",
          "pluralName": "Parks",
          "shortName": "Park",
          "icon": {
            "prefix": "https://ss3.4sqi.net/img/categories_v2/parks_outdoors/park_",
            "suffix": ".png"
          },
          "primary": true
        }
      ],
      "verified": true,
      "stats": {
        "checkinsCount": 364591,
        "usersCount": 311634,
        "tipCount": 1583,
        "visitsCount": 854553
      },
      "url": "http://www.centralparknyc.org",
      "likes": {
        "count": 17370,
        "summary": "17370 Likes"
      },
      "rating": 9.8,
      "ratingColor": "00B551",
      "ratingSignals": 18854,
      "beenHere": {
        "count": 0,
        "unconfirmedCount": 0,
        "marked": false,
        "lastCheckinExpiredAt": 0
      },
      "photos": {
        "count": 26681,
        "groups": [
          {
            "type": "venue",
            "name": "Venue photos",
            "count": 26681,
            "items": [
              {
                "id": "513bd223e4b0e8ef8292ee54",
                "createdAt": 1362874915,
                "source": {
                  "name": "Instagram",
                  "url": "http://instagram.com"
                },
                "prefix": "https://igx.4sqi.net/img/general/",
                "suffix": "/655018_Zp3vA90Sy4IIDApvfAo5KnDItoV0uEDZeST7bWT-qzk.jpg",
                "width": 612,
                "height": 612,
                "user": {
                  "id": "123456",
                  "firstName": "John",
                  "lastName": "Doe",
                  "gender": "male"
                },
                "visibility": "public"
              }
            ]
          }
        ]
      },
      "description": "Central Park is the 843-acre green heart of Manhattan and is maintained by the Central Park Conservancy. It was designed in the 19th century by Frederick Law Olmsted and Calvert Vaux as an urban escape for New Yorkers, and now receives over 40 million visits per year.",
      "storeId": "",
      "page": {
        "pageInfo": {
          "description": "The mission of the Central Park Conservancy, a private non-profit, is to restore, manage, and enhance Central Park, in partnership with the public.",
          "banner": "https://is1.4sqi.net/userpix/HS2JAA2IAAAR2WZO.jpg",
          "links": {
            "count": 1,
            "items": [
              {
                "url": "http://www.centralparknyc.org"
              }
            ]
          }
        },
        "user": {
          "id": "29060351",
          "firstName": "Central Park",
          "gender": "none",
          "photo": {
            "prefix": "https://igx.4sqi.net/img/user/",
            "suffix": "/PCPGGJ2N3ULA5O05.jpg"
          },
          "type": "chain",
          "tips": {
            "count": 37
          },
          "lists": {
            "groups": [
              {
                "type": "created",
                "count": 2,
                "items": []
              }
            ]
          },
          "homeCity": "New York, NY",
          "bio": "",
          "contact": {
            "twitter": "centralparknyc",
            "facebook": "37965424481"
          }
        }
      },
      "hereNow": {
        "count": 16,
        "summary": "16 people are here",
        "groups": [
          {
            "type": "others",
            "name": "Other people here",
            "count": 16,
            "items": []
          }
        ]
      },
      "createdAt": 1093478400,
      "tips": {
        "count": 1583,
        "groups": [
          {
            "type": "others",
            "name": "All tips",
            "count": 1583,
            "items": [
              {
                "id": "5150464ee4b02f70eb28eee4",
                "createdAt": 1364215374,
                "text": "Did you know? To create that feeling of being in the countryside, and not in the middle of a city, the four Transverse Roads were sunken down eight feet below the park’s surface.",
                "type": "user",
                "canonicalUrl": "https://foursquare.com/item/5150464ee4b02f70eb28eee4",
                "photo": {
                  "id": "5150464f52625adbe29d04c2",
                  "createdAt": 1364215375,
                  "source": {
                    "name": "Foursquare Web",
                    "url": "https://foursquare.com"
                  },
                  "prefix": "https://igx.4sqi.net/img/general/",
                  "suffix": "/13764780_Ao02DfJpgG1ar2PfgP51hOKWsn38iai8bsSpzKd0GcM.jpg",
                  "width": 800,
                  "height": 542,
                  "visibility": "public"
                },
                "photourl": "https://igx.4sqi.net/img/general/original/13764780_Ao02DfJpgG1ar2PfgP51hOKWsn38iai8bsSpzKd0GcM.jpg",
                "lang": "en",
                "likes": {
                  "count": 247,
                  "groups": [
                    {
                      "type": "others",
                      "count": 247,
                      "items": []
                    }
                  ],
                  "summary": "247 likes"
                },
                "logView": true,
                "agreeCount": 246,
                "disagreeCount": 0,
                "todo": {
                  "count": 30
                },
                "user": {
                  "id": "13764780",
                  "firstName": "City of New York",
                  "gender": "none",
                  "photo": {
                    "prefix": "https://igx.4sqi.net/img/user/",
                    "suffix": "/2X1FKJPUY3DGRRK3.png"
                  },
                  "type": "page"
                }
              },
              {
                "id": "522afa5b11d2740e9aeeb336",
                "createdAt": 1378548315,
                "text": "Lots of squirrels in the park! パーク内にはリスがたくさんいます!しかも思ったよりデカイです。",
                "type": "user",
                "logView": true,
                "editedAt": 1399418942,
                "agreeCount": 61,
                "disagreeCount": 0,
                "todo": {
                  "count": 1
                },
                "user": {
                  "id": "5053872",
                  "firstName": "Nnkoji",
                  "gender": "male",
                  "photo": {
                    "prefix": "https://igx.4sqi.net/img/user/",
                    "suffix": "/5053872-DUZ51RAOUVH3GU33.jpg"
                  }
                },
                "authorInteractionType": "liked"
              },
              {
                "id": "4cd5bda1b6962c0fd19c2e96",
                "createdAt": 1289076129,
                "text": "PHOTO: 1975 was the last year the New York City marathon was raced entirely inside Central Park. In this photo, runners at the marathon starting line.",
                "type": "user",
                "url": "http://www.nydailynewspix.com/sales/largeview.php?name=87g0km0g.jpg&id=152059&lbx=-1&return_page=searchResults.php&page=2",
                "canonicalUrl": "https://foursquare.com/item/4cd5bda1b6962c0fd19c2e96",
                "lang": "en",
                "likes": {
                  "count": 26,
                  "groups": [
                    {
                      "type": "others",
                      "count": 26,
                      "items": []
                    }
                  ],
                  "summary": "26 likes"
                },
                "logView": true,
                "agreeCount": 25,
                "disagreeCount": 0,
                "todo": {
                  "count": 16
                },
                "user": {
                  "id": "1241858",
                  "firstName": "The New York Daily News",
                  "gender": "none",
                  "photo": {
                    "prefix": "https://igx.4sqi.net/img/user/",
                    "suffix": "/3EV01452MGIUWBAQ.jpg"
                  },
                  "type": "page"
                }
              }
            ]
          }
        ]
      },
      "tags": [
        "art",
        "beautiful",
        "beautiful day",
        "beauty of nature",
        "benches",
        "bicycle",
        "bridges",
        "carousel",
        "cycling",
        "dog",
        "dogs",
        "exercise",
        "fun",
        "gate",
        "glasses",
        "grass",
        "ice skating",
        "imagine mosaic",
        "jogging",
        "meeting point",
        "nature",
        "new york city",
        "park",
        "parks & outdoor",
        "picnic",
        "picture perfect",
        "romance",
        "rowing",
        "running",
        "sight seeing",
        "strawberry fields",
        "summer stage",
        "summerstage",
        "take your dog for a walk",
        "today show",
        "tourists",
        "trees",
        "trendy",
        "walking"
      ],
      "shortUrl": "http://4sq.com/2UsPUp",
      "timeZone": "America/New_York",
      "listed": {
        "count": 5731,
        "groups": [
          {
            "type": "others",
            "name": "Lists from other people",
            "count": 5731,
            "items": [
              {
                "id": "4fad24a2e4b0bcc0c18be03c",
                "name": "101 places to see in Manhattan before you die",
                "description": "Best spots to see in Manhattan (New York City) as restaurants, monuments and public spaces. Enjoy!",
                "type": "others",
                "user": {
                  "id": "356747",
                  "firstName": "John",
                  "lastName": "Doe",
                  "gender": "male",
                  "photo": {
                    "prefix": "https://igx.4sqi.net/img/user/",
                    "suffix": "/356747-WQOTM2ASOIERONL3.jpg"
                  }
                },
                "editable": false,
                "public": true,
                "collaborative": false,
                "url": "/boke/list/101-places-to-see-in-manhattan-before-you-die",
                "canonicalUrl": "https://foursquare.com/boke/list/101-places-to-see-in-manhattan-before-you-die",
                "createdAt": 1336747170,
                "updatedAt": 1406242886,
                "photo": {
                  "id": "4fa97b0c121d8a3faef6f2df",
                  "createdAt": 1336507148,
                  "prefix": "https://igx.4sqi.net/img/general/",
                  "suffix": "/IcmBihQCVr4Zt0Vxt9l237NHv--nxg1Z5_8QIMjeD8E.jpg",
                  "width": 325,
                  "height": 487,
                  "user": {
                    "id": "13125997",
                    "firstName": "IWalked Audio Tours",
                    "gender": "none",
                    "photo": {
                      "prefix": "https://igx.4sqi.net/img/user/",
                      "suffix": "/KZCTVBJ0FXUHSQA5.jpg"
                    },
                    "type": "page"
                  },
                  "visibility": "public"
                },
                "followers": {
                  "count": 944
                },
                "listItems": {
                  "count": 101,
                  "items": [
                    {
                      "id": "t4b67904a70c603bb845291b4",
                      "createdAt": 1336747293,
                      "photo": {
                        "id": "4faa9dd9e4b01bd5523d1de8",
                        "createdAt": 1336581593,
                        "prefix": "https://igx.4sqi.net/img/general/",
                        "suffix": "/KaAuGPKMZev1Te0uucRYHk92RiULGj3-GYWkX_zXbjM.jpg",
                        "width": 720,
                        "height": 532,
                        "visibility": "public"
                      }
                    }
                  ]
                }
              }
            ]
          }
        ]
      },
      "phrases": [
        {
          "phrase": "parque todo",
          "sample": {
            "entities": [
              {
                "indices": [
                  22,
                  33
                ],
                "type": "keyPhrase"
              }
            ],
            "text": "... a ponta, curtir o parque todo, sem pressa, admirando cada lugar. Se puder..."
          },
          "count": 4
        }
      ],
      "hours": {
        "status": "Open until 1:00 AM",
        "isOpen": true,
        "isLocalHoliday": false,
        "timeframes": [
          {
            "days": "Mon–Sun",
            "includesToday": true,
            "open": [
              {
                "renderedTime": "6:00 AM–1:00 AM"
              }
            ],
            "segments": []
          }
        ]
      },
      "popular": {
        "status": "Likely open",
        "isOpen": true,
        "isLocalHoliday": false,
        "timeframes": [
          {
            "days": "Tue–Thu",
            "open": [
              {
                "renderedTime": "Noon–8:00 PM"
              }
            ],
            "segments": []
          },
          {
            "days": "Fri",
            "open": [
              {
                "renderedTime": "11:00 AM–7:00 PM"
              }
            ],
            "segments": []
          },
          {
            "days": "Sat",
            "open": [
              {
                "renderedTime": "8:00 AM–8:00 PM"
              }
            ],
            "segments": []
          },
          {
            "days": "Sun",
            "open": [
              {
                "renderedTime": "8:00 AM–7:00 PM"
              }
            ],
            "segments": []
          }
        ]
      },
      "pageUpdates": {
        "count": 12,
        "items": []
      },
      "inbox": {
        "count": 0,
        "items": []
      },
      "venueChains": [],
      "attributes": {
        "groups": [
          {
            "type": "payments",
            "name": "Credit Cards",
            "summary": "No Credit Cards",
            "count": 7,
            "items": [
              {
                "displayName": "Credit Cards",
                "displayValue": "No"
              }
            ]
          }
        ]
      },
      "bestPhoto": {
        "id": "513bd223e4b0e8ef8292ee54",
        "createdAt": 1362874915,
        "source": {
          "name": "Instagram",
          "url": "http://instagram.com"
        },
        "prefix": "https://igx.4sqi.net/img/general/",
        "suffix": "/655018_Zp3vA90Sy4IIDApvfAo5KnDItoV0uEDZeST7bWT-qzk.jpg",
        "width": 612,
        "height": 612,
        "visibility": "public"
      }
    }
  }
}