# Foursquare Foursquare provides location-based search and discovery, offering detailed venue information, place recommendations, and geospatial data for businesses and points of interest worldwide - **Category:** analytics - **Auth:** API_KEY - **Composio Managed App Available?** N/A - **Tools:** 5 - **Triggers:** 0 - **Slug:** `FOURSQUARE` - **Version:** 20260211_00 ## Tools ### Retrieve nearby places v3 **Slug:** `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. 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. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `ll` | string | No | The latitude/longitude around which to retrieve place information. This must be specified as latitude,longitude (e.g., ll=41.8781,-87.6298). If you do not specify ll, the server will attempt to retrieve the IP address from the request, and geolocate that IP address. | | `hacc` | integer | No | The estimated horizontal accuracy radius in meters of the user's location at the 68th percentile confidence level as returned by the user's cell phone OS. | | `limit` | integer | No | The number of results to return, up to 50. Defaults to 10. | | `fields` | string | No | Indicate which fields to return in the response, separated by commas. Core fields include: fsq_id, name, geocodes (main and other lat/lng coordinates for place), location, categories, chains, timezone, distance, and link (to place detail). Rich data fields include: description, tel (phone), fax, email, website, social_media, hours, hours_popular, rating, stats, popularity, price, menu, date_closed, photos, tips (mini reviews), tastes, and features (e.g., wifi, reservations). If no fields are specified, all Core Fields are returned by default. | | `altitude` | integer | No | The altitude of the user's location in meters above the World Geodetic System 1984 (WGS84) reference ellipsoid as returned by the user's cell phone OS. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Retrieve place photos by id **Slug:** `FOURSQUARE_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. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `sort` | string ("POPULAR" | "NEWEST") | No | Specifies the order in which results are listed. Possible values are: