> ## Documentation Index
> Fetch the complete documentation index at: https://www.zinc.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# Get Product Offers
> Retrieve all seller offers and prices for a product from a retailer via the Zinc API.
Returns every seller's offer for a product: price, condition, seller reputation, handling time, and shipping options. Use it when you need the cheapest offer or a specific seller rather than the retailer's default buy box. The **Response** section below documents the full offer object, and the example shows a real Amazon response.
## Pricing
| | |
| - | - |
| **Price** | \$0.01 per call, drawn from your [wallet](/docs/v2/wallet) |
| **Charged** | On each successful call, before any order is placed |
| **Empty wallet** | `402` with `{"detail": "Insufficient wallet balance for data API call"}` |
| **Sandbox** | Free — `zn_test_` keys are never metered |
This is a metered data call, billed whether or not you go on to order. A retry loop bills every attempt: check [`GET /wallet/me`](/docs/v2/api-reference/wallet/get-wallet) rather than retrying into a 402.
The MPP counterpart [`POST /agent/products/offers`](/docs/v2/api-reference/agent/product-offers) is the same call at the same price, paid per request instead of from a wallet.
## Retailer coverage
| `retailer` | Offers |
| - | - |
| `amazon` | Per-seller offers. `marketplace_fulfilled` means the offer ships with Prime. |
| `walmart` | Per-seller offers. |
| `bestbuy` | Best Buy prices per condition rather than per seller. Read `offers[]` on [Get Product Details](/docs/v2/api-reference/products/get-product) instead. |
| A Shopify store | Rejected with `400`. A storefront has one seller; per-variant price and availability are in `variants[]` on [Get Product Details](/docs/v2/api-reference/products/get-product). |
| `etsy` | Rejected with `400`. A listing has one seller; price and `variants[]` are on [Get Product Details](/docs/v2/api-reference/products/get-product). |
The Amazon marketplaces (`amazon-uk`, `amazon-ca`, `amazon-de`, `amazon-mx`, `amazon-fr`) return per-seller offers like `amazon`. `retailer` is a Zinc retailer slug, and the response's `retailer` is the slug too; see [which `retailer` to pass](/docs/v2/api-reference/products/search#which-retailer-to-pass).
All prices are integers in cents. `price` excludes shipping; each entry in `shipping_options[]` carries its own `price`.
`status` is the one field every response carries. It is `completed` when `offers[]` is populated, `processing` when you passed `async=true` and the fetch is still running (poll again), and `failed` when the retailer returned an error, in which case `code` and `message` say why.
## OpenAPI
````yaml versions/latest.json GET /products/{product_id}/offers
openapi: 3.1.0
info:
title: Zinc
summary: >-
Zinc lets you search, buy, and return items from top online retailers with a
single API.
description: >-
Search, buy, and return items from top online retailers with a single API.
Supports AI agent ordering via MPP (HTTP 402) — no account required.
Supported retailers include 1-800-Flowers, Ace Hardware, Amazon, Amazon CA,
Amazon DE, Amazon FR, Amazon MX, Amazon UK, Barnes & Noble, Best Buy, Chewy,
Gap, and 18 more. Ships to the US and 6 other countries (CA, DE, FR, GB, IT,
MX). The listed retailers are the ones Zinc verifies with daily test orders,
not the limit of what Zinc can buy from: checkout is attempted at most
online stores, including Shopify-hosted ones. To ask about a specific store
before ordering, call GET /retailers/check?url=... — it answers whether Zinc
will attempt that URL.
version: '2026-10-09'
x-logo:
url: https://mintlify.s3.us-west-1.amazonaws.com/zinc/logo/light.png
contact:
name: Zinc API Support
email: support@zinc.com
url: https://zinc.com/docs
x-guidance: >-
Zinc lets AI agents buy products from online retailers via a single API. Use
POST /agent/orders to place an order — no Zinc account needed, payment is
handled via MPP (HTTP 402 flow). Provide a product URL from a supported
retailer, a shipping address, and max_price in cents. The API charges
max_price + $1 API fee upfront and refunds the difference on completion. To
find products first, the /agent/* data endpoints (search, products/search,
products/offers, products/details) are MPP-paid at $0.01 per call;
/agent/search returns orderable URLs to feed straight into /agent/orders.
GET /retailers lists supported retailers for free (no payment or account).
Authenticated equivalents (orders, products, managed-accounts) require a
Bearer token (API key prefixed zn_); those orders are paid from a prefunded
wallet — GET /wallet/me returns the spendable balance and per-order fee, so
check it before POST /orders to avoid a 402. Orders are strict by default:
if the gift option can't be applied or any item can't be bought, the whole
order fails. When the user wants whatever can be shipped, send fulfillment:
{"gift": "best_effort", "items": "best_effort"} and read
fulfillment.concessions on the order to see what was relaxed. max_price is
never relaxed. Docs: https://zinc.com/docs Supported retailers include
1-800-Flowers, Ace Hardware, Amazon, Amazon CA, Amazon DE, Amazon FR, Amazon
MX, Amazon UK, Barnes & Noble, Best Buy, Chewy, Gap, and 18 more, shipping
to the US and 6 other countries (CA, DE, FR, GB, IT, MX). The listed
retailers are the ones Zinc verifies with daily test orders, not the limit
of what Zinc can buy from: checkout is attempted at most online stores,
including Shopify-hosted ones. To ask about a specific store before
ordering, call GET /retailers/check?url=... — it answers whether Zinc will
attempt that URL.
x-supported-retailers:
- 1-800-Flowers
- Ace Hardware
- Amazon
- Amazon CA
- Amazon DE
- Amazon FR
- Amazon MX
- Amazon UK
- Barnes & Noble
- Best Buy
- Chewy
- Gap
- Grainger
- IBS
- Lowe's
- Macys
- McMaster-Carr
- Partstown
- Pokémon Center
- Sephora
- Target
- The Home Depot
- TikTok
- Uniqlo
- Walmart
- Wayfair
- Zinc
- eBay
- libraccio
- zazzle
x-supported-countries:
- US
- CA
- DE
- FR
- GB
- IT
- MX
servers:
- url: https://api.zinc.com
description: Production
security:
- BearerAuth: []
paths:
/products/{product_id}/offers:
get:
tags:
- products
summary: Get Product Offers
description: >-
Get offers for a product from a retailer.
Not available for Shopify stores: a storefront lists one seller
(itself),
so per-variant price and availability live on the details endpoint
instead.
**Billing.** This is a metered data call: $0.01 is drawn from your
wallet per successful request, before any order is placed. An empty
wallet gets `402` instead. Sandbox (`zn_test_`) calls are free and never
touch the live wallet.
operationId: get_product_offers_products__product_id__offers_get
parameters:
- name: product_id
in: path
required: true
schema:
type: string
title: Product Id
- name: retailer
in: query
required: true
schema:
type: string
description: >-
Zinc retailer slug: amazon, amazon-uk, amazon-ca, amazon-de,
amazon-mx, amazon-fr, walmart, bestbuy, etsy, or a catalogued
Shopify store's slug (e.g. retailer=yetch; GET
/retailers/check?url=... returns a store's slug). A store's domain
is also accepted, as are the older amazon_uk-style codes. Stores
not in Zinc's catalog are rejected with a 422. Responses carry the
slug.
title: Retailer
description: >-
Zinc retailer slug: amazon, amazon-uk, amazon-ca, amazon-de,
amazon-mx, amazon-fr, walmart, bestbuy, etsy, or a catalogued
Shopify store's slug (e.g. retailer=yetch; GET
/retailers/check?url=... returns a store's slug). A store's domain
is also accepted, as are the older amazon_uk-style codes. Stores not
in Zinc's catalog are rejected with a 422. Responses carry the slug.
- name: max_age
in: query
required: false
schema:
anyOf:
- type: integer
minimum: 31
- type: 'null'
description: >-
Max response age in seconds, at least 31 (mutually exclusive with
newer_than)
title: Max Age
description: >-
Max response age in seconds, at least 31 (mutually exclusive with
newer_than)
- name: newer_than
in: query
required: false
schema:
anyOf:
- type: integer
- type: 'null'
description: >-
Minimum retrieval timestamp, as a unix time (mutually exclusive
with max_age). Windows shorter than 31s are widened to it.
title: Newer Than
description: >-
Minimum retrieval timestamp, as a unix time (mutually exclusive with
max_age). Windows shorter than 31s are widened to it.
- name: async
in: query
required: false
schema:
anyOf:
- type: boolean
- type: 'null'
description: Return immediately with status=processing
title: Async
description: Return immediately with status=processing
- name: authorization
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Authorization
responses:
'200':
description: >-
Seller offers for the product, passed through from the retailer.
`status` is always present; `offers` is populated when `status` is
`completed`.
content:
application/json:
schema:
title: ProductOffers
type: object
description: >-
Every seller's offer for the product, passed through from the
retailer. Shopify stores and Etsy listings have a single
seller, so they are rejected here and report price and
availability on the details endpoint; Best Buy's per-condition
prices are on the details endpoint too.
properties:
status:
type: string
enum:
- completed
- processing
- failed
description: >-
`completed` when the payload below is populated.
`processing` when `async=true` was passed and the fetch is
still running — poll again. `failed` when the retailer
returned an error; see `code` and `message`.
code:
type: string
description: >-
Only on `status: failed`. Machine-readable error code,
e.g. `product_not_found`, `invalid_request`.
message:
type: string
description: 'Only on `status: failed`. Human-readable explanation.'
retailer:
type: string
description: Zinc retailer slug that served the offers, e.g. `amazon`.
asin:
type: string
description: Amazon only. The product's ASIN.
offers:
type: array
items:
title: ProductOffer
type: object
properties:
offer_id:
anyOf:
- type: string
- type: 'null'
description: >-
Retailer's identifier for this offer. Amazon: the
offer listing id.
price:
type: integer
description: Item price in cents, excluding shipping.
condition:
type: string
description: Item condition.
enum:
- New
- Refurbished
- Used - Like New
- Used - Very Good
- Used - Good
- Used - Acceptable
- Unacceptable
available:
type: boolean
description: Whether the offer can currently be bought.
seller:
type: object
properties:
id:
anyOf:
- type: string
- type: 'null'
description: Retailer's seller id.
name:
anyOf:
- type: string
- type: 'null'
description: Seller display name.
num_ratings:
anyOf:
- type: integer
- type: 'null'
description: Seller's lifetime rating count.
percent_positive:
anyOf:
- type: integer
- type: 'null'
description: Share of positive seller ratings, 0–100.
first_party:
type: boolean
description: Sold by the retailer itself (e.g. Amazon.com).
description: Who is selling this offer.
marketplace_fulfilled:
type: boolean
description: >-
Shipped by the retailer rather than the seller.
Amazon: the offer ships with Prime.
prime_only:
type: boolean
description: Amazon only. Only Prime members can buy this offer.
international:
type: boolean
description: Ships from outside the United States.
addon:
type: boolean
description: >-
Amazon only. Add-on item that can only be bought
alongside other items.
minimum_quantity:
anyOf:
- type: integer
- type: 'null'
description: Minimum order quantity, when the seller imposes one.
handling_days:
type: object
properties:
min:
type: integer
description: Minimum handling time in days.
max:
type: integer
description: Maximum handling time in days.
description: Time before the seller ships.
shipping_options:
type: array
items:
type: object
properties:
name:
type: string
description: Shipping speed, e.g. `standard`, `one-day`.
price:
type: integer
description: Shipping price in cents.
delivery_days:
type: object
properties:
min:
type: integer
description: Earliest delivery, in days.
max:
type: integer
description: Latest delivery, in days.
description: Shipping methods offered by this seller.
description: >-
One entry per seller offer. Empty when the product has no
buyable offers.
timestamp:
type: integer
description: Unix time the offers were retrieved.
required:
- status
additionalProperties: true
examples:
amazon:
summary: Amazon
value:
status: completed
retailer: amazon
asin: B00KFP6NHO
offers:
- offer_id: 5ZwHjTcqVwZHZmB3IOKCbwUmf5NmT1fnfGhbwOQ0B5
price: 799
condition: New
available: true
seller:
id: ATVPDKIKX0DER
name: Amazon.com
first_party: true
marketplace_fulfilled: true
prime_only: false
international: false
addon: false
handling_days:
min: 0
max: 0
shipping_options:
- name: standard
price: 0
delivery_days:
min: 2
max: 5
- name: one-day
price: 599
delivery_days:
min: 1
max: 1
- offer_id: eMLzuculxk
price: 628
condition: Used - Very Good
available: true
seller:
id: A2L77EE7U53NWQ
name: Amazon Warehouse
num_ratings: 218432
percent_positive: 93
first_party: false
marketplace_fulfilled: true
prime_only: false
international: false
addon: false
handling_days:
min: 0
max: 1
shipping_options:
- name: standard
price: 0
delivery_days:
min: 4
max: 4
timestamp: 1756425600
processing:
summary: Still fetching (async=true)
value:
status: processing
failed:
summary: Retailer error
value:
status: failed
code: product_not_found
message: No product found for id B00KFP6NHO on amazon
'402':
description: >-
Insufficient wallet balance for the data-API fee. Fund the wallet
(or check `GET /wallet/me`) and retry. Postpaid plan customers are
never gated here.
content:
application/json:
schema:
type: object
properties:
detail:
type: string
required:
- detail
example:
detail: Insufficient wallet balance for data API call
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
components:
schemas:
HTTPValidationError:
properties:
detail:
items:
$ref: '#/components/schemas/ValidationError'
type: array
title: Detail
type: object
title: HTTPValidationError
ValidationError:
properties:
loc:
items:
anyOf:
- type: string
- type: integer
type: array
title: Location
msg:
type: string
title: Message
type:
type: string
title: Error Type
type: object
required:
- loc
- msg
- type
title: ValidationError
securitySchemes:
BearerAuth:
type: apiKey
in: header
name: Authorization
description: Zinc API key (Bearer zn_...)
````
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.