# Groupon Search

## Overview

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

## Access

This endpoint is **private**. Requests return HTTP 403 until access is granted. There is no self-serve request-access button. Open a support ticket from the dashboard Help desk (https://app.piloterr.com/app?returnTo=help-desk/tickets/new) and include the endpoint path, your use case, target fields, and expected volume.

## Description

Access Groupon France deals for strategic insights and user engagement with the powerful Groupon Search API.

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

## Example Response

### Example

```json
{
  "deals": [
    {
      "link": "https://www.groupon.fr/deals/day-pass-thermes-achamana",
      "price": "€19,90",
      "title": "Day Pass Thermes Achamana",
      "discount": "20%"
    },
    {
      "link": "https://www.groupon.fr/deals/formidable-spa",
      "price": "€49,90",
      "title": "Formidable Spa",
      "discount": "30%"
    },
    {
      "link": "https://www.groupon.fr/deals/repas-gourmet-pour-deux",
      "price": "€29,90",
      "title": "Repas Gourmet pour Deux",
      "discount": "25%"
    },
    {
      "link": "https://www.groupon.fr/deals/escape-game-enigmatic",
      "price": "€15,90",
      "title": "Escape Game Enigmatic",
      "discount": "35%"
    },
    {
      "link": "https://www.groupon.fr/deals/cours-de-yoga",
      "price": "€9,90",
      "title": "Cours de Yoga",
      "discount": "50%"
    }
  ],
  "totalDeals": 5
}
```

## Documentation

## Overview
Access Groupon France deals for strategic insights and user engagement with the powerful Groupon Search API.

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

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

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