> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pinkfish.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# foursquare

> Foursquare Places

**Server path:** `/foursquare` | **Type:** Application | **PCID required:** Yes

## Tools

| Tool                                                                            | Description                            |
| ------------------------------------------------------------------------------- | -------------------------------------- |
| [`foursquare_get_geotagging_candidates`](#foursquare_get_geotagging_candidates) | Get geotagging candidates (place snap) |
| [`foursquare_get_place_details`](#foursquare_get_place_details)                 | Get place details                      |
| [`foursquare_search_places`](#foursquare_search_places)                         | Search for places                      |

***

## foursquare\_get\_geotagging\_candidates

Get geotagging candidates (place snap)

**Parameters:**

| Parameter | Type    | Required | Default | Description                                                                  |
| --------- | ------- | -------- | ------- | ---------------------------------------------------------------------------- |
| `ll`      | string  | Yes      | —       | Latitude and longitude as a comma-separated string (e.g. '40.7128,-74.0060') |
| `limit`   | integer | No       | —       | Maximum number of candidates to return (default 1)                           |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "ll": {
        "type": "string",
        "description": "Latitude and longitude as a comma-separated string (e.g. '40.7128,-74.0060')"
      },
      "limit": {
        "type": "integer",
        "description": "Maximum number of candidates to return (default 1)"
      }
    },
    "required": [
      "PCID",
      "ll"
    ]
  }
  ```
</Expandable>

***

## foursquare\_get\_place\_details

Get place details

**Parameters:**

| Parameter | Type   | Required | Default | Description                                                                                                                                                                                                                                                                                            |
| --------- | ------ | -------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `fsq_id`  | string | Yes      | —       | Foursquare place ID (e.g. '4bf58dd8d48988d1e0931735')                                                                                                                                                                                                                                                  |
| `fields`  | string | No       | —       | Comma-separated list of fields to return. Available fields: description, tel, website, social\_media, hours, hours\_popular, rating, price, menu, photos, tips, tastes, attributes, features, location, categories, chains, name, timezone, email, fax, geocodes, related\_places, date\_closed, stats |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "fsq_id": {
        "type": "string",
        "description": "Foursquare place ID (e.g. '4bf58dd8d48988d1e0931735')"
      },
      "fields": {
        "type": "string",
        "description": "Comma-separated list of fields to return. Available fields: description, tel, website, social_media, hours, hours_popular, rating, price, menu, photos, tips, tastes, attributes, features, location, categories, chains, name, timezone, email, fax, geocodes, related_places, date_closed, stats"
      }
    },
    "required": [
      "PCID",
      "fsq_id"
    ]
  }
  ```
</Expandable>

***

## foursquare\_search\_places

Search for places

**Parameters:**

| Parameter    | Type    | Required | Default | Description                                                                                                 |
| ------------ | ------- | -------- | ------- | ----------------------------------------------------------------------------------------------------------- |
| `query`      | string  | No       | —       | Search query term (e.g. 'coffee', 'pizza', 'museum')                                                        |
| `near`       | string  | No       | —       | A text location to search near (e.g. 'New York', 'London, UK', '123 Main St'). Use this OR 'll', not both.  |
| `ll`         | string  | No       | —       | Latitude and longitude as a comma-separated string (e.g. '40.7128,-74.0060'). Use this OR 'near', not both. |
| `radius`     | integer | No       | —       | Search radius in meters (max 100000). Only used with 'll'.                                                  |
| `categories` | string  | No       | —       | Comma-separated list of Foursquare category IDs to filter results                                           |
| `limit`      | integer | No       | —       | Maximum number of results to return (1-50, default 10)                                                      |
| `sort`       | string  | No       | —       | Sort order for results                                                                                      |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "query": {
        "type": "string",
        "description": "Search query term (e.g. 'coffee', 'pizza', 'museum')"
      },
      "near": {
        "type": "string",
        "description": "A text location to search near (e.g. 'New York', 'London, UK', '123 Main St'). Use this OR 'll', not both."
      },
      "ll": {
        "type": "string",
        "description": "Latitude and longitude as a comma-separated string (e.g. '40.7128,-74.0060'). Use this OR 'near', not both."
      },
      "radius": {
        "type": "integer",
        "description": "Search radius in meters (max 100000). Only used with 'll'."
      },
      "categories": {
        "type": "string",
        "description": "Comma-separated list of Foursquare category IDs to filter results"
      },
      "limit": {
        "type": "integer",
        "description": "Maximum number of results to return (1-50, default 10)"
      },
      "sort": {
        "type": "string",
        "description": "Sort order for results",
        "enum": [
          "relevance",
          "rating",
          "distance"
        ]
      }
    },
    "required": [
      "PCID"
    ]
  }
  ```
</Expandable>