Foursquare
Search venues, manage checkins, lists, and tips using the Foursquare API.
Categories: Location, Social
What you can ask
- Find coffee shops near the SF office with a 4+ rating, open right now.
- List sushi restaurants within 1km of 1600 Pennsylvania Ave with takeout.
- Show me the most popular venues in the Mission this weekend.
Set up
Foursquare needs an OAuth application from your organization before anyone can connect. An organization admin completes these steps once.
- Go to Organization > Connectors and find Foursquare. Click Enable, and choose which tools to allow.
- Create an OAuth application in the Foursquare developer portal.
- Add the Redirect URI shown in the connector settings to the application.
- Copy the application's Client ID and Client Secret into the connector, then save it.
- Each member connects their own account the first time they use it.
⚠️ Warning: Do not enter your Devs.ai or Foursquare login email or password in the OAuth application fields.
To use one account for the whole organization, turn on Share one connection with everyone. Every member's agents then act as that account, with exactly the access it has.
Tools
Foursquare offers 28 tools. Admins choose which ones agents can use. See Tool permission groups.
Read (19)
View and search information without changing it.
| Tool | What it does |
|---|---|
autocomplete | Autocomplete for venues and places. |
get_categories | Get all venue categories as a hierarchical tree with IDs and names. |
get_checkin | Get checkin details including venue, shout, likes, and comments. |
get_list | Get list details including items (venues). |
get_recommendations | Get venue recommendations near a location, optionally filtered by query. |
get_self | Get the authenticated user's profile including name, home city, checkin/list/tip counts. |
get_self_checkins | Get the authenticated user's checkin history with pagination. |
get_self_lists | Get the authenticated user's lists. |
get_self_tastes | Get the authenticated user's taste preferences (e.g., 'craft beer', 'sushi', 'live music'). |
get_self_tips | Get tips the authenticated user has written. |
get_tip | Get tip details including text, venue, author, and likes. |
get_trending_venues | Get trending venues near a lat/lng coordinate. |
get_venue | Get venue details by ID including location, categories, ratings, hours, and stats. |
get_venue_attributes | Get venue attributes like outdoor seating, Wi-Fi, live music, parking, and more. |
get_venue_hours | Get operating hours for a venue with timeframes and open/close times. |
get_venue_photos | Get photos for a venue. |
get_venue_tips | Get tips for a venue. |
search_venues | Search venues by location+query. |
validate_credential | Validate Foursquare credentials by fetching the current user profile. |
Write (4)
Create or send data.
| Tool | What it does |
|---|---|
add_list_item | Add a venue to a list. |
add_tip | Add a tip to a venue (max 200 chars). |
create_checkin | Check in at a venue. |
create_list | Create a new Foursquare list. |
Delete or overwrite (5)
Remove or replace existing data.
| Tool | What it does |
|---|---|
delete_checkin | Delete a checkin. |
delete_list | Delete a list. |
delete_list_item | Remove an item from a list. |
delete_tip | Delete a tip. |
update_list | Update a list's name, description, or collaborative setting. |