Retailmenot APIretailmenot.com ↗
Search for grocery and retail coupons, promo codes, and cash back offers across thousands of merchants to find the best deals before you shop. Get instant access to current discounts and savings opportunities tailored to your favorite stores and products.
curl -X GET 'https://api.parse.bot/scraper/0b19f338-de62-4d4e-8737-da11b18b9053/search_coupons?query=grocery' \ -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 retailmenot-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: RetailMeNot SDK — bounded, re-runnable; every call capped."""
from parse_apis.retailmenot_com_api import RetailMeNot, ParseError
client = RetailMeNot()
# Search for grocery coupons — limit caps TOTAL items fetched.
for coupon in client.coupon_search_results.search(query="grocery", limit=3):
print(coupon.store, coupon.title, coupon.discount)
# Try a different category search.
try:
item = client.coupon_search_results.search(query="pizza", limit=1).first()
if item:
print(item.store, item.title, item.offer_type)
except ParseError as e:
print("search failed:", e)
print("exercised: coupon_search_results.search")
Search for coupons and promo codes by keyword. Resolves the query to the best matching category or store page on RetailMeNot, then returns all available coupons from that page. Results include coupon codes, sales, and cash back offers with discount amounts and store attribution.
| Param | Type | Description |
|---|---|---|
| query | string | Search term for finding coupons (e.g. 'grocery', 'pizza', 'electronics'). Matched against RetailMeNot categories and store names. |
{
"type": "object",
"fields": {
"query": "The search term used",
"total": "Number of coupons returned",
"coupons": "Array of coupon objects with store, title, offer_type, type_label, discount, store_slug, and offer_id",
"source_url": "The RetailMeNot page URL the coupons were scraped from"
},
"sample": {
"data": {
"query": "grocery",
"total": 24,
"coupons": [
{
"store": "Instacart",
"title": "$25 Off Sitewide",
"discount": "$25 Off",
"offer_id": "RBC3B5GMYNHZDE7O6WPPOX57SY",
"offer_type": "COUPON",
"store_slug": "instacart.com",
"type_label": "Coupon code"
},
{
"store": "Instacart",
"title": "$10 Off $35 Eligible Items With FSA Or HSA Payment",
"discount": "$10 Off",
"offer_id": "4V3RY3W7D5HNVO7U5QY6YPIJ2M",
"offer_type": "COUPON",
"store_slug": "instacart.com",
"type_label": "Coupon code"
},
{
"store": "Instacart",
"title": "1% Cash Back For Purchases Sitewide",
"discount": "+1% Back",
"offer_id": "QSIMAN6TPRCO7E5UVZ5AZQC2DU",
"offer_type": "REWARD",
"store_slug": "instacart.com",
"type_label": "Cash Back"
}
],
"source_url": "https://www.retailmenot.com/coupons/grocery"
},
"status": "success"
}
}About the Retailmenot API
The Retailmenot API on Parse exposes 1 endpoint for the publicly available data on retailmenot.com. Calls return JSON over HTTPS and are billed per successful response.
Pin a release with the API-Snapshot-Version header so canonical updates don't silently change your contract.