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

# Product coupons by URL

`GET /product`

## Request

- Base URL: `https://viglink.io/coupons`
- URL: `https://viglink.io/coupons/product`
- Auth: API key in header `Authorization`

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/product-coupons-api.md) - [All operations](https://skmtc.dev/sovrn/apis/product-coupons-api/llms.txt) - [OpenAPI document](https://skmtc.dev/sovrn/apis/product-coupons-api/revisions/bd5ac7e4684a?raw)