Groupon APIgroupon.com ↗
Retrieve active, Groupon-verified discount codes for any supported store. Get promo code strings, discount titles, usage counts, and expiry dates via one endpoint.
What is the Groupon API?
The Groupon Coupons API exposes one endpoint — get_verified_codes — that returns all active, Groupon-badged promo codes for a given store, including up to 6 fields per code: discount title, promo code string, usage count, expiry date, and more. Coverage spans hundreds of major retailers addressable by a simple store slug parameter. This is useful for surfacing current, popularity-ranked discount codes in price-comparison tools, browser extensions, or savings dashboards.
curl -X GET 'https://api.parse.bot/scraper/5283ffc5-b250-4508-93ef-59111c3d4312/get_verified_codes?store=amazon' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace groupon-com-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""Walkthrough: Groupon Coupons SDK — bounded, re-runnable; every call capped."""
from parse_apis.groupon_com_api import Groupon, StoreNotFound
client = Groupon()
# List top verified codes for a store, sorted by popularity.
for code in client.codes.list(store="amazon", limit=3):
print(code.title, code.code, code.uses_today)
# Grab the single most popular code via .first().
top = client.codes.list(store="nike", limit=1).first()
if top:
print(top.title, top.code, top.expiry)
# Typed error: attempt a non-existent store.
try:
client.codes.list(store="nonexistent-store-xyz", limit=1).first()
except StoreNotFound as e:
print("store not found:", e.store)
print("exercised: codes.list")
Retrieves active, verified promo codes for a given store. Returns only codes (not deals) that carry Groupon's Verified badge, sorted by popularity (uses today, descending). Each code includes the discount title, the actual promo code string, usage count, and expiry date.
| Param | Type | Description |
|---|---|---|
| storerequired | string | Store slug as it appears in the Groupon Coupons URL path (e.g. 'amazon', 'nike', 'target'). Lowercase alphanumeric with hyphens. |
{
"type": "object",
"fields": {
"codes": "array of verified discount code objects sorted by popularity",
"total": "integer count of verified codes returned"
},
"sample": {
"data": {
"codes": [
{
"code": "CLIPCOUPON",
"store": "amazon",
"title": "30% Off Subscribe & Save with Amazon Promo Code",
"expiry": "2026-09-01T04:59:59.0000000Z",
"offer_id": "3468551",
"uses_today": 2978,
"description": "When you subscribe for auto-delivery save upwards of 30% off your next delivery.",
"is_verified": true
},
{
"code": "CLIPCOUPON",
"store": "amazon",
"title": "Up to 80% Off Home & Kitchen with Coupon",
"expiry": "2026-10-01T04:59:59.0000000Z",
"offer_id": "3468540",
"uses_today": 971,
"description": "Save up to 80% with these Amazon Home and Kitchen coupon codes. New products are added daily so keep checking back fro new Amazon finds.",
"is_verified": true
},
{
"code": "CLIP2COLLECT",
"store": "amazon",
"title": "Up to 60% Off Cosmetics Amazon Promo Code",
"expiry": "2027-06-01T04:59:59.0000000Z",
"offer_id": "3755032",
"uses_today": 451,
"description": "Save on beauty items from Amazon. Score up to 60% off select eyeshadows, lipsticks, mascaras, and more.",
"is_verified": true
},
{
"code": "Click2ClaimCodes",
"store": "amazon",
"title": "Up to 60% Off Pet Supplies with Amazon Promo Codes",
"expiry": "2027-05-24T04:59:59.0000000Z",
"offer_id": "3755030",
"uses_today": 169,
"description": "Find up to 60% off coupons on select pet supplies from Amazon.",
"is_verified": true
},
{
"code": "10FIFINE",
"store": "amazon",
"title": "10% Off FIFINE Gaming Mic Kit: Clearer Voice, Stream-Ready Sound",
"expiry": "2026-08-07T05:00:00.0000000Z",
"offer_id": "6575155",
"uses_today": 75,
"description": "",
"is_verified": true
}
],
"total": 5
},
"status": "success"
}
}About the Groupon API
What the API returns
The get_verified_codes endpoint returns an array of verified discount code objects for a specific store, along with a total integer showing how many codes were found. Each object in the codes array includes the discount title (describing what the offer is), the raw promo code string ready to paste at checkout, a uses_today count that drives the sort order, and an expiry date indicating when the code stops being valid.
The store parameter
The single required input is store — a lowercase alphanumeric slug matching the store's path on the Groupon Coupons site. For example, passing amazon, nike, or target maps directly to that retailer's coupon page. Getting the slug right is the main integration step: it must match Groupon's URL path exactly, so home-depot rather than homedepot.
Sorting and filtering
Results come back sorted by popularity — specifically, descending by the number of times each code has been used today. There is no server-side filtering by discount type, minimum savings amount, or expiry window; filtering on those dimensions is done client-side against the returned fields. Only codes carrying Groupon's Verified badge are included; unverified or expired codes are excluded from the response.
The Groupon API is a managed, monitored endpoint for groupon.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when groupon.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official groupon.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Populate a browser extension with current verified promo codes before checkout
- Build a store-specific savings page that shows ranked discount codes and their expiry dates
- Alert users when a high-popularity code (high uses_today) is available for a store they follow
- Aggregate promo code data across multiple retailers for a cashback or deal-comparison app
- Track how quickly usage counts change for a given store's codes over time
- Filter returned codes by expiry date to surface only codes valid for the next 7 days
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 200 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
| Team | $300/mo | 20,000 | 300 req/min |
| Company | $1,000/mo | 100,000 | 500 req/min |
Each endpoint has a fixed posted price per successful call — most fall between 1 and 10 credits — shown on this API's page before you run it. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Groupon have an official developer API for coupon data?+
What exactly does each code object in the response contain?+
codes array includes the discount title (a short description of the offer), the promo code string itself, the number of times the code has been used today (uses_today), and the expiry date. The array is sorted by uses_today descending so the most-used codes appear first.Does the API return deal listings (not just promo codes) from Groupon?+
get_verified_codes endpoint covers only codes that carry Groupon's Verified badge — it does not return deal listings, cashback offers, or sale pages. You can fork this API on Parse and revise it to add an endpoint targeting Groupon deal listings.Can I query multiple stores in one request, or paginate through all supported stores?+
store parameter accepts one slug per request; there is no batch or multi-store query, and no endpoint that lists all available store slugs. You can fork this API on Parse and revise it to add a bulk-store or store-discovery endpoint.How fresh is the data — when are codes updated?+
uses_today counts reset daily and expiry dates are included in each code object, stale codes (past their expiry) are not returned. For time-sensitive use cases, querying on demand rather than caching for extended periods is advisable.