Skip to main content

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.

  1. Go to Organization > Connectors and find Foursquare. Click Enable, and choose which tools to allow.
  2. Create an OAuth application in the Foursquare developer portal.
  3. Add the Redirect URI shown in the connector settings to the application.
  4. Copy the application's Client ID and Client Secret into the connector, then save it.
  5. 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.

ToolWhat it does
autocompleteAutocomplete for venues and places.
get_categoriesGet all venue categories as a hierarchical tree with IDs and names.
get_checkinGet checkin details including venue, shout, likes, and comments.
get_listGet list details including items (venues).
get_recommendationsGet venue recommendations near a location, optionally filtered by query.
get_selfGet the authenticated user's profile including name, home city, checkin/list/tip counts.
get_self_checkinsGet the authenticated user's checkin history with pagination.
get_self_listsGet the authenticated user's lists.
get_self_tastesGet the authenticated user's taste preferences (e.g., 'craft beer', 'sushi', 'live music').
get_self_tipsGet tips the authenticated user has written.
get_tipGet tip details including text, venue, author, and likes.
get_trending_venuesGet trending venues near a lat/lng coordinate.
get_venueGet venue details by ID including location, categories, ratings, hours, and stats.
get_venue_attributesGet venue attributes like outdoor seating, Wi-Fi, live music, parking, and more.
get_venue_hoursGet operating hours for a venue with timeframes and open/close times.
get_venue_photosGet photos for a venue.
get_venue_tipsGet tips for a venue.
search_venuesSearch venues by location+query.
validate_credentialValidate Foursquare credentials by fetching the current user profile.

Write (4)​

Create or send data.

ToolWhat it does
add_list_itemAdd a venue to a list.
add_tipAdd a tip to a venue (max 200 chars).
create_checkinCheck in at a venue.
create_listCreate a new Foursquare list.

Delete or overwrite (5)​

Remove or replace existing data.

ToolWhat it does
delete_checkinDelete a checkin.
delete_listDelete a list.
delete_list_itemRemove an item from a list.
delete_tipDelete a tip.
update_listUpdate a list's name, description, or collaborative setting.
⌘J