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
POSTproposeVenueChange

If the user knows the correct venue information, use this method to save it. Otherwise, use flag to flag the venue instead (you need not specify new venue info in that case).

Header Parameters
X-RapidAPI-HostSTRING
REQUIRED
X-RapidAPI-KeySTRING
REQUIRED
Required Parameters
accessTokenSTRING
REQUIREDAccess Token obtained from Foursquare OAuth.
venueIdSTRING
REQUIREDThe venue id for which an edit is being proposed.
Optional Parameters
stateSTRING
OPTIONALThe nearest state or province to the venue.
phoneSTRING
OPTIONALThe phone number of the venue.
crossStreetSTRING
OPTIONALThe nearest intersecting street or streets.
nameSTRING
OPTIONALThe name of the venue.
descriptionSTRING
OPTIONALA freeform description of the venue, up to 300 characters.
addCategoryIdsSTRING
OPTIONALComma-separated list of new category IDs to be assigned to this venue. If you are adding a new category to a venue and you want to make it primary, you should just use primaryCategoryId.
venueLocationMAP
OPTIONALLatitude and longitude at which the venue should be located. Example: `44.3,37.2`
menuUrlSTRING
OPTIONALA url where the menu of the venue can be found.
hoursSTRING
OPTIONALThe hours for the venue, as a semi-colon separated list of open segments and named segments (e.g., brunch or happy hour). Open segments are formatted as day,start,end. Named segments additionally have a label, formatted as day,start,end,label. Days are formatted as integers with Monday = 1,...,Sunday = 7. Start and End are formatted as [+]HHMM format. Use 24 hour format (no colon), prefix with 0 for HH or MM less than 10. Use '+' prefix, i.e., +0230 to represent 2:30 am past midnight into the following day.
twitterSTRING
OPTIONALThe twitter handle of the venue.
facebookUrlSTRING
OPTIONALThe url for this venue's Facebook Page.
citySTRING
OPTIONALThe city name where this venue is.
urlSTRING
OPTIONALThe url of the homepage of the venue.
removeCategoryIdsSTRING
OPTIONALComma-separated list of new category IDs to be removed from this venue.
addressSTRING
OPTIONALThe address of the venue.
zipSTRING
OPTIONALThe zip or postal code for the venue.
primaryCategoryIdSTRING
OPTIONALThe ID of the category to which you want to assign this venue.
Code Snippet
Install SDK
Response ExampleSchema

Install SDK for (Node.js)Unirest

OAuth2 Authentication
Client ID
Client Secret
OAuth2 Authentication