Skip to main content
POST
Agent Product Offers
POST /agent/products/offers returns the offers and pricing for a specific product on a retailer (amazon or walmart). It’s the agent-native, MPP-paid counterpart to the authenticated Get Product Offers endpoint. No Zinc account is required. Each call is paid per request via the Machine Payments Protocol (MPP).

Pricing

Caching and freshness

Retailer data is cached. Use these optional query parameters to control freshness:
  • max_age — accept a cached response only if it is no older than this many seconds.
  • newer_than — accept a cached response only if it was retrieved at or after this Unix timestamp.
  • async — return immediately with status: "processing" instead of waiting for a fresh fetch. Poll again to retrieve the completed result.

402 Payment Required

If no valid payment credential is provided, the API returns 402 Payment Required with one WWW-Authenticate header per payable method (per RFC 9110 §11.6.1). Your MPP client uses these to complete payment and resubmit the request. See the MPP guide for details.

Query Parameters

product_id
string
required

Product identifier (e.g. ASIN)

retailer
enum<string>
required

Retailer: amazon or walmart

Available options:
amazon,
walmart
max_age
integer | null

Max response age in seconds

newer_than
integer | null

Minimum retrieval timestamp

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