Weekly anomaly digest
- Query metrics from this tool
- Compare against rolling baseline
- Surface anomalies with reasoning
5 tools available
Foursquare provides location-based search and discovery, offering detailed venue information, place recommendations, and geospatial data for businesses and points of interest worldwide
Connect Foursquare to Definable to answer ad-hoc analytics questions, detect anomalies, auto-generate weekly summaries. Personas call Foursquare's 5 tools directly from chat or scheduled flows. Plug into a data-analysis persona to ask questions in plain English — the agent runs the queries.
Every Foursquare action below is a callable tool any Definable persona can invoke.
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.
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.
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.
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.
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.
Anything Foursquare exposes through its API. Common analytics workflows on Definable include answer ad-hoc analytics questions, detect anomalies, auto-generate weekly summaries. Personas can call any of the 5 Foursquare tools directly, then chain the result into another integration without you writing code.
Foursquare uses API_KEY on Definable. You connect once from the integrations page, scoped to the permissions you choose, and from then on any persona that has the integration enabled can act on your behalf. Tokens are encrypted at rest and rotated automatically.
Yes — every Definable plan, including Starter, includes access to all 5 Foursquare tools. You only need a separate Foursquare subscription if Foursquare itself charges per seat or per API call.
Every call from a persona to Foursquare is logged with the user, persona, prompt, and response. Tokens never leave Definable's secrets vault, scopes are configurable per persona, and you can revoke access at any time from the integration page.
Sign up for Definable, open the integrations page, find Foursquare, and connect via OAuth or API key. You can immediately attach Foursquare to any persona and start running workflows. The free Starter plan includes 5,000 credits/month.
Definable exposes all 5 Foursquare actions as callable tools — including `Retrieve nearby places v3`, `Retrieve place photos by id`, `Retrieve places by id`, plus 2 more. Each tool gets a typed parameter schema so personas know exactly how to call it.
Wire it up in minutes. No coding required.