Skip to content
Changelog

Report a bug

Foursquare integration: operations for AI agents

Foursquare connects to Type.com as an integration. This page lists the 57 operations documented for Claude and Codex in Type.com: 35 read, 16 write, 6 destructive.

About Foursquare

Foursquare provides location-based search and discovery, offering detailed venue information, place recommendations, and geospatial data for businesses and points of interest worldwide

Categories: Analytics & Data

How to connect Foursquare to Type.com

Access
Organization connection: one shared account for the workspace.

To add the connection, follow the steps in Space connections.

Documented operations

57 operations. Your connection's permissions determine which operations are available. API references describe the vendor surface; they do not expand your connection's credentials or access.

57 operations listed.

Search & Data

  • Read

    Get Place Tips

    Retrieve tips for a FSQ Place using the fsqid.

  • Read

    Place Match

    Return the Foursquare record of a POI (via fsqid) given a name and location.

Geotagging & Check in

  • Read

    Find Nearby Places

    Utilize Foursquare's Snap to Place technology to detect where your user's device is and what is around them. The endpoint is designed to provide POI tagging that supports a check-in use case. It will intentionally return lower quality results not found in Place Search.

  • Write

    Report Nearby Place Selection

    Report the selection of a place as the result of a Nearby Places request.

Address Data

  • Read

    Get Address Details

    Retrieve details for any address including non-Places. For addresses that do include FSQ Places, the response will include a directory field that contains a list of said FSQ Places.

Places Feedback

  • Read

    Get Feedback Status

    Monitor the status of the feedback items provided by your users.

  • Write

    Flag Problematic Place

    Provide Feedback about a problematic Place due to a variety of reasons such as closed, and mislocated via its fsqid.

  • Write

    Propose Place Edit

    Propose edits to an existing Place’s information such as address, phone number, and hours of operation via its fsqid. Providing values for the parameters below constitue the proposed edit.

Places

  • Read

    Place Details

    Retrieve comprehensive information and metadata for a FSQ Place using the fsqid.

  • Read

    Place Photos

    Retrieve photos for a FSQ Place using the fsqid. To retrieve photos from a Photos response, learn how to assemble photo URLs.

  • Read

    Place Tips

    Retrieve tips for a FSQ Place using the fsqid.

Checkins

  • Read

    Get Check-in Details

    Get the details of a user's check-in.

  • Write

    Create Check-in

    Allow a user to create a check-in.

  • Write

    Update Checkin

    Allows the acting user to edit their check-ins after the fact.

  • Destructive

    Delete Check-in

    Remove a check-in, if the acting user is the owner of the check-in.

Lists

  • Read

    Get List Details

    Get details of the user's list.

  • Read

    Suggest List Venues

    Retrieve venue suggestions related to current list venues.

  • Write

    Create List

    Allow a user to create a list.

  • Write

    Add List Item

    Add an item to the list, if the acting user is the author or the owner of the list.

  • Write

    Update List

    Allows the acting user to edit their lists.

  • Destructive

    Delete List

    Delete a list, if the acting user is the owner of the list.

  • Destructive

    Delete List Item

    Delete an item to the list, if the acting user is the author or the owner of the list.

Photos

  • Read

    Get Photo Details

    Get the details of a photo associated with a venue.

Search

  • Read

    Search Venue Recommendations

    Get recommended venues based on the user's query and location.

  • Read

    Search Nearby Venues

    Search for venues near a user's location based on a set radius.

Tastes

  • Read

    Autocomplete Tastes

    Show autocompleted tastes based on user's taste search query.

  • Read

    Get Taste Suggestions

    Show taste suggestions to the user for selection.

  • Write

    Add Taste

    This endpoint should be used in conjunction with either of the following endpoints: - Autocomplete Tastes - Get Taste Suggestions Once a tasteid has been returned, use the ID in the call to add it to the user's profile.

  • Destructive

    Delete Taste

    Allow a user to delete a taste from their profile.

Tips

  • Read

    Get Tip Details

    Get details of the tip/review.

  • Write

    Vote Tip

    Allows a user to vote on a tip.

  • Write

    Add Tip

    Allow a user to add a tip/review.

  • Write

    Flag Tip

    Allows users to indicate a tip/review is probelmatic in some way.

  • Destructive

    Delete Tip

    Delete a tip/review, if the acting user is the owner of the tip/review.

User Management

  • Read

    Check User Data Request Status

    Check the status of either a Managed User Delete request or a Managed User Data Retrieval request. This endpoint returns the following possible values based on the status of your request; pending, completed, and expired.

  • Write

    Create Managed User

    Create a managed Foursquare user for your application. This endpoint should be called any time your application registers a new user. NOTE: This endpoint requires a Foursquare Service API Key to authenticate. Learn how to create a Service API Key.

  • Write

    Request Managed User Data

    Request all of the data stored in Foursquare's database associated with a managed user in response to an end user's request to access their personal data.

  • Write

    Refresh Managed User Token

    Refresh a Foursquare managed user's oauth token.

  • Destructive

    Delete Managed User

    Delete a manager user's record from the Foursquare database in response to an end user's request to delete their personal data.

Users

  • Read

    Get User Details

    Return profile information for the user whose oauthtoken is provided.

  • Read

    Get User Activities

    A log of activities for the user whose oauthtoken is provided.

  • Read

    Get User Checkins

    Get the history of checkins for the user whose oauthtoken is provided.

  • Read

    Get User Lists

    Get lists for the user whose oauthtoken is provided.

  • Read

    Get User Tastes

    Get the tastes for the user whose oauthtoken is provided.

  • Read

    Get User Tips

    Get the tips/reviews for the user whose oauthtoken is provided.

Venues

  • Read

    Get Venue Categories

    Get the entire list of categories that can be applied to a venue.

  • Read

    Get Venue Details

    Get the details - e.g. location and contact information - of the venue specified.

  • Read

    Get Venue Attributes

    Get attributes - e.g. price, reservations, payment options - for the specified venue.

  • Read

    Get Venue Hours

    Get the operating hours for the specified venue.

  • Read

    Get Venue Photos

    Get the photos associated with the specified venue.

  • Read

    Get Venue Tips

    Get the tips (i.e. reviews) of the specified venue.

  • Write

    Rate Venue

    Allow a user to rate a venue; i.e. dislike/average/like.

See How connections work for access and permissions, or browse all integrations.