# Foursquare Search

## Overview

| Property | Value |
|----------|-------|
| **Status** | private |
| **Method** | `GET` |
| **Endpoint** | `/v2/foursquare/search` |
| **Base URL** | `https://api.piloterr.com` |
| **Credit Cost** | 1 credit per call |
| **Documentation** | https://www.piloterr.com/library/foursquare-search |

## Description

Unlock city data with Foursquare Search API for travel planning, marketing, academic research, and market analysis.

## Authentication

- **Key Name:** `x-api-key`
- **Location:** HTTP Header
- **Get an API key:** https://app.piloterr.com/register

## Example Request

```bash
curl --location --request GET 'https://api.piloterr.com/v2/foursquare/search' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY'
```

## Example Response

### Example

```json
{
  "city_guides": [
    {
      "url": "https://fr.foursquare.com/city-guide/new-york-city",
      "name": "New York City Guide"
    },
    {
      "url": "https://fr.foursquare.com/city-guide/san-francisco",
      "name": "San Francisco Guide"
    },
    {
      "url": "https://fr.foursquare.com/city-guide/chicago",
      "name": "Chicago Guide"
    },
    {
      "url": "https://fr.foursquare.com/city-guide/los-angeles",
      "name": "Los Angeles Guide"
    },
    {
      "url": "https://fr.foursquare.com/city-guide/las-vegas",
      "name": "Las Vegas Guide"
    },
    {
      "url": "https://fr.foursquare.com/city-guide/miami",
      "name": "Miami Guide"
    },
    {
      "url": "https://fr.foursquare.com/city-guide/paris",
      "name": "Paris Guide"
    },
    {
      "url": "https://fr.foursquare.com/city-guide/london",
      "name": "London Guide"
    },
    {
      "url": "https://fr.foursquare.com/city-guide/barcelona",
      "name": "Barcelona Guide"
    },
    {
      "url": "https://fr.foursquare.com/city-guide/berlin",
      "name": "Berlin Guide"
    },
    {
      "url": "https://fr.foursquare.com/city-guide/tokyo",
      "name": "Tokyo Guide"
    },
    {
      "url": "https://fr.foursquare.com/city-guide/seoul",
      "name": "Seoul Guide"
    },
    {
      "url": "https://fr.foursquare.com/city-guide/sydney",
      "name": "Sydney Guide"
    },
    {
      "url": "https://fr.foursquare.com/city-guide/cape-town",
      "name": "Cape Town Guide"
    }
  ]
}
```

## Documentation

## Overview
Unlock city data with Foursquare Search API for travel planning, marketing, academic research, and market analysis.

## Quickstart
```
GET https://api.piloterr.com/v2/foursquare/search?query=example
```

## Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| `query` | string | yes | Search query or target identifier |

## Main use cases
- Integrate Foursquare Search data into enrichment, analytics, and monitoring pipelines
- Automate large-scale extraction from Foursquare without maintaining scrapers
- Power internal dashboards and workflow automations with live Foursquare data