Foursquare

analytics 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 Visit Foursquare

About this integration

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.

Connect Foursquare to Definable and it becomes a set of typed tools your agents plan with — triggered by events, run on schedules, or invoked mid-conversation. Every write is checked by the verifier before it lands.

Auth OAuth2 · 2 clicks

Tools 5 exposed

Plans All, incl. Free

Data Never trained on

Foursquare · in workflows

What teams actually run.

Three patterns teams run with Foursquare on day one. Each one is a plain-English prompt — no canvas, no glue code — and you can remix them into anything.

Weekly anomaly digest

│ Query metrics from this tool

│ Compare against rolling baseline

└ Surface anomalies with reasoning

Funnel deep-dive

│ Pull funnel events for a date range

│ Compute drop-offs at each step

└ Generate a written analysis

Cohort answers on demand

│ User asks a question in chat

│ Agent translates it to a query

└ Returns numbers + a chart-ready summary

5 tools available

The Foursquare toolbox.

Every Foursquare capability your agents can call, each with a typed schema the planner reads. The router picks the right tool per step; the verifier checks the result.

Retrieve nearby places v3

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.

Retrieve place photos by id

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.

Retrieve places by id

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.

Retrieve place tips using fsq id

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.

Search places api request

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.

See it run

One prompt, start to finish.

A real prompt, the Foursquare tools it calls, and what comes back. This is the whole interface — describe the outcome, agents handle the rest.

❯

Run a real Foursquare task end-to-end — plan it, execute across the API, and hand back a verified result.

foursquare.retrieve_nearby_places_v3 The GetNearbyPlaces endpoint retrieves a list of places near a specified location, primari

foursquare.retrieve_place_photos_by_id Retrieves photos associated with a specific place in Foursquare's database. This endpoint

foursquare.retrieve_places_by_id Retrieves detailed information about a specific place using its unique Foursquare ID (FSQ · verified

done

Done. Foursquare responded across 3 calls, the verifier signed off, and the result is logged with every payload.

FAQ · Foursquare

Questions, answered.

What teams ask before connecting Foursquare.

01 What can I automate with Foursquare on Definable?

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.

02 How does Foursquare authentication work?

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.

03 Is the Foursquare integration included in my Definable plan?

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.

04 Is using Foursquare through Definable secure?

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.

05 How do I get started with Foursquare on Definable?

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.

06 What Foursquare actions does Definable expose?

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.