Description

Get details of a photo.

To assemble a photo URL, combine the response’sprefix + 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/photos/PHOTO_ID


Authentication

User or userless authentication.


Parameters

Name Example Description
PHOTO_ID 111XXXYY222 The ID of the photo to retrieve additional information for.

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.
suffix Ending of the URL for this photo.
height Height of this photo in pixels.
width Width of this photo in pixels.
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": "599c8bf69fb6b72fcfa0779e"
  },
  "response": {
    "photo": {
      "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": "12345678",
        "firstName": "John",
        "lastName": "Doe",
        "gender": "male",
        "photo": {
          "prefix": "https://igx.4sqi.net/img/user/",
          "suffix": "/YXNQ5O4TLYSNHMKY.jpg"
        }
      },
      "visibility": "public",
      "venue": {
        "id": "427c0500f964a52097211fe3",
        "name": "The Metropolitan Museum of Art (Metropolitan Museum of Art)",
        "contact": {
          "phone": "2125357710",
          "formattedPhone": "(212) 535-7710",
          "twitter": "metmuseum",
          "facebook": "6296252634",
          "facebookUsername": "metmuseum",
          "facebookName": "The Metropolitan Museum of Art, New York"
        },
        "location": {
          "address": "1000 5th Ave",
          "crossStreet": "btwn E 80th & E 84th St",
          "lat": 40.779150129460504,
          "lng": -73.9627398125614,
          "postalCode": "10028",
          "cc": "US",
          "city": "New York",
          "state": "NY",
          "country": "United States",
          "formattedAddress": [
            "1000 5th Ave (btwn E 80th & E 84th St)",
            "New York, NY 10028",
            "United States"
          ]
        },
        "categories": [
          {
            "id": "4bf58dd8d48988d18f941735",
            "name": "Art Museum",
            "pluralName": "Art Museums",
            "shortName": "Art Museum",
            "icon": {
              "prefix": "https://ss3.4sqi.net/img/categories_v2/arts_entertainment/museum_art_",
              "suffix": ".png"
            },
            "primary": true
          }
        ],
        "verified": true,
        "stats": {
          "checkinsCount": 234902,
          "usersCount": 151535,
          "tipCount": 1808
        },
        "url": "http://www.metmuseum.org"
      }
    }
  }
}