Foursquare

Returns autocomplete suggestions for places as the user types their search query. This endpoint provides real-time search suggestions including places, search terms, and geographic areas. Use this action when you need to provide typeahead/autocomplete functionality for place searches, typically after a user has entered at least 3 characters. The results are optimized for interactive search experiences and include text highlighting to show matched portions of the query.

Retrieves venues currently trending in a specified geographic area, sorted by popularity based on recent foot traffic and activity patterns. This action identifies places experiencing increased visitor engagement over a 6-month period, making it ideal for discovering what's hot and popular right now in a given location. The popularity metric ranges from 0 to 1, with higher values indicating stronger trending status based on real-world visitation data. Use this action when you need to find popular venues, discover trending spots, or identify places with high current engagement in a specific area. This is particularly useful for recommendations, local discovery features, or understanding which venues are currently experiencing peak popularity.

Validates Foursquare API credentials by performing a lightweight place search. This action verifies that the provided API key is valid and has proper access to the Foursquare Places API. Use this action when you need to test API connectivity or confirm that authentication credentials are correctly configured before performing other operations. The action returns a success indicator along with the count of places retrieved from a test search, confirming both authentication and API access.

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 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.

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.

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.