- Category: analytics
- Auth: API_KEY
- Composio-managed OAuth available? N/A
- Tools: 8
- Triggers: 0
- Slug:
FOURSQUARE - Version: 20261101_00
Tools
Autocomplete places
Autocomplete places
Slug:
FOURSQUARE_AUTOCOMPLETE_PLACESReturns autocomplete suggestions for places as the user types their search query. This endpoint provides real-time search suggestions including places, search terms, and geographic areas. Use this action when you need to provide typeahead/autocomplete functionality for place searches, typically after a user has entered at least 3 characters. The results are optimized for interactive search experiences and include text highlighting to show matched portions of the query.Input Parameters
The latitude/longitude around which you wish to retrieve place information. Specified as latitude,longitude (e.g., ll=41.8781,-87.6298). If you do not specify ll, the server will attempt to retrieve the IP address from the request, and geolocate that IP address.
The types of results to return; any combination of place, search, and/or geo. If no types are specified, all types will be returned.
Defines the distance (in meters) within which to return place results. Setting a radius biases the results to the indicated area, but may not fully restrict results to that specified area. If not provided, default radius is set to 5000 meters.
A user-generated token to group the user’s query and the user’s selected result into a discrete session for billing purposes. If the session_token parameter is omitted, the session is charged per keystroke/request.
Output
Get trending venues
Get trending venues
Slug:
FOURSQUARE_GET_TRENDING_VENUESSearches for places around specified coordinates, sorted by popularity. Supports an optional radius, result limit, and field selection for local discovery.Input Parameters
The latitude/longitude around which to retrieve trending venues. Must be specified as latitude,longitude (e.g., ll=41.8781,-87.6298)
Comma-separated list of fields to return. Core fields: fsq_place_id, name, location, categories, chains, distance, link. Rich fields: description, tel, email, website, social_media, hours, hours_popular, rating, stats, popularity, price, menu, photos, tips, tastes. If not specified, all Pro Fields are returned by default
Sets a radius distance (in meters) used to define the search area. Maximum allowed radius is 100,000 meters. If not provided, default radius of 22000 meters is applied
Output
Retrieve nearby places v3
Retrieve nearby places v3
Slug:
FOURSQUARE_RETRIEVE_NEARBY_PLACES_V3The GetNearbyPlaces endpoint retrieves a list of places near a specified location, primarily supporting check-in use cases and local discovery. It returns points of interest (POIs) including lower quality results not found in the standard Place Search, enhancing location-based experiences with additional data like photos, reviews, and tips. This endpoint is ideal for applications seeking to provide users with a comprehensive view of their surroundings, including less prominent or newer locations. While it offers a broader range of results, it may sacrifice some precision compared to more focused search endpoints. Use this when you want to offer users a diverse array of nearby options, particularly for social check-in features or exploratory local recommendations.Input Parameters
The latitude/longitude around which to retrieve place information. This must be specified as latitude,longitude (e.g., ll=41.8781,-87.6298). If you do not specify ll, the server will attempt to retrieve the IP address from the request, and geolocate that IP address.
The estimated horizontal accuracy radius in meters of the user’s location at the 68th percentile confidence level as returned by the user’s cell phone OS.
Indicate which fields to return in the response, separated by commas. Core fields include: fsq_id, name, geocodes (main and other lat/lng coordinates for place), location, categories, chains, timezone, distance, and link (to place detail). Rich data fields include: description, tel (phone), fax, email, website, social_media, hours, hours_popular, rating, stats, popularity, price, menu, date_closed, photos, tips (mini reviews), tastes, and features (e.g., wifi, reservations). If no fields are specified, all Core Fields are returned by default.
The altitude of the user’s location in meters above the World Geodetic System 1984 (WGS84) reference ellipsoid as returned by the user’s cell phone OS.
Output
Retrieve place photos by id
Retrieve place photos by id
Slug:
FOURSQUARE_RETRIEVE_PLACE_PHOTOS_BY_IDRetrieves photos associated with a specific place in Foursquare’s database. This endpoint allows you to access user-generated images for a particular point of interest (POI) using its unique Foursquare ID (fsq_id). It’s useful for enhancing your application with visual content related to locations, such as restaurants, landmarks, or businesses. The endpoint returns photo data that can be used to construct image URLs for display. Keep in mind that the number and quality of photos may vary depending on the popularity and user engagement of the place. This tool should be used when you need to display or analyze visual information about a specific location in your application.Input Parameters
Specifies the order in which results are listed. Possible values are:<ul><li>popular (default) - sorts results based on their popularity among Foursquare users, newest - sorts results from most recently added to least recently added
The specified number of photos per page. Returns 10 photos by default, up to a maximum number of 50.
A unique string identifier for a FSQ Place (formerly known as Venue ID). E.g., Foursquare HQ”s fsq_id = 5a187743ccad6b307315e6fe
Restricts the results to photos matching the specified classifications, separated by a comma. Possible values are: food - photos of food, indoor - photos of indoors, menu - photos of menus, outdoor - photos of storefronts, outdoors, and exteriors
Output
Retrieve places by id
Retrieve places by id
Slug:
FOURSQUARE_RETRIEVE_PLACES_BY_IDRetrieves detailed information about a specific place using its unique Foursquare ID (FSQ ID). This endpoint provides comprehensive data about a venue, including its name, address, category, ratings, tips, photos, and other relevant information. It’s particularly useful when you need in-depth details about a known location, such as for displaying venue profiles or gathering specific place attributes. The endpoint should be used when you have a valid FSQ ID and require the most up-to-date and complete information about that place. Note that this endpoint focuses on individual place details and does not provide search functionality or lists of multiple venues.Input Parameters
Indicate which fields to return in the response, separated by commas. Core fields include: fsq_id, name, geocodes (main and other lat/lng coordinates for place), location, categories, chains, timezone, distance, and link (to place detail). Rich data fields include: description, tel (phone), fax, email, website, social_media, hours, hours_popular, rating, stats, popularity, price, menu, date_closed, photos, tips (mini reviews), tastes, and features (e.g., wifi, reservations). If no fields are specified, all Core Fields are returned by default.
A unique string identifier for a FSQ Place (formerly known as Venue ID). E.g., Foursquare HQ”s fsq_id = 5a187743ccad6b307315e6fe
Output
Retrieve place tips using fsq id
Retrieve place tips using fsq id
Slug:
FOURSQUARE_RETRIEVE_PLACE_TIPS_USING_FSQ_IDRetrieves user-generated tips for a specific Foursquare place by its FSQ ID. Tips include text and a creation timestamp, with optional metadata such as language and agreement counts.Input Parameters
Specifies the order in which results are listed. Possible values are: popular (default) - sorts results based on their popularity among Foursquare users, newest - sorts results from most recently added to least recently added
The specified number of tips per page. Returns 10 tips by default, up to a maximum number of 50.
Indicate which fields to return in the response, separated by commas. Supported fields are: id - The ID of the tip to be returned, created_at - The timestamp indicating when the tip was created; UNIX timestamp in seconds since Epoch, text - The text of the returned tip, lang - The language of the returned tip, url - The URL associated with the returned tip, agree_count - The count of users who have agreed with the returned tip, disagree_count - The count of users who have disagreed with the returned tip, photo - The ID of the photo asociated with the returned tip. Default fields if this param is omitted are “id”, “created_at”, and “text”.
A unique string identifier for a FSQ Place (formerly known as Venue ID). E.g., Foursquare HQ”s fsq_id = 5a187743ccad6b307315e6fe
Output
Search places api request
Search places api request
Slug:
FOURSQUARE_SEARCH_PLACES_API_REQUESTThe GetPlacesSearch endpoint allows you to search for places in the Foursquare database based on various criteria such as location, keywords, and categories. This tool is ideal for discovering nearby points of interest or finding specific venues. It returns a list of places matching the specified parameters, providing essential information about each location. Use this endpoint for location-based features or gathering venue information in a specific area.Input Parameters
The latitude/longitude around which to retrieve place information. This must be specified as latitude,longitude (e.g., ll=41.8781,-87.6298).
The latitude/longitude representing the north/east points of a rectangle. Must be used with sw parameter to specify a rectangular search box. Global search results will be omitted.
The latitude/longitude representing the south/west points of a rectangle. Must be used with ne parameter to specify a rectangular search box. Global search results will be omitted.
A string naming a locality in the world (e.g., “Chicago, IL”). If the value is not geocodable, returns an error. Global search results will be omitted.
A string to be matched against all content for this place, including but not limited to venue name, category, telephone number, taste, and tips.
Indicate which fields to return in the response, separated by commas. Core fields include: fsq_id, name, geocodes (main and other lat/lng coordinates for place), location, categories, chains, timezone, distance, and link (to place detail). Rich data fields include: description, tel (phone), fax, email, website, social_media, hours, hours_popular, rating, stats, popularity, price, menu, date_closed, photos, tips (mini reviews), tastes, and features (e.g., wifi, reservations). If no fields are specified, all Core Fields are returned by default.
Sets a radius distance (in meters) used to define an area to bias search results. The maximum allowed radius is 100,000 meters. Radius can be used in combination with ll or ip biased geolocation only. By using radius, global search results will be omitted. If not provided, default radius applied is 22000 meters.
Support local day and local time requests through this parameter. To be specified as DOWTHHMM (e.g., 1T2130), where DOW is the day number 1-7 (Monday = 1, Sunday = 7) and time is in 24 hour format. Places that do not have opening hours will not be returned if this parameter is specified. Cannot be specified in conjunction with
open_now.Restricts results to only those places that are open now. Places that do not have opening hours will not be returned if this parameter is specified. Cannot be specified in conjunction with
open_at.Restricts results to only those places within the specified price range. Valid values range between 1 (most affordable) to 4 (most expensive), inclusive.
Restricts results to only those places within the specified price range. Valid values range between 1 (most affordable) to 4 (most expensive), inclusive.
Filters the response by only returning FSQ Places that are not known to be part of any chain.
Output
Validate API credentials
Validate API credentials
Slug:
FOURSQUARE_VALIDATE_CREDENTIALValidates Foursquare API credentials by performing a lightweight place search. This action verifies that the provided API key is valid and has proper access to the Foursquare Places API. Use this action when you need to test API connectivity or confirm that authentication credentials are correctly configured before performing other operations. The action returns a success indicator along with the count of places retrieved from a test search, confirming both authentication and API access.