Foursquare
FREE
By serg.osipchuk
Updated a year ago

Foursquare API Documentation

Get Foursquare data and enable user/merchant interactions.

Learn more about this API
POSTaddCommentToCheckin
POSTaddItemToList
POSTaddList
POSTaddPage
POSTaddPostToCheckin
POSTaddTip
POSTaddVenue
POSTchangeSingleSetting
POSTclaimVenue
POSTcreateCheckin
POSTdeleteItemFromList
POSTdislikeVenue
POSTfindUsers
POSTflagTip
POSTflagVenue
POSTfollowList
POSTgetAccessToken
POSTgetCheckin
POSTgetEventCategories
POSTgetListFollowers
POSTgetListItem
POSTgetListsTipAppears
POSTgetNextVenues
POSTgetNotificationUpdates
POSTgetPageAccessToken
POSTgetPageUpdates
POSTgetPageVenues
POSTgetPageVenuesTimeSeriesData
POSTgetPendingFriendRequests
POSTgetPhoto
POSTgetRecentFriendsCheckins
POSTgetRecommendedVenues
POSTgetSimilarVenues
POSTgetSingleEvent
POSTgetSingleList
POSTgetSinglePageUpdate
POSTgetSingleSetting
POSTgetSingleVenue
POSTgetSuggestedCompletion
POSTgetTip
POSTgetTrendingVenues
POSTgetUpdateDetails
POSTgetUser
POSTgetUserCheckins
POSTgetUserFriends
POSTgetUserLikedVenues
POSTgetUserLists
POSTgetUserManagedPages
POSTgetUserManagedVenues
POSTgetUserMayorships
POSTgetUserPhotos
POSTgetUserSettings
POSTgetUserVisitedVenues
POSTgetUsersSavedTip
POSTgetUsersWhoLikedCheckin
POSTgetUsersWhoLikedTip
POSTgetUsersWhoLikedVenue
POSTgetVenueCategories
POSTgetVenueEvents
POSTgetVenueGroups
POSTgetVenueHours
POSTgetVenueLinks
POSTgetVenueMenu
POSTgetVenuePeopleCount
POSTgetVenuePhotos
POSTgetVenueTips
POSTlikeCheckin
POSTlikePageUpdate
POSTlikeTip
POSTlikeVenue
POSTmarkNotificationsAsRead
POSTmoveItemOnList
POSTproposeVenueChange
POSTremoveCommentFromCheckin
POSTremoveTipFromToDoList
POSTresolvePublicCheckinFromUrl
POSTsearchEvents
POSTsearchSpecials
POSTsearchVenues
POSTshareList
POSTsuggestItemListPhotos
POSTsuggestListTips
POSTsuggestVenuesForList
POSTundoDislikeVenue
POSTunfollowList
POSTunlikeCheckin
POSTunlikeTip
POSTunlikeVenue
POSTupdateListItem
POSTupdateUserPhoto
POSTupdatesList
POSTgetRecommendedVenues

Returns a list of recommended venues near the current location.

Header Parameters
X-RapidAPI-HostSTRING
REQUIRED
X-RapidAPI-KeySTRING
REQUIRED
Required Parameters
clientIdCREDENTIALS
REQUIREDApplication client id.
clientSecretCREDENTIALS
REQUIREDApplication client secret key.
Optional Parameters
locationAccuracyFLOAT
OPTIONALAccuracy of latitude and longitude, in meters. (Does not currently affect search results.)
timeSTRING
OPTIONALPass `any` to retrieve results for any time of day. Omitting this parameter returns results targeted to the current time of day.
specialsBOOLEAN
OPTIONALBoolean flag to only include venues that have a special.
noveltySELECT
OPTIONALPass `new `or `old` to limit results to places the acting user hasn't been or has been, respectively. Omitting this parameter returns a mixture of old and new venues.
radiusNUMBER
OPTIONALRadius to search within, in meters. If radius is not specified, a suggested radius will be used based on the density of venues in the area.
altitudeAccuracyFLOAT
OPTIONALAccuracy of the user's altitude, in meters. (Does not currently affect search results.)
limitNUMBER
OPTIONALNumber of results to return, up to 50.
locationMAP
OPTIONALRequired unless near is provided: Latitude and longitude of the user's location. Format: `lat,lng`. Example: `40.7,-74`
venuePhotosNUMBER
OPTIONALBoolean flag to include a photo in the response for each venue, if one is available. Default is `0` (no photos). Photos are returned as part of the venue JSON object.
openNowBOOLEAN
OPTIONALBoolean flag to only include venues that are open now. This prefers official provider hours but falls back to popular check-in hours.
priceSTRING
OPTIONALComma separated list of price points. Currently the valid range of price points are [1,2,3,4], 1 being the least expensive, 4 being the most expensive. For food venues, in the United States, 1 is < $10 an entree, 2 is $10-$20 an entree, 3 is $20-$30 an entree, 4 is > $30 an entree.
sortByDistanceBOOLEAN
OPTIONALBoolean flag to sort the results by distance instead of relevance. Example: `1`
friendVisitsSELECT
OPTIONALPass `visited` or `notvisited` to limit results to places the acting user's friends have or haven't been, respectively. Omitting this parameter returns a mixture of venues to which the user's friends have or haven't been.
savedBOOLEAN
OPTIONALBoolean flag to only include venues that the user has saved on their To-Do list or to another list.
altitudeNUMBER
OPTIONALAltitude of the user's location, in meters. (Does not currently affect search results.)
nearSTRING
OPTIONALRequired unless location is provided: A string naming a place in the world. If the near string is not geocodable, returns a failed_geocode error. Otherwise, searches within the bounds of the geocode. Adds a geocode object to the response. (Required for query searches)
lastVenueSTRING
OPTIONALA venue ID to use in combination with the intent=nextVenues parameter, which returns venues users often visit after a given venue. If intent=nextVenues is specified but lastVenue is not, the user's last check-in will be used if it is within 2 hours. If the user has not checked in within the last 2 hours, no results will be returned.
offsetSTRING
OPTIONALUsed to page through results.
sectionSELECT
OPTIONALOne of `food`, `drinks`, `coffee`, `shops`, `arts`, `outdoors`, `sights`, `trending` or `specials`, `nextVenues` (venues frequently visited after a given venue), or topPicks (a mix of recommendations generated without a query from the user). Choosing one of these limits results to venues with the specified category or property.
daySTRING
OPTIONALPass `any` to retrieve results for any day of the week. Omitting this parameter returns results targeted to the current day of the week.
querySTRING
OPTIONALA search term to be applied against venue names.
Code Snippet
Install SDK
Response ExampleSchema

Install SDK for (Node.js)Unirest

OAuth2 Authentication
Client ID
Client Secret
OAuth2 Authentication