Foursquare

Learn how to use Foursquare with Composio

Overview

Enum

FOURSQUARE

Description

Search for places and place recommendations from the Foursquare Places database

Authentication Details

api_key
stringRequired

Actions

Retrieves 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.

Action Parameters

fsq_id
stringRequired
limit
integer
sort
string
classifications
string

Action Response

data
object
successful
boolean
error

The 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.

Action Parameters

fields
string
ll
string
hacc
integer
altitude
integer
limit
integer

Action Response

data
object
successful
boolean
error

The 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.

Action Parameters

query
string
ll
string
radius
integer
exclude_all_chains
boolean
fields
string
min_price
integer
max_price
integer
open_at
string
open_now
boolean
ne
string
sw
string
near
string
limit
integer
super_venue_id
string

Action Response

data
object
successful
boolean
error

Retrieves user-generated tips for a specific place in the foursquare database. this endpoint allows you to fetch valuable insights and experiences shared by foursquare users about a particular venue. it’s useful for enhancing location-based applications with real user feedback, helping users make informed decisions about places they might visit. the endpoint returns a list of tips, which may include information such as the tip text, the user who created it, and potentially a timestamp or rating.

Action Parameters

fsq_id
stringRequired
limit
integer
fields
string
sort
string

Action Response

data
object
successful
boolean
error

Retrieves 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.

Action Parameters

fsq_id
stringRequired
fields
string

Action Response

data
object
successful
boolean
error