Get Related Venues

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

Response Codes

{
  "meta": {
    "code": 200,
    "requestId": "644c26bc95a7917df4431cb6"
  },
  "notifications": [ 
    { 
      "type": "notificationTray", 
      "item": {
        "unreadCount": 3
      }
    },
    { 
      "type": "unconfirmed", 
      "item": {
        "unreadCount": 0
      }
    }
  ],
  "response": {
    "related": [ 
      { 
        "count": 3, 
        "summary": "child_venues", 
        "items": [ 
          { 
            "venue": { 
              "id": "5ae86b42fe3740002ca5c615", 
              "name": "Fat Denny’s Cafeteria", 
              "location": { 
                "address": "50 W 23rd St",  
                "crossStreet": "btwn 5th & 6th Ave", 
                "lat": 40.74189756982552,
                "lng": -73.99199674964586,
                "postalCode": "10010",
                "city": "New York",
                "state": "NY",
                "country": "United States",
                "formattedAddress": { 
                  "text": "50 W 23rd St
(btwn 5th & 6th Ave)
New York, NY 10010" 
                } 
              },
              "categories": [ 
                { 
                  "id": "54f4ba06498e2cf5561da814",
                  "name": "Corporate Cafeteria",
                  "primary": true 
                } 
              ],
              "stats": { 
                "tipCount": 23, 
                "usersCount": 581, 
                "checkinsCount": 4401 
              }
            }
          },
          // More venues (PDS Island, The Library) go here...
        ],
        "title": "Places inside Foursquare HQ"
      }
    ]
  }
}