Groupon Search API Documentation 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.
Run this endpoint
Endpoint
Parameters
Start with the required fields, then add optional filters only when your use case needs them.
Runnable path
This endpoint has no required query parameters.
5 optional filters available.
string
Optional
Deal keyword, minimum 2 characters.
coffee shops
integer
Optional
1-based page number, default 1. Above 1 needs feed_token and offset.
1
integer
Optional
Deals per page, default 20, maximum 20. An upper bound only.
10
integer
Optional
Offset from the previous answer, for page 2 and beyond.
10
string
Optional
Feed token from the previous answer, for page 2 and beyond.
example
Response Schema
Example response fields are illustrative; inspect the JSON before integrating.
Example response fields
Scan these fields before integrating.
data
meta
success
{
"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
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": {
"limit": [
"The limit must be at least 1."
]
},
"message": "The request validation failed"
}Upstream Unavailable
The source did not answer or sent data Scrappa cannot read. This response is not billable. Retry in a moment.
{
"error": {
"code": "UPSTREAM_UNAVAILABLE",
"message": "The site is temporarily unavailable. Please retry."
},
"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.