---
title: "Product coupons by URL"
method: GET
path: "/product"
tags: ["Product Coupons"]
---

# Product coupons by URL

`GET /product`

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

## Query parameters

- `api_key` string, required
- `product_url` string, url, required
- `include_unverified` boolean
- `cuid` string
- `utm_source` string
- `utm_medium` string
- `utm_campaign` string
- `utm_term` string
- `utm_content` string

## Response `200`

Successfully retrieved coupon code.

- ProductCouponsResponse
  - `merchant` Merchant, required
    - `domain` string, required
    - `group_id` integer, required
    - `group_name` string, required
    - `logo_url` string, url, nullable
  - `scan` Scan, required
    - `verification_active` boolean, required — Indicates whether coupon verification is currently running.
    - `when_to_check_back` integer, required — Recommended delay (in seconds) before polling again.
  - `coupons` Coupon[], required — Ranked list of coupon codes. Verified coupons appear first, followed by unverified codes.
    - `id` string, required — Sovrn coupon identifier.
    - `code` string, required — Promo code text.
    - `affiliated_url` string, url, required — Affiliate redirect URL with tracking parameters applied.
    - `original_price` number, double, nullable — Original product price.
    - `price_with_code` number, double, nullable — Final price after applying the code. May be null while verification is in progress.
    - `currency` string, required — ISO 4217 currency code.
    - `verified` boolean, required — Whether the code has been verified to work.
    - `verified_at` string, date-time, nullable — Timestamp when the code was last verified. May be null if not yet verified.
    - `code_description` string, nullable — Best-effort description of the promotion. May be null or inaccurate.

## Other responses

- `400` — Invalid request parameters.
- `401` — Unauthorized.
- `404` — Resource not found.
- `500` — Internal server error.

---

[API](https://skmtc.dev/sovrn/apis/rest.md) · [All operations](https://skmtc.dev/sovrn/apis/rest/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/sovrn/rest/revisions/cb783ced960d/schema)