Coupons APIcoupons.com ↗
Access coupon codes, printable coupons, and store deals from Coupons.com. Search 2000+ retailers, get grocery coupons, and retrieve top featured offers.
What is the Coupons 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.
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'
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 coupons-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.
from parse_apis.coupons_com_api import Coupons, Store, StoreSearchResult, StoreCoupon, TopOffer, CouponOffer
coupons = Coupons()
# Browse top featured deals
for offer in coupons.topoffers.list():
print(offer.title, offer.caption, offer.retailer_name, offer.code)
# Search for a specific retailer
for result in coupons.storesearchresults.search(query="nike"):
print(result.retailer.name, result.retailer.active_vouchers_count, result.retailer_landing_page.url)
# Get coupons for a specific store
for coupon in coupons.storecoupons.list(slug="amazon"):
print(coupon.title, coupon.caption, coupon.code, coupon.is_verified)
# Browse digital grocery coupons
for item in coupons.couponoffers.list():
print(item.offer.brand, item.offer.value, item.offer.expiration_date)
# List all available stores
for store in coupons.stores.list():
print(store.label, store.url)
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 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.
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?+
- 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 | 100 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.