v1

latestOpenAPI 3.1.02026-07-24173271.4 KB

Product Coupons

Product coupons by URL

Returns verified and unverified coupon codes for a specific product URL, along with merchant information and verification status.

get/product

Query parameters

api_keystring required

Site API key for the site requesting coupons.

product_urlstring url required

Original retailer product page URL. Must not be an affiliate or redirect URL.

include_unverifiedboolean

Whether to include unverified coupon codes after verified results. Defaults to true.

cuidstring

Custom identifier used to associate the click with a user, page, campaign, or event.

utm_sourcestring

Identifies the source of the traffic (e.g., website, newsletter, twitter).

utm_mediumstring

Identifies the marketing medium (e.g., email, social, banner).

utm_campaignstring

Identifies the campaign name, promotion, or initiative.

utm_termstring

Identifies paid search keywords or targeting terms.

utm_contentstring

Differentiates similar links or placements on the same page.

Response

Successfully retrieved coupon code.

Example response

{
  "merchant": {
    "domain": "kiehls.com",
    "group_id": 2528,
    "group_name": "Kiehl's"
  },
  "scan": {
    "when_to_check_back": 3600
  },
  "coupons": [
    {
      "id": "f556475089750904030e28ad62c6727f",
      "code": "WELCOME20",
      "original_price": 52,
      "price_with_code": 41.6,
      "currency": "USD",
      "verified": true,
      "verified_at": "2026-02-06T15:18:11.746Z"
    }
  ]
}