# Groupon Detail API Documentation

<p><strong>Groupon Detail API Documentation</strong> Read one public Groupon deal. Send the deal slug from search or the sitemap unchanged as deal_id. The answer has sale and original price as numbers with currency, discount percentage, rating and review count, merchant, redemption locations, options with expiry and sold-out flags, full-size images, videos, customer reviews, FAQs, fine print and an ISO 8601 end date. Cost: 1 credit per successful request. Failed requests are not billed.</p>

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

## 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 |
| --- | --- | --- | --- |
| `deal_id` | string | Yes | Deal slug from search or the sitemap, unchanged. Required. |

## Example response

```json
{
    "data": {
        "deal": {
            "id": "leaf-spa-at-the-fairmont",
            "title": "Leaf Spa",
            "images": [
                "https://img.grouponcdn.com/deal/example/full.webp"
            ],
            "rating": 4.6,
            "ends_at": "2027-11-19T00:00:00+00:00",
            "options": [
                {
                    "title": "One hour massage",
                    "expires_at": "2027-11-19T00:00:00+00:00",
                    "sale_price": {
                        "amount": 159,
                        "currency": "USD"
                    },
                    "is_sold_out": false
                }
            ],
            "reviews": [
                {
                    "text": "Great experience",
                    "rating": 5,
                    "created_at": "2026-10-18T12:49:22+00:00"
                }
            ],
            "merchant": {
                "name": "Leaf Spa",
                "rating": 4.36
            },
            "sale_price": {
                "amount": 159,
                "currency": "USD"
            },
            "review_count": 208,
            "original_price": {
                "amount": 217,
                "currency": "USD"
            },
            "discount_percentage": 27
        }
    },
    "meta": {
        "credits": 1,
        "billable": true,
        "endpoint_family": "detail"
    },
    "success": true
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A query parameter is missing or invalid. This response is not billable. |
| 404 | Not Found | No deal with this slug. This response is not billable. |

## 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)
