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
POSTsearchVenues

Returns a list of venues near the current location, optionally matching a search term.

Header Parameters
X-RapidAPI-HostSTRING
REQUIRED
X-RapidAPI-KeySTRING
REQUIRED
Required Parameters
clientIdCREDENTIALS
REQUIREDApplication client id.
clientSecretCREDENTIALS
REQUIREDApplication client secret key.
Optional Parameters
locationMAP
OPTIONALRequired unless near is provided: Latitude and longitude of the user's location. Format: `lat,lng`. Example: `40.7,-74`
altitudeAccuracyFLOAT
OPTIONALAccuracy of the user's altitude, in meters. (Does not currently affect search results.)
urlSTRING
OPTIONALA third-party URL which we will attempt to match against our map of venues to URLs.
locationAccuracyFLOAT
OPTIONALAccuracy of latitude and longitude, in meters. (Does not currently affect search results.)
northEastSTRING
OPTIONALSee `southWest`.
radiusNUMBER
OPTIONALLimit results to venues within this many meters of the specified location. Defaults to a city-wide area. Only valid for requests with intent=browse, or requests with intent=checkin and categoryId or query. Does not apply to match intent requests. The maximum supported radius is currently 100,000 meters.
linkedIdSTRING
OPTIONAL1002207971611 Identifier used by third party specified in `providerId`, which we will attempt to match against our map of venues to URLs.
limitSTRING
OPTIONALNumber of results to return, up to 50.
altitudeNUMBER
OPTIONALAltitude of the user's location, in meters. (Does not currently affect search results.)
providerIdSTRING
OPTIONALIdentifier for a known third party that is part of our map of venues to URLs, used in conjunction with `linkedId`.
querySTRING
OPTIONALA search term to be applied against venue names.
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)
intentSTRING
OPTIONALOne of the values below, indicating your intent in performing the search. If no value is specified, defaults to `checkin`. See README for more info.
southWestSTRING
OPTIONALExample: `44.3,37.2`. With northEast, limits results to the bounding quadrangle defined by the latitude and longitude given by sw as its south-west corner, and ne as its north-east corner. The bounding quadrangle is only supported for intent=browse searches. Not valid with ll or radius. Bounding quadrangles with an area up to approximately 10,000 square kilometers are supported.
categoryIdSTRING
OPTIONALA comma separated list of categories to limit results to. If you specify categoryId specifying a radius may improve results. If specifying a top-level category, all sub-categories will also match the query. Does not apply to match intent requests.
Code Snippet
Install SDK
Response ExampleSchema

Install SDK for (Node.js)Unirest

OAuth2 Authentication
Client ID
Client Secret
OAuth2 Authentication