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 📄.
Overview
Discover and explore new venues based on where you’ve been or what’s popular in your area.
Foursquare’s Discovery APIs leverage billions of user interactions to power smarter venue recommendations based on consumer behavior, geographic proximity, and offerings similar to those at the user’s current location.
API in Action
- Recommend trending locations
Provide users with a list of the most popular nearby places, powering venue recommendations with real-world consumer activity and check-ins. - Encourage exploration of similar places
Empower users to discover new, nearby venues that offer similar experiences and are often visited after their current location. - Build the best location-aware UX
Leverage Foursquare’s comprehensive suite of location-enabled APIs to deliver the most unique user experience, recommending venues based on personal preferences, consumer trends, and place characteristics.
Endpoints
Get Venue Attributes
Get the attributes of a chosen venue.
Get Venue Categories
Get the full list of Foursquare categories applied to venues.
Get Venue Details
Get the details of a chosen venue.
Get Venue Hours
Get the hours of a chosen venue.
Get Venue Photos
Get the photos of a chosen venue.
Get Venue Tips
Get the tips (reviews) of a chosen venue.
Get Trending Venues
Surface places similar to a user's current location based on geographic proximity, consumer behavior trends, and venues offering similar experiences.
Get Related Venues
Return a list of venues near the current location with the most people currently checked in.
Rate a Venue
Allow a user to rate a venue.