---
title: "Foursquare integration for LuumenAI"
url: "https://www.luumen.ai/integrations/foursquare/"
entity: SoftwareIntegration
category: "Databases & data platforms"
audience: "SRE, DevOps, platform engineering, IT operations"
---

# Foursquare integration for LuumenAI

Look up venues, nearby places, and location detail without leaving the terminal

## What LuumenAI can do with Foursquare

LuumenAI connects to Foursquare with an API token and exposes 8 tools (8 read-only). Every tool is read-only, so it can answer questions from Foursquare but cannot change anything in it. Read actions still follow the configured access and approval policy.

## Key facts

- Authentication: API token
- Tools available: 8 tools (8 read-only)
- Deployment: scoped as part of your Pilot, Platform, or Managed rollout
- Category: Databases & data platforms

## About Foursquare with LuumenAI

Ask about a place and get an answer in the terminal. Luumen searches Foursquare with FOURSQUARE_SEARCH_PLACES_API_REQUEST, pulls detail by ID with FOURSQUARE_RETRIEVE_PLACES_BY_ID, and lists what is close by with FOURSQUARE_RETRIEVE_NEARBY_PLACES_V3. This integration is read-only: eight tools, no writes. Connect it with an API key.

## Example tools

Read-only (8 in total):

- `FOURSQUARE_AUTOCOMPLETE_PLACES` — Returns autocomplete suggestions for places as the user types their search query.
- `FOURSQUARE_GET_TRENDING_VENUES` — Retrieves venues currently trending in a specified geographic area, sorted by popularity based on recent foot traffic and activity patterns.
- `FOURSQUARE_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.
- `FOURSQUARE_RETRIEVE_PLACE_PHOTOS_BY_ID` — Retrieves photos associated with a specific place in Foursquare's database.
- `FOURSQUARE_RETRIEVE_PLACES_BY_ID` — Retrieves detailed information about a specific place using its unique Foursquare ID (FSQ ID).
- `FOURSQUARE_RETRIEVE_PLACE_TIPS_USING_FSQ_ID` — Retrieves user-generated tips for a specific place in the Foursquare database.
- `FOURSQUARE_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.
- `FOURSQUARE_VALIDATE_CREDENTIAL` — Validates Foursquare API credentials by performing a lightweight place search.

## Frequently asked questions

### How does LuumenAI connect to Foursquare?

Authorize once with API token. Luumen lists the scopes each action needs before you approve the connection, and credentials never appear in the chat.

### Can LuumenAI change things in Foursquare on its own?

No. Every one of the 8 tools is read-only, so LuumenAI can answer questions from Foursquare but cannot change anything in it. Read actions still follow the configured access and approval policy.

### Is there an audit trail?

Every call to Foursquare is recorded with the actor, the input, and the result.

Full page: https://www.luumen.ai/integrations/foursquare/