# Foursquare Listing

## Overview

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

## Description

Unlock local insights by extracting Foursquare listings for cafes in Toulouse. Boost analysis and decision-making with precise data.

## 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/listing' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY'
```

## Example Response

### Example

```json
{
  "locations": [
    {
      "name": "La Fiancée",
      "rating": 9.4,
      "address": "54 Rue Peyrolières, Toulouse",
      "category": "Café"
    },
    {
      "name": "No. 5 Wine Bar",
      "rating": 9.3,
      "address": "5 Rue de la Bourse, Toulouse",
      "category": "Wine Bar"
    },
    {
      "name": "Palladia",
      "rating": 9,
      "address": "271 Avenue de Grande Bretagne, Toulouse",
      "category": "Hotel Bar"
    },
    {
      "name": "Le Bibent",
      "rating": 8.8,
      "address": "5 Place du Capitole, Toulouse",
      "category": "Café"
    },
    {
      "name": "Flower’s Café",
      "rating": 8.5,
      "address": "5 Place Roger Salengro, Toulouse",
      "category": "Café"
    },
    {
      "name": "Café Den",
      "rating": 8.4,
      "address": "57 Boulevard Lazare Carnot, Toulouse",
      "category": "Café"
    },
    {
      "name": "Café de la Concorde",
      "rating": 8.3,
      "address": "17 Boulevard de Strasbourg, Toulouse",
      "category": "Café"
    },
    {
      "name": "BfM Café",
      "rating": 8.2,
      "address": "10 Rue Cujas, Toulouse",
      "category": "Café"
    },
    {
      "name": "Bar Le Troquet",
      "rating": 7.9,
      "address": "17 Rue des Pénitents Bleus, Toulouse",
      "category": "Café"
    },
    {
      "name": "Café Ginette",
      "rating": 7.8,
      "address": "28 Rue Raymond IV, Toulouse",
      "category": "Café"
    }
  ]
}
```

## Documentation

## Overview
Unlock local insights by extracting Foursquare listings for cafes in Toulouse. Boost analysis and decision-making with precise data.

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

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

## Main use cases
- Integrate Foursquare Listing 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