Agent Product Details

Get full details for one product

curl --request POST \
  --url https://api.zinc.com/agent/products/details

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.zinc.com/agent/products/details",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.zinc.com/agent/products/details"

	req, _ := http.NewRequest("POST", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.zinc.com/agent/products/details")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)

response = http.request(request)
puts response.read_body

{
  "status": "completed",
  "retailer": "amazon",
  "product_id": "B00KFP6NHO",
  "asin": "B00KFP6NHO",
  "title": "Nuby Garden Fresh Fruitsicle Frozen Pop Tray",
  "brand": "Nuby",
  "price": 799,
  "original_retail_price": 899,
  "ship_price": 0,
  "stars": 4.4,
  "review_count": 829,
  "question_count": 44,
  "main_image": "https://m.media-amazon.com/images/I/61K0YbuLi-L.jpg",
  "images": [
    "https://m.media-amazon.com/images/I/61K0YbuLi-L.jpg",
    "https://m.media-amazon.com/images/I/81KtOn8ddTL.jpg",
    "https://m.media-amazon.com/images/I/71%2BruDKMSoL.jpg"
  ],
  "feature_bullets": [
    "Includes four freeze-and-feed popsicle molds with handles shaped for little hands",
    "Wide popsicle-holder base catches drips as the popsicle melts",
    "6 Months + / BPA Free"
  ],
  "product_description": "Nuby's Garden Fresh Fruitsicle Frozen Popsicle Tray is specially designed for making fresh puree popsicles at home. This set includes four fruitsicle handles and a tray to mold the pops.",
  "product_details": [
    "Product Dimensions: 5.8 x 5.8 x 4 inches ; 7.8 ounces",
    "Shipping Weight: 8.5 ounces",
    "UPC: 048526054381",
    "Item model number: 5438"
  ],
  "categories": [
    "Home & Kitchen",
    "Kitchen & Dining",
    "Kitchen Utensils & Gadgets",
    "Ice Pop Molds"
  ],
  "variant_specifics": [
    {
      "dimension": "Size",
      "value": "1"
    }
  ],
  "all_variants": [
    {
      "product_id": "B00KFP6NHO",
      "variant_specifics": [
        {
          "dimension": "Size",
          "value": "1"
        }
      ]
    },
    {
      "product_id": "B00Q3H18EQ",
      "variant_specifics": [
        {
          "dimension": "Size",
          "value": "2"
        }
      ]
    }
  ],
  "epids": [
    {
      "type": "MPN",
      "value": "5438"
    },
    {
      "type": "UPC",
      "value": "048526054381"
    },
    {
      "type": "EAN",
      "value": "0048526054381"
    }
  ],
  "epids_map": {
    "MPN": "5438",
    "UPC": "048526054381",
    "EAN": "0048526054381"
  },
  "package_dimensions": {
    "weight": {
      "amount": 8.5,
      "unit": "ounces"
    },
    "size": {
      "width": {
        "amount": 4,
        "unit": "inches"
      },
      "depth": {
        "amount": 5.8,
        "unit": "inches"
      },
      "length": {
        "amount": 5.8,
        "unit": "inches"
      }
    }
  },
  "aplus_html": "present",
  "fresh": false,
  "pantry": false,
  "handmade": false,
  "digital": false,
  "buyapi_hint": true,
  "timestamp": 1756425600
}

POST

agent

products

details

Get full details for one product

curl --request POST \
  --url https://api.zinc.com/agent/products/details

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.zinc.com/agent/products/details",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.zinc.com/agent/products/details"

	req, _ := http.NewRequest("POST", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.zinc.com/agent/products/details")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)

response = http.request(request)
puts response.read_body

{
  "status": "completed",
  "retailer": "amazon",
  "product_id": "B00KFP6NHO",
  "asin": "B00KFP6NHO",
  "title": "Nuby Garden Fresh Fruitsicle Frozen Pop Tray",
  "brand": "Nuby",
  "price": 799,
  "original_retail_price": 899,
  "ship_price": 0,
  "stars": 4.4,
  "review_count": 829,
  "question_count": 44,
  "main_image": "https://m.media-amazon.com/images/I/61K0YbuLi-L.jpg",
  "images": [
    "https://m.media-amazon.com/images/I/61K0YbuLi-L.jpg",
    "https://m.media-amazon.com/images/I/81KtOn8ddTL.jpg",
    "https://m.media-amazon.com/images/I/71%2BruDKMSoL.jpg"
  ],
  "feature_bullets": [
    "Includes four freeze-and-feed popsicle molds with handles shaped for little hands",
    "Wide popsicle-holder base catches drips as the popsicle melts",
    "6 Months + / BPA Free"
  ],
  "product_description": "Nuby's Garden Fresh Fruitsicle Frozen Popsicle Tray is specially designed for making fresh puree popsicles at home. This set includes four fruitsicle handles and a tray to mold the pops.",
  "product_details": [
    "Product Dimensions: 5.8 x 5.8 x 4 inches ; 7.8 ounces",
    "Shipping Weight: 8.5 ounces",
    "UPC: 048526054381",
    "Item model number: 5438"
  ],
  "categories": [
    "Home & Kitchen",
    "Kitchen & Dining",
    "Kitchen Utensils & Gadgets",
    "Ice Pop Molds"
  ],
  "variant_specifics": [
    {
      "dimension": "Size",
      "value": "1"
    }
  ],
  "all_variants": [
    {
      "product_id": "B00KFP6NHO",
      "variant_specifics": [
        {
          "dimension": "Size",
          "value": "1"
        }
      ]
    },
    {
      "product_id": "B00Q3H18EQ",
      "variant_specifics": [
        {
          "dimension": "Size",
          "value": "2"
        }
      ]
    }
  ],
  "epids": [
    {
      "type": "MPN",
      "value": "5438"
    },
    {
      "type": "UPC",
      "value": "048526054381"
    },
    {
      "type": "EAN",
      "value": "0048526054381"
    }
  ],
  "epids_map": {
    "MPN": "5438",
    "UPC": "048526054381",
    "EAN": "0048526054381"
  },
  "package_dimensions": {
    "weight": {
      "amount": 8.5,
      "unit": "ounces"
    },
    "size": {
      "width": {
        "amount": 4,
        "unit": "inches"
      },
      "depth": {
        "amount": 5.8,
        "unit": "inches"
      },
      "length": {
        "amount": 5.8,
        "unit": "inches"
      }
    }
  },
  "aplus_html": "present",
  "fresh": false,
  "pantry": false,
  "handmade": false,
  "digital": false,
  "buyapi_hint": true,
  "timestamp": 1756425600
}

POST /agent/products/details returns the full product details for a specific product on a retailer (amazon or walmart) — title, images, description, specs, and more. It’s the agent-native, MPP-paid counterpart to the authenticated Get Product Details endpoint. No Zinc account is required. Each call is paid per request via the Machine Payments Protocol (MPP).

Pricing


Price	$0.01 per call (fixed)
Payment	MPP (HTTP 402 challenge-credential flow)
Account	Not required

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

string

required

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

max_age

integer | null

Max response age in seconds, at least 31 (mutually exclusive with newer_than)

Required range: x >= 31

newer_than

integer | null

Minimum retrieval timestamp, as a unix time (mutually exclusive with max_age). Windows shorter than 31s are widened to it.

async

boolean | null

Return immediately with status=processing

Response

Product details. The payload is the retailer's, passed through unmodified, so the exact field set depends on retailer — the schema below lists every field each retailer returns, and the example dropdown shows one real response per retailer. status is always present.

Product details, passed through from the retailer. Common fields are listed first; fields marked with a retailer name are only present in that retailer's payload. Anything the retailer returns that is not listed here is passed through as well.

status

enum<string>

required

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.

Available options:

completed,

processing,

failed

code

string

Only on status: failed. Machine-readable error code, e.g. product_not_found, invalid_request.

message

string

Only on status: failed. Human-readable explanation.

retailer

string

Retailer that served the payload: amazon, walmart, bestbuy, etsy, or shopify (with the store's hostname in domain).

product_id

string

Identifier you passed in: ASIN (Amazon), item id (Walmart), bsin (Best Buy), product handle (Shopify), or listing id (Etsy).

title

string | null

Product title.

brand

string | null

Brand or manufacturer. Shopify: the store's vendor. Etsy: not set — see shop_name.

main_image

string | null

URL of the primary product image.

images

string[]

URLs of all product images.

product_description

string | null

Long-form description (Amazon, Walmart, Best Buy). Shopify and Etsy use description.

description

string | null

Long-form description (Shopify, Etsy). Plain text on Etsy; may contain HTML on Shopify.

price

integer | null

Price in cents (minor units of currency_code on Etsy). Amazon: the buy-box price, which is not always present and is often not the cheapest offer — use the offers endpoint for pricing. Best Buy: the New condition price. Shopify: the default variant's price.

stars

number | null

Average product rating, 0–5 (Amazon, Walmart, Best Buy). Not set on Etsy — see shop_review_average.

review_count

integer | null

Number of product reviews (Amazon, Walmart).

num_reviews

integer | null

Number of product reviews (Best Buy).

feature_bullets

string[]

Highlight bullets (Amazon, Walmart, Best Buy).

product_details

string[]

Specification lines, e.g. Item model number: 5438 (Amazon, Walmart, Best Buy).

Getting Started

Agent Sandbox

Device Approval

Search (Beta)

Orders

Bulk Orders

Managed Accounts

Returns

Product Data

Retailers

Agent

Wallet

Webhooks

Usage

Agent Product Details

Pricing

Caching and freshness

402 Payment Required

Query Parameters

Response

​Pricing

​Caching and freshness

​402 Payment Required

Query Parameters

Response

Pricing

Caching and freshness

402 Payment Required