Photo Details

Description

Get the details of a photo.

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/photos/PHOTO_ID

Authentication

This endpoint supports userless or user authentication.

Supported Description
Userless required unless OAuth token is provided. A valid Client ID and Secret in the query string of each request. Eg. &client_id=XXXX&client_secret=XXXX
User required unless Client ID and Secret are provided. A valid OAuth access token in the query string of each request. Eg. &oauth_token=XXXX

For more information about these authentication methods and how to obtain an access token, see the Authentication docs.

Parameters

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

Try it Now!

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. For more robust venue information (photos/tips/etc.), please see our venue details endpoint.
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": {
        "firstName": "John",
        "lastName": "D",
        "countryCode": "US"
      },
      "visibility": "public",
      "venue": {
        "id": "427c0500f964a52097211fe3",
        "name": "The Metropolitan Museum of Art (Metropolitan Museum of Art)",
        "contact": {},
        "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
          }
        ]
      }
    }
  }
}