Description

Returns photos for a specific venue. To assemble a photo URL, combine the response’s prefix + size + suffix. Ex: https://igx.4sqi.net/img/general/300x500/5163668_xXFcZo7sU8aa1ZMhiQ2kIP7NllD48m7qsSwr1mJnFj4.jpg

size can be one of the following, where XX or YY is one of 36, 100, 300, or 500.

  • XXxYY
  • original: the original photo’s size
  • capXX: cap the photo with a width or height of XX. (whichever is larger). Scales the other, smaller dimension proportionally
  • widthXX: forces the width to be XX and scales the height proportionally
  • heightYY: forces the height to be YY and scales the width proportionally

Request

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


Authentication

User or userless authentication.


Parameters

Name Example Description
VENUE_ID XXX123YYYY required The venue you want photos for.
group checkin If not specified, public venue photos are returned ordered by relevance. Pass venue for public venue photos, ordered by recency. Pass checkin for venue photos from friends (including non-public photos from recent checkins), ordered by recency.
limit 100 Number of results to return, up to 200.
offset 100 Used to page through results.

Response Fields

Field Description
id A unique string identifier for this photo.
createdAt Seconds since epoch when this photo was created.
prefix Start of the URL for this photo.
height Height of this photo in pixels.
width Width of this photo in pixels.
suffix Ending of the URL for this photo.
visibility Can be one of public (everybody can see, including on the venue page), friends (only the poster’s friends can see), or private (only the poster can see)
source If present, the name and url for the application that created this photo.
user If the user is not clear from context, then a user is present.
venue If the venue is not clear from context, then a venue is present.
tip If the tip is not clear from context, then a tip is present.
checkin If the checkin is not clear from context, then a checkin is present.

Response

{
  "meta": {
    "code": 200,
    "requestId": "5997070d6a60717704801060"
  },
  "response": {
    "photos": {
      "count": 1,
      "items": [
        {
          "id": "51e4151c498e60b5d17bc721",
          "createdAt": 1373902108,
          "source": {
            "name": "Instagram",
            "url": "http://instagram.com"
          },
          "prefix": "https://igx.4sqi.net/img/general/",
          "suffix": "/1022386_wEd7VXnWzp5lajvRLtAPunoiufDSIq8PMEtEuIH2Tzg.jpg",
          "width": 612,
          "height": 612,
          "user": {
            "id": "123456",
            "firstName": "John",
            "lastName": "Doe",
            "gender": "male",
            "photo": {
              "prefix": "https://igx.4sqi.net/img/user/",
              "suffix": "/YXNQ5O4TLYSNHMKY.jpg"
            }
          },
          "checkin": {
            "id": "51e4151b498ea66547febfaf",
            "createdAt": 1373902107,
            "type": "checkin",
            "timeZoneOffset": -240
          },
          "visibility": "public"
        }
      ],
      "dupesRemoved": 0
    }
  }
}