Get Product Details

curl --request GET \
  --url https://api.zinc.com/products/{product_id} \
  --header 'Authorization: <api-key>'

const options = {method: 'GET', headers: {Authorization: '<api-key>'}};

fetch('https://api.zinc.com/products/{product_id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.zinc.com/products/{product_id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: <api-key>"
  ],
]);

$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/products/{product_id}"

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

	req.Header.Add("Authorization", "<api-key>")

	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/products/{product_id}")

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

request = Net::HTTP::Get.new(url)
request["Authorization"] = '<api-key>'

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
}

GET

products

{product_id}

Get Product Details

curl --request GET \
  --url https://api.zinc.com/products/{product_id} \
  --header 'Authorization: <api-key>'

const options = {method: 'GET', headers: {Authorization: '<api-key>'}};

fetch('https://api.zinc.com/products/{product_id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.zinc.com/products/{product_id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: <api-key>"
  ],
]);

$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/products/{product_id}"

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

	req.Header.Add("Authorization", "<api-key>")

	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/products/{product_id}")

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

request = Net::HTTP::Get.new(url)
request["Authorization"] = '<api-key>'

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
}

The response is the retailer’s own product payload, passed through unmodified. That means the field set depends on the retailer: the Response section below lists every field each retailer returns, tagged by retailer where a field is specific to one, and the example dropdown shows a full response for each.

Pricing


Price	$0.01 per call, drawn from your 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 rather than retrying into a 402.

The MPP counterpart POST /agent/products/details is the same call at the same price, paid per request instead of from a wallet.

What to pass, and where the price is

`retailer`	`product_id`	Price and availability
`amazon`, and `amazon-uk`, `amazon-ca`, `amazon-de`, `amazon-mx`, `amazon-fr`, `amazon-au`	ASIN	`price` is the buy-box price and is often not the cheapest. Use Get Product Offers for every seller’s price.
`walmart`	Walmart item id	`price`, plus Get Product Offers for all sellers.
`bestbuy`	—	Not available yet: rejected with `400`, in test mode too.
A Shopify store’s slug (e.g. `yetch`) or domain	Product handle, the slug in `/products/{handle}`	`variants[]` carries per-variant `price` and `available`.
`etsy`	Numeric listing id	`price` in minor units of `currency_code` (not converted to USD). `has_variations` says whether the listing has options (search results call the same flag `has_variants`); `variants[]` is empty, because Etsy shares a listing’s options only with its own shop.

All prices are integers in cents, except Etsy, which reports minor units of the listing’s own currency. retailer is a Zinc retailer slug. A Shopify store not yet in Zinc’s catalog is added on a live key’s first request for it by domain (see new Shopify stores); see also which retailer to pass. The response’s retailer is the slug, and a Shopify store’s response adds platform: "shopify".

status is the one field every response carries. It is completed when the payload 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.

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

Zinc retailer slug: amazon, amazon-uk, amazon-ca, amazon-de, amazon-mx, amazon-fr, amazon-au, 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. A Shopify store not yet in Zinc's catalog is added on a live key's first request for it by domain; any other unknown value is a 422. Responses carry the slug.

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

Zinc retailer slug that served the payload, the value to pass back as retailer: amazon, amazon-uk, walmart, bestbuy, etsy, or a Shopify store's slug (e.g. yetch, with platform: "shopify" and the store's hostname in domain).

platform

string

Shopify only. The commerce platform the store runs on: shopify.

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

Cases

Product Data

Retailers

Agent

Wallet

Webhooks

Usage

Get Product Details

Pricing

What to pass, and where the price is

Authorizations

Headers

Path Parameters

Query Parameters

Response

​Pricing

​What to pass, and where the price is

Authorizations

Headers

Path Parameters

Query Parameters

Response

Pricing

What to pass, and where the price is