coupons.com APIcoupons.com ↗
Access coupon codes, printable coupons, and store deals from Coupons.com. Search 2000+ retailers, get grocery coupons, and retrieve top featured offers.
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'
Get all stores available on coupons.com, organized alphabetically. Returns over 2000 stores with their names and URL slugs.
No input parameters required.
{
"type": "object",
"fields": {
"stores": "array of store objects, each with label (store 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/aaa",
"label": "AAA"
},
{
"url": "coupon-codes/abercrombie",
"label": "Abercrombie"
}
]
},
"status": "success"
}
}About the coupons.com API
The Coupons.com API provides 6 endpoints covering digital coupons, printable grocery offers, store-specific deals, and retailer discovery across more than 2000 stores. The get_store_coupons endpoint retrieves all coupon codes and deals for a named retailer by slug, returning fields like code, end_time, is_verified, and is_exclusive. Grocery coupon endpoints expose brand, UPC, category, expiration date, and image URL data for both clippable and printable offers.
Store and Retailer Discovery
get_all_stores returns an alphabetically organized list of over 2000 retailers, each with a label (store name) and url (relative URL slug). Those slugs feed directly into get_store_coupons and search_stores. search_stores accepts a query string and returns matching retailers with name, logo, activeVouchersCount, and a retailerLandingPage URL — useful for building search-driven coupon discovery flows.
Store-Specific Coupons
get_store_coupons takes a slug parameter (for example, 'amazon' or 'walmart') and returns the full set of available coupons for that retailer. Each coupon object includes id, title, description, type, caption, code, end_time, terms, is_exclusive, is_verified, and is_expired. The response also returns a count integer and the store_slug that was queried, making it straightforward to build per-retailer deal pages or monitor code availability over time.
Grocery and Printable Coupons
get_coupons and get_printable_coupons both return offers arrays of coupon objects with fields including coupon_id, brand, value, category_description, and expiration_date. Both endpoints also return an image_url_prefix string used to construct full coupon image URLs. The digital endpoint targets clippable offers while the printable endpoint covers in-store print-and-redeem coupons — useful for distinguishing redemption channel in grocery or CPG applications.
Top Offers Feed
get_top_coupons provides a curated feed of today's featured deals across retailers. Each entry in top_offers includes id, title, type, description, retailer_name, caption, code, end_time, expiration, and is_exclusive. The count field gives the total number of offers in the response. This endpoint is suited to homepage deal feeds or daily deal digest applications.
- Build a daily deal digest using
get_top_couponsfields likeretailer_name,code, andend_time. - Aggregate grocery savings by brand and category using
brand,value, andcategory_descriptionfromget_coupons. - Track coupon code availability for specific retailers by polling
get_store_couponswith a known slug and monitoringis_expired. - Distinguish printable vs. digital grocery offers for in-store vs. online redemption workflows using separate endpoints.
- Populate a retailer autocomplete search using
search_storesresults includingname,logo, andactiveVouchersCount. - Build a coupon browser sorted by expiration by combining
end_timeacross store coupon responses. - Generate a store directory from
get_all_storesslugs and enrich each entry with active coupon counts viasearch_stores.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Coupons.com have an official developer API?+
What does `get_store_coupons` return beyond the coupon code itself?+
title, description, type, caption, terms, end_time, is_exclusive, is_verified, and is_expired flags alongside the code. The count field in the response tells you how many coupons were returned for that slug.How do the grocery coupon endpoints differ from the store coupon endpoint?+
get_coupons and get_printable_coupons return product-level grocery offers with fields like brand, value, coupon_id, category_description, and an image_url_prefix for rendering coupon images. get_store_coupons returns retailer-specific promo codes and deals with code, end_time, and is_verified flags. They cover different redemption channels — grocery/CPG vs. online retailer codes.Does the API support filtering coupons by category, brand, or expiration date?+
category_description, brand, and expiration_date that you can filter client-side, but no server-side filter parameters are exposed. You can fork this API on Parse and revise it to add filtered or paginated endpoints.