Skip to main content
GET
/
v1
/
products
/
{product_id}
Get Product Details
curl --request GET \
  --url https://api.zinc.io/v1/products/{product_id} \
  --header 'Authorization: Basic <encoded-value>'
{
  "status": "processing",
  "retailer": "<string>",
  "product_id": "<string>",
  "timestamp": "<string>",
  "title": "<string>",
  "product_details": [
    "<string>"
  ],
  "feature_bullets": [
    "<string>"
  ],
  "brand": "<string>",
  "main_image": "<string>",
  "images": [
    "<string>"
  ],
  "variant_specifics": [
    {
      "dimension": "<string>",
      "value": "<string>"
    }
  ],
  "all_variants": [
    {
      "variant_specifics": [
        {
          "dimension": "<string>",
          "value": "<string>"
        }
      ],
      "product_id": "<string>"
    }
  ],
  "categories": [
    "<string>"
  ],
  "authors": [
    "<string>"
  ],
  "product_description": "<string>",
  "epids": [
    {
      "type": "<string>",
      "value": "<string>"
    }
  ],
  "epids_map": [
    "<string>"
  ],
  "package_dimensions": [
    {
      "amount": 123,
      "unit": "<string>"
    }
  ],
  "item_location": "<string>",
  "original_retail_price": 123,
  "price": 123,
  "review_count": 123,
  "stars": 123,
  "question_count": 123,
  "asin": "<string>",
  "fresh": true,
  "pantry": true,
  "handmade": true,
  "digital": true,
  "buyapi_hint": true,
  "item_number": "<string>"
}
Get up to date information on the title, description, manufacturer details, item specifics, and more for any product on our supported retailers.

Authorizations

Authorization
string
header
required

Use your client token as the username. Leave the password blank.

Path Parameters

product_id
string
required

The retailer's unique identifier for a particular product

Query Parameters

retailer
string
required

The retailer for the product. See Supported Retailers for a list of supported retailers.

max_age
number

A number in seconds setting the maximum age of the response. Cannot specify with newer_than.

newer_than
number

A timestamp setting the minimum time the response should be retrieved from. Cannot specify with max_age.

async
boolean
default:false

Determines whether the resulting response will be asynchronous. Defaults to false.

Response

200 - application/json

Product details retrieved successfully

status
enum<string>

Status of the request. You will only see processing if async: true was set on the request

Available options:
processing,
failed,
completed
retailer
string

The retailer for the product

product_id
string

The retailer's unique identifier for the product

timestamp
string

The timestamp that the resource was accessed

title
string

Title of the product

product_details
string[]

An array of strings providing details about the product

feature_bullets
string[]

An array of strings providing highlights of the product

brand
string

The brand of the product (if available)

main_image
string

The URL of the primary image associated with the product

images
string[]

An array of image URLs associated with the product

variant_specifics
object[]

Array of objects containing information about the types and values of a particular product variant

all_variants
object[]

An array of variant_specifics objects detailing all variants of the product as well as their product IDs

categories
string[]

Array of different categories that the product belongs in

authors
string[]

Array of author names (only available for products that are books)

product_description
string

The description of the product

epids
object[]

Array of objects containing external product identifier (epid) objects

epids_map
string[]

An array of the epids with the epid type as the field and the epid value as the value

package_dimensions
object[]

An array detailing the packaging details if available. Each dimension contains a 'amount' and 'unit'

item_location
string

(AliExpress only) The originating location of the product

original_retail_price
number

(Amazon only) The 'List Price' in cents of the product (present if the retailer is presenting a crossed out list price)

price
number

(Amazon only) The price in cents of the buy box price of the item. This is not always returned and is often not the cheapest option. If you want a product's price you should use Product Offers.

review_count
number

(Amazon only) The number of reviews of the product

stars
number

(Amazon only) The review score of the product

question_count
number

(Amazon only) The number of questions on the Amazon question section

asin
string

(Amazon only) The ASIN of the product

fresh
boolean

(Amazon only) TRUE if the item is an Amazon Fresh item

pantry
boolean

(Amazon only) TRUE if the item is an Amazon Pantry item

handmade
boolean

(Amazon only) TRUE if the item is an Amazon Handmade item

digital
boolean

(Amazon only) TRUE if the item is a digital-only item (software subscription, downloadable software, digital video, game codes, etc.)

buyapi_hint
boolean

(Amazon only) False if the item cannot be ordered via the buyapi, TRUE if it might be orderable

item_number
string

(Costco only) The Costco item number of the product (may not contain variant details)

I