We have two different types of endpoints: Regular and Premium. Regular endpoints include basic venue firmographic data, category, and ID. Premium endpoints include rich content such as ratings, URLs, photos, tips, menus, etc. Restrictions apply based on your account type, with further details documented on our rate limits page.

When displaying content from these endpoints, we encourage you to read through our Terms of Use and Attribution guidelines to avoid any unexpected interruption to services.


Places API Endpoints

Method Group Endpoint Usage User Auth Required? Endpoint Type
GET venues details Get Details of a Venue Premium
GET venues search Search for Venues Regular
GET venues explore Get Venue Recommendations Regular
POST venues select Report Venue Selection Regular
GET venues photos Get a Venue’s Photos Premium
GET venues tips Get a Venue’s Tips Premium
GET venues hours Get a Venue’s Hours Premium
GET venues menu Get a Venue’s Menu Premium
GET venues links Get a Venue’s Links Premium
GET venues trending Get Trending Venues Regular
GET venues suggestcompletion Suggest Completions Regular
GET venues likes Get Users Who Liked a Venue Regular
GET venues categories Get Venue Categories Regular
GET venues similar Get Similar Venues Regular
GET venues events Get Events at a Venue Premium
GET venues nextvenues Get Next Venues Regular
GET venues listed Get Lists a Venue is On Regular
GET venues timeseries Get Your Venue’s Stats Over Time Regular
GET venues stats Get Your Venue’s Stats Regular
GET venues managed Get Venues You Manage Regular
POST venues add Add a Venue Regular
POST venues claim Claim a Venue Regular
POST venues flag Indicate a Venue is Incorrect Regular
POST venues proposeedit Propose an Edit to a Venue Regular
GET venues like Like a Venue Regular
GET users details Get Details of a User Regular
GET users search Search for Users Regular
GET users checkins Get Check-Ins for a User Regular
GET users friends Get a User’s Friends Regular
GET users photos Get a User’s Photos Regular
GET users venuehistory Get Venues Visited by a User Regular
GET users tastes Get a User’s Tastes Regular
GET users venuelikes Get Venues a User Liked Regular
GET users lists Get a User’s Lists Regular
GET photos details Get Details of a Photo Regular
POST photos add Add a Photo Regular
GET tips details Get Details of a Tip Regular
POST tips add Add a Tip to a Venue Regular
GET checkins details Get Details of a Check-In Regular
GET checkins resolve Resolve a Public Check-In from URL Regular
POST checkins add Create a Check-In Regular
POST checkins like Like a Check-In Regular
POST checkins addpost Add a Post to a Check-In Regular
GET lists details Get Details of a List Regular
POST lists add Create a List Regular
POST lists additem Add an Item to a List Regular
POST lists share Share a List Regular