# Groupon Search API Documentation

<p><strong>Groupon Search API Documentation</strong> Search public Groupon local deals. Send a keyword and a 1-based page. The feed covers the region of the exit used for the request. Page 1 takes no feed_token or offset. Later pages need both values from the previous answer. The answer has deal slugs the detail endpoint accepts unchanged, sale and original price as numbers with currency, discount percentage, rating and review count, merchant, location with coordinates, full-size images, live category facets and paging tokens. A page can hold fewer deals than the requested limit. Cost: 1 credit per successful request. Failed requests are not billed.</p>

- **Documentation:** [https://scrappa.co/docs/groupon-api/groupon_search](https://scrappa.co/docs/groupon-api/groupon_search)
- **API group:** Groupon API
- **Endpoint:** `GET https://scrappa.co/api/groupon/search`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `query` | string | No | Deal keyword, minimum 2 characters. |
| `page` | integer | No | 1-based page number, default 1. Above 1 needs feed_token and offset. |
| `limit` | integer | No | Deals per page, default 20, maximum 20. An upper bound only. |
| `offset` | integer | No | Offset from the previous answer, for page 2 and beyond. |
| `feed_token` | string | No | Feed token from the previous answer, for page 2 and beyond. |

## Example response

```json
{
    "data": {
        "page": 1,
        "count": 1,
        "deals": [
            {
                "id": "leaf-spa-at-the-fairmont",
                "title": "Leaf Spa",
                "images": [
                    "https://img.grouponcdn.com/deal/example/full.webp"
                ],
                "rating": 4.6,
                "location": {
                    "name": "New York",
                    "address": "New York, NY",
                    "latitude": 40.7128,
                    "longitude": -74.006
                },
                "merchant": {
                    "name": "Leaf Spa",
                    "rating": 4.36
                },
                "categories": [
                    "spa"
                ],
                "sale_price": {
                    "amount": 159,
                    "currency": "USD"
                },
                "review_count": 208,
                "original_price": {
                    "amount": 217,
                    "currency": "USD"
                },
                "discount_percentage": 27
            }
        ],
        "facets": [
            {
                "id": "spa",
                "name": "Spa",
                "count": 57
            }
        ],
        "has_more": true,
        "feed_token": "token-abc",
        "next_offset": 20
    },
    "meta": {
        "credits": 1,
        "billable": true,
        "endpoint_family": "search"
    },
    "success": true
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A query parameter is missing or invalid. This response is not billable. |
| 502 | Upstream Unavailable | The source did not answer or sent data Scrappa cannot read. This response is not billable. Retry in a moment. |

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)
