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.
Run this endpoint
Endpoint
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.
string
Required
Deal slug from search or the sitemap, unchanged. Required.
1234567890
Response Schema
Example response fields are illustrative; inspect the JSON before integrating.
Example response fields
Scan these fields before integrating.
data
meta
success
{
"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.
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"
}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.