Foursquare
Authentication: OAuth. See Magic Link for the runtime auth flow, or Application credentials to bring your own OAuth app.
Sample use cases
- 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.
Available Tools
Check in at a venue. Use search_venues to find venue IDs. Optionally add a shout message.
Get checkin details including venue, shout, likes, and comments.
Delete a checkin. Only the creator can delete their own checkins.
Create a new Foursquare list. Optionally set description and collaborative mode.
Get list details including items (venues). Use get_self_lists to find list IDs.
Update a list’s name, description, or collaborative setting.
Delete a list. Only the creator can delete their own lists.
Add a venue to a list. Use search_venues for venue IDs. Optionally add text.
Remove an item from a list. Use get_list to find item IDs.
Autocomplete for venues and places. Provide query with optional ll or near for location bias.
Get venue recommendations near a location, optionally filtered by query. Provide ll or near.
Add a tip to a venue (max 200 chars). Use search_venues to find venue IDs.
Get tip details including text, venue, author, and likes.
Delete a tip. Only the author can delete their own tips.
Get the authenticated user’s profile including name, home city, checkin/list/tip counts.
Get the authenticated user’s checkin history with pagination. Filter by before/after timestamps.
Get the authenticated user’s lists. Filter by group: created, edited, followed, friends, suggested.
Get tips the authenticated user has written. Sort by recent, nearby, or popular.
Get the authenticated user’s taste preferences (e.g., ‘craft beer’, ‘sushi’, ‘live music’).
Search venues by location+query. Provide ll or near. Use get_categories for category IDs. Returns paginated results.
Get venue details by ID including location, categories, ratings, hours, and stats. Use search_venues to find IDs.
Get photos for a venue. Build URLs: prefix + {width}x{height} + suffix. Use offset for pagination.
Get tips for a venue. Sort by friends, recent, or popular. Use offset for pagination.
Get operating hours for a venue with timeframes and open/close times.
Get venue attributes like outdoor seating, Wi-Fi, live music, parking, and more.
Get all venue categories as a hierarchical tree with IDs and names. Use category IDs to filter search_venues.
Get trending venues near a lat/lng coordinate. Returns venues with high recent activity.