Skip to content
Scrappa Get API key
Groupon API 1 credit / request

Groupon Detail API Documentation

GET https://scrappa.co/api/groupon/detail

Groupon Detail API Documentation 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.

Groupon Detail API Documentation 1 credit / request

Endpoint

Request preview
GET
https://scrappa.co/api/groupon/detail
Auth header
x-api-key
Cost
1 credit / request
deal_id = 1234567890
Response preview
200 OK
{
    "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",
...

Parameters

Start with the required fields, then add optional filters only when your use case needs them.

Runnable path

1 required parameter needed before sending a request.

deal_id string Required

Deal slug from search or the sitemap, unchanged. Required.

Example value 1234567890

Response Schema

Example response fields are illustrative; inspect the JSON before integrating.

Example response fields

Scan these fields before integrating.

data meta success
JSON Response
200 OK
{
    "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

Handle these documented responses before retrying or showing customer-facing failures.

422

Validation Error

A query parameter is missing or invalid. This response is not billable.

{
    "errors": {
        "deal_id": [
            "Send the deal slug unchanged."
        ]
    },
    "message": "The request validation failed"
}
404

Not Found

No deal with this slug. This response is not billable.

{
    "error": {
        "code": "NOT_FOUND",
        "message": "Groupon has no deal with this id."
    },
    "success": false
}

Generate Code with AI

Copy a ready-made prompt with all the endpoint details, parameters, and example responses. Paste it into ChatGPT, Claude, or any AI assistant to instantly generate working code.

Try It Live

Test this endpoint in our interactive playground with real data.