← Tools Reference

Foursquare

Foursquare integration (Location, Data). Imported from open-connector.

API key5 toolshttps://api.foursquare.com
GET
foursquare_search_places
Search for places with the Foursquare Places Search endpoint.

/v3/places/search

12 parameters
ParamTypeRequiredDescription
querystringoptionalThe free-form place query.
nearstringoptionalThe locality text used for search biasing.
latitudenumberoptionalThe latitude coordinate in decimal degrees.
longitudenumberoptionalThe longitude coordinate in decimal degrees.
radiusintegeroptionalThe search radius in meters.
limitintegeroptionalThe maximum number of results to return.
fieldsarrayoptionalThe Foursquare response fields to request.
openNowbooleanoptionalWhether to restrict results to places currently open.
openAtstringoptionalThe local day and time filter in `DOWTHHMM` format.
minPriceintegeroptionalThe minimum Foursquare price tier.
maxPriceintegeroptionalThe maximum Foursquare price tier.
excludeAllChainsbooleanoptionalWhether to exclude all known chain places from the response.
GET
foursquare_get_nearby_places
Retrieve nearby places around a latitude and longitude with Foursquare.

/v3/places/nearby

6 parameters
ParamTypeRequiredDescription
latitudenumberrequiredThe latitude coordinate in decimal degrees.
longitudenumberrequiredThe longitude coordinate in decimal degrees.
haccintegeroptionalThe horizontal accuracy radius in meters.
altitudeintegeroptionalThe altitude in meters.
limitintegeroptionalThe maximum number of nearby places to return.
fieldsarrayoptionalThe Foursquare response fields to request.
GET
foursquare_get_place
Retrieve one place by Foursquare place ID.

/v3/places/{fsqId}

2 parameters
ParamTypeRequiredDescription
fsqIdstringrequiredThe unique Foursquare place identifier.
fieldsarrayoptionalThe Foursquare response fields to request.
GET
foursquare_get_place_photos
Retrieve photos for one Foursquare place.

/v3/places/{fsqId}/photos

4 parameters
ParamTypeRequiredDescription
fsqIdstringrequiredThe unique Foursquare place identifier.
sortstringoptionalThe ordering applied to photos or tips.
limitintegeroptionalThe maximum number of photos to return.
classificationsarrayoptionalThe photo classifications used to filter the response.
GET
foursquare_get_place_tips
Retrieve tips for one Foursquare place.

/v3/places/{fsqId}/tips

4 parameters
ParamTypeRequiredDescription
fsqIdstringrequiredThe unique Foursquare place identifier.
sortstringoptionalThe ordering applied to photos or tips.
limitintegeroptionalThe maximum number of tips to return.
fieldsarrayoptionalThe Foursquare response fields to request.