Sign in

v48

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-043076233.0 KB
v1

Product Detail

Get detailed information about a specific product by its ID.

get/v1/products/{product_id}

Path parameters

product_idstring required

Query parameters

website_idsstring[] nullable

Optional list of website IDs to constrain the buy URL to, relevant if multiple merchants exist. Accepts website IDs or domains (e.g. "nike.com").

Optional list of website IDs to constrain the buy URL to, relevant if multiple merchants exist. Accepts website IDs or domains (e.g. "nike.com").

language'en' | 'de' | 'fr' | 'it' | 'es' | 'nl' | 'sv' | 'fi' | 'pt' | 'cs' | 'el' | 'ro' nullable

ISO 639-1 language code. Matches any language when unset; defaults to 'en' only when country and currency are also unset.

ISO 639-1 language code. Matches any language when unset; defaults to 'en' only when country and currency are also unset.

country'US' | 'GB' | 'EU' | 'AU' | 'CA' | 'IE' | 'DE' | 'AT' | 'FR' | 'BE' | 'IT' | 'ES' | 'NL' | 'SE' | 'FI' | 'PT' | 'CZ' | 'GR' | 'RO' nullable

ISO 3166-1 alpha-2 country code. Matches any country when unset; defaults to 'US' only when language and currency are also unset.

ISO 3166-1 alpha-2 country code. Matches any country when unset; defaults to 'US' only when language and currency are also unset.

currency'USD' | 'CAD' | 'AUD' | 'GBP' | 'EUR' | 'SEK' | 'CZK' | 'RON' nullable

ISO 4217 currency code. When unset, inferred from country (e.g. GB -> GBP); falls back to 'USD' only when all three locale fields are unset.

ISO 4217 currency code. When unset, inferred from country (e.g. GB -> GBP); falls back to 'USD' only when all three locale fields are unset.

length_unit'mm' | 'cm' | 'm' | 'in' | 'ft'

Preferred unit for length dimensions (length/width/height). When unset, dimensions are returned in the unit the merchant stated.

weight_unit'mg' | 'g' | 'kg' | 'oz' | 'lb'

Preferred unit for weight dimensions. When unset, weight is returned in the unit the merchant stated.

Response

Successful Response

idstring required
titlestring required
descriptionstring nullable
categoriesstring[]
gender'male' | 'female' | 'unisex' nullable
age'newborn' | 'infant' | 'toddler' | 'kids' | 'adult' nullable

Target age group. Age-agnostic products are typically returned as 'adult'.

materialsstring[] nullable
key_featuresstring[] nullable
structured_attributesobject

Structured attributes extracted for this product, keyed by attribute handle (e.g. 'color', 'material'). Values are the canonical allowed values for that handle.