# Foursquare Product

## Overview

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

## Description

Unlock detailed Foursquare venue data like La Fiancée's address, ratings, and photos for richer business insights.

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

## Example Response

### Example

```json
{
  "venue": {
    "id": "5072fc40e4b0c9f5d10c1aa6",
    "url": "http://www.lafianceecafe.com",
    "menu": {
      "url": "https://foursquare.com/v/la-fiancée/5072fc40e4b0c9f5d10c1aa6/menu",
      "type": "Menu",
      "label": "Menu",
      "anchor": "View Menu",
      "mobileUrl": "https://foursquare.com/v/5072fc40e4b0c9f5d10c1aa6/device_menu"
    },
    "name": "La Fiancée",
    "hours": {
      "isOpen": true,
      "status": "Open until 6:00 PM",
      "dayData": [],
      "timezone": "Europe/Paris",
      "richStatus": {
        "text": "Open until 6:00 PM",
        "entities": []
      },
      "isLocalHoliday": false
    },
    "inbox": {
      "count": 0,
      "items": []
    },
    "price": {
      "tier": 2,
      "message": "Expensive",
      "currency": "€"
    },
    "stats": {
      "tipCount": 20,
      "usersCount": 743,
      "visitsCount": 0,
      "checkinsCount": 1070
    },
    "photos": {
      "count": 74,
      "groups": [
        {
          "name": "Venue photos",
          "type": "venue",
          "count": 74,
          "items": [
            {
              "id": "50911f49e4b02f2ba2c6f08b",
              "user": {
                "id": "13425135",
                "gender": "female",
                "lastName": "Tee",
                "photourl": "https://igx.4sqi.net/img/user/13425135-M5NMIFOI4G22FDER.jpg",
                "firstName": "Yun Mei"
              },
              "width": 537,
              "height": 720,
              "prefix": "https://fastly.4sqi.net/img/general/",
              "source": {
                "url": "https://foursquare.com/download/#/iphone",
                "name": "Foursquare for iOS"
              },
              "suffix": "/13425135_TbGvFHJu0yoz--LfEyW84oJlgnCyfMTAZLqkEfNI3SY.jpg",
              "createdAt": 1349778777,
              "visibility": "public"
            }
          ]
        }
      ]
    },
    "rating": 8.9,
    "hasMenu": true,
    "reasons": {
      "count": 3,
      "items": [
        {
          "type": "general",
          "summary": "People often mention ",
          "reasonName": "mention"
        }
      ]
    },
    "storeId": "",
    "beenHere": {
      "lastCheckinExpiredAt": 0
    },
    "location": {
      "cc": "FR",
      "lat": 48.8519,
      "lng": 2.3015,
      "city": "Paris",
      "state": "Île-de-France",
      "address": "54 Rue de l'Université",
      "country": "France",
      "postalCode": "75007",
      "labeledLatLngs": [
        {
          "lat": 48.8519,
          "lng": 2.3015,
          "label": "display"
        }
      ],
      "formattedAddress": [
        "54 Rue de l'Université",
        "75007 Paris",
        "France"
      ]
    },
    "verified": true,
    "bestPhoto": {
      "id": "50911f49e4b02f2ba2c6f08b",
      "width": 537,
      "height": 720,
      "prefix": "https://fastly.4sqi.net/img/general/",
      "source": {
        "url": "https://foursquare.com/download/#/iphone",
        "name": "Foursquare for iOS"
      },
      "suffix": "/13425135_TbGvFHJu0yoz--LfEyW84oJlgnCyfMTAZLqkEfNI3SY.jpg",
      "createdAt": 1349778777,
      "visibility": "public"
    },
    "attributes": {
      "groups": [
        {
          "name": "Price",
          "type": "price",
          "count": 1,
          "items": [
            {
              "priceTier": 2,
              "displayName": "Price",
              "displayValue": "€€"
            }
          ],
          "summary": "€€"
        }
      ]
    },
    "categories": [
      {
        "id": "4bf58dd8d48988d147941735",
        "icon": {
          "prefix": "https://ss3.4sqi.net/img/categories_v2/food/coffeeshop_",
          "suffix": ".png"
        },
        "name": "Coffee Shop",
        "primary": true,
        "shortName": "Coffee Shop",
        "pluralName": "Coffee Shops"
      }
    ],
    "pageUpdates": {},
    "allowMenuUrlEdit": true
  }
}
```

## Documentation

## Overview
Unlock detailed Foursquare venue data like La Fiancée's address, ratings, and photos for richer business insights.

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

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

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