Skip to main content
GET
Get Product Offers

Authorizations

Authorization
string
header
required

Zinc API key (Bearer zn_...)

Headers

authorization
string | null

Path Parameters

product_id
string
required

Query Parameters

retailer
string
required

Retailer identifier: amazon, walmart, bestbuy, etsy, or a Shopify store's domain (e.g. retailer=yetch.studio)

max_age
integer | null

Max response age in seconds (mutually exclusive with newer_than)

newer_than
integer | null

Minimum retrieval timestamp (mutually exclusive with max_age)

async
boolean | null

Return immediately with status=processing

Response

Retailer payload, passed through unmodified. Fields vary by retailer, so only status is guaranteed: completed for a resolved response, processing when async=true and the fetch is still running, failed when the retailer returned an error (with code and message).

status
enum<string>
required
Available options:
completed,
processing,
failed