Get Venue Photos

Public Beta Feature

This documentation covers a feature currently in Public Beta. Access is available to anyone interested in building personalized experiences for their end-users.

This feature is subject to the Personalization API (Self-Service) Public Beta End user License Agreement.

Parameters

Parameter Type Requirement Description
venue_id string required The venue you want photos for; e.g., Foursquare HQ's venue_id = 5a187743ccad6b307315e6fe
v string required The API version date as documented here; e.g. 20231010
limit int32 Number of results to return, up to 200.
offset int32 Used to page through results, up to 50.
accept string enum Defaults to application/json, Allowed: application/json, text/plain.

Response

HTTP Status Codes
Response Structure
{
  "meta": {
    "code": 200,
    "requestId": "642cab46eea295646176faba"
  },
  "notifications": [
    {
      "type": "notificationTray",
      "item": {
        "unreadCount": 3
      }
    },
    {
      "type": "unconfirmed",
      "item": {
        "unreadCount": 0
      }
    }
  ],
  "response": {
    "photos": {
      "count": 3,
      "items": [
        {
          "id": "5aeb7f7389ad460024c22206",
          "createdAt": 1525383027,
          "source": {
            "name": "Swarm for iOS",
            "url": "https://www.swarmapp.com"
          },
          "prefix": "https://fastly.4sqi.net/img/general/",
          "suffix": "/5435652_tVudly9wn9jCMpn9N6qT54RBpyx-rc3BGWg9o4E1gOk.jpg",
          "width": 1440,
          "height": 1828,
          "user": {
            "id": "12345",
            "firstName": "John",
            "lastName": "Smith",
            "gender": "male",
            "countryCode": "US",
            "photo": {
              "prefix": "https://fastly.4sqi.net/img/user/",
              "suffix": "/blank_boy.png"
            },
            "isAnonymous": false
          },
          "checkin": {
            "id": "5aeb7f67db1d81002c461c7e",
            "createdAt": 1525383015,
            "type": "checkin",
            "timeZoneOffset": -240
          },
          "visibility": "public"
        },
        {
          "id": "5ae8dd16029a550039b83f03",
          "createdAt": 1525210390,
          "source": {
            "name": "Swarm for iOS",
            "url": "https://www.swarmapp.com"
          },
          "prefix": "https://fastly.4sqi.net/img/general/",
          "suffix": "/386427136_I5e039H76JppC17htf_W1O024KONpSL6cjmJVsjqps0.jpg",
          "width": 1440,
          "height": 1920,
          "user": {
            "id": "12345",
            "firstName": "John",
            "lastName": "Smith",
            "gender": "male",
            "countryCode": "US",
            "photo": {
              "prefix": "https://fastly.4sqi.net/img/user/",
              "suffix": "/blank_boy.png"
            },
            "isAnonymous": false
          },
          "checkin": {
            "id": "5ae8dcefd0a149002c67da84",
            "createdAt": 1525210351,
            "type": "checkin",
            "timeZoneOffset": -240
          },
          "visibility": "public"
        },
        {
          "id": "5ae87ec28496ca002c036bb0",
          "createdAt": 1525186242,
          "source": {
            "name": "Swarm for iOS",
            "url": "https://www.swarmapp.com"
          },
          "prefix": "https://fastly.4sqi.net/img/general/",
          "suffix": "/47321_be2z7K5ZLWO4wOs5wBuyzrKCTlNf0HWNvuskWcie8tI.jpg",
          "width": 1440,
          "height": 1920,
          "user": {
            "id": "12345",
            "firstName": "John",
            "lastName": "Smith",
            "gender": "male",
            "countryCode": "US",
            "photo": {
              "prefix": "https://fastly.4sqi.net/img/user/",
              "suffix": "/blank_boy.png"
            },
            "isAnonymous": false
          },
          "checkin": {
            "id": "5ae8741eb1538e002ce6762b",
            "createdAt": 1525183518,
            "type": "checkin",
            "timeZoneOffset": -240
          },
          "visibility": "public"
        }
      ],
      "dupesRemoved": 0
    }
  }
}