Coupons APIcoupons.com ↗
Access coupon codes, printable coupons, store directories, and deal data from Coupons.com. 9 endpoints covering 2000+ retailers, grocery offers, and top deals.
What is the Coupons API?
The Coupons.com API exposes 9 endpoints covering coupon codes, printable grocery offers, and retailer data across more than 2,000 stores. The get_store_coupons endpoint returns flat coupon objects with promo codes, expiration timestamps, verification status, and the retailer's own domain — all keyed by a store slug you can discover from get_all_stores or search_stores. Digital and printable grocery coupons are available through separate endpoints with brand names, face values in cents, UPC codes, and image URL components.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/9dfd8770-b4d0-4dfa-a345-cf64fc24eda1/get_all_stores' \ -H 'X-API-Key: $PARSE_API_KEY'
Retrieve the full directory of stores available on coupons.com, organized alphabetically. Returns over 2000 stores with their display names and URL slugs. The slug can be passed to get_store_coupons to fetch coupons for a specific retailer.
No input parameters required.
{
"type": "object",
"fields": {
"stores": "array of store objects each with label (display name) and url (relative URL path)"
},
"sample": {
"data": {
"stores": [
{
"url": "coupon-codes/a-sight-for-sport-eyes",
"label": "A Sight For Sport Eyes"
},
{
"url": "coupon-codes/nike",
"label": "Nike"
}
]
},
"status": "success"
}
}About the Coupons API
Store Directory and Search
get_all_stores returns the full alphabetical directory of over 2,000 stores, each with a label (display name) and url (relative URL path). The slug from this directory is the key input for most other endpoints. search_stores accepts a free-text query parameter and returns matching retailers with a nested retailer object containing idPool, name, logo, and activeVouchersCount, plus a retailerLandingPage with the store's slug. get_stores_summary combines the full directory with live active voucher counts, returning a slug and active_vouchers_count per store — useful for ranking or filtering retailers before fetching their coupons.
Store-Level Coupons and Deals
get_store_coupons accepts a slug parameter and returns a coupons array of flat objects, each with id, title, description, type, caption, code, end_time, terms, is_exclusive, is_verified, is_expired, and the retailer's resolved domain and domain_apex. The domain field is the retailer's own website host with leading www. stripped; domain_apex gives the registrable root (e.g. simon.com for shop.simon.com). get_top_coupons provides 15–25 curated high-value offers across stores, including retailer_name, code, expiration, and image fields. get_recent_coupons accepts an optional category slug (e.g. fashion-and-accessories, food-and-grocery) and returns coupons sorted by end_time ascending, each with retailer_slug for downstream lookups.
Grocery and Printable Coupons
get_coupons and get_printable_coupons return digital and printable grocery offers respectively. Each item in the offers array wraps coupon data under an offer key with fields including coupon_id, brand, value (face value in cents), category_description, expiration_date, UPC codes, and image_url_suffix. The image_url_prefix field at the top level combines with each offer's image_url_suffix to construct a full coupon image URL. Printable offers additionally include auth_print_enabled to indicate whether the coupon can currently be printed.
Domain Resolution
get_store_domains paginates through the store directory in fixed pages of 20, resolving each store to the retailer's own website domain and domain_apex. Response fields include page, count, has_more, page_size, total_stores, and a failed_stores array listing any slugs that could not be resolved along with their status_code. This endpoint is suited for building retailer-to-domain mapping tables at scale.
The Coupons API is a managed, monitored endpoint for coupons.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when coupons.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 coupons.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?+
- Aggregate active coupon codes across 2,000+ retailers using get_all_stores and get_store_coupons for a deal comparison tool
- Build a grocery savings app by surfacing brand names, face values in cents, and UPC codes from get_coupons and get_printable_coupons
- Monitor which stores have the most active vouchers using the active_vouchers_count field from get_stores_summary
- Populate a category-filtered deals feed using get_recent_coupons with category slugs like food-and-grocery or fashion-and-accessories
- Construct a retailer domain-to-slug mapping for affiliate or redirect tooling using get_store_domains
- Display today's featured promotions with retailer name, promo code, and expiration from get_top_coupons
- Resolve retailer website hostnames from coupons by reading the domain and domain_apex fields returned by get_store_coupons
| 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.