Response
🌳API Response Structure Overview
Root ├── request_info → Metadata about the API request (ID, status, credits, etc.) ├── request_parameters → Parameters used when sending the request ├── request_metadata → Timing and result metadata of the response └── result └── detail → Core product detail payload (title, brand, images, specs, etc.) ├── title ├── description ├── asin ├── brand ├── manufacturer ├── feature_bullets[] ├── specifications{} ├── images[] ├── categories[] ├── a_plus_content └── ...
📦Top-Level Meta Fields (Outside of result
)
result
)📌 request_info
(Object)
request_info
(Object)Contains metadata about the current API request, including a unique request ID, status, credit consumption, and geolocation details (if applicable). Useful for logging, auditing, or tracing specific calls.
id
string
request_info
Unique ID of the request for tracing and debugging
success
boolean
request_info
Indicates if the API call was successful
status_code
number
request_info
HTTP-like status code returned by the API
error_details
array
request_info
List of error messages or objects if the request failed
credits_used
number
request_info
Total credits used by the account so far
credit_used_this_request
number
request_info
Number of credits consumed by this specific request
credits_remaining
number
request_info
Remaining credits available to the account
credits_reset_at
string (ISO date)
request_info
When the credit limit will reset
address.city
string/null
request_info > address
Resolved city from zip code (if available)
address.district
string/null
request_info > address
Resolved district (if available)
address.country_code
string/null
request_info > address
Resolved country code (if available)
address.zipCode
array of strings
request_info > address
Zip codes used to geolocate the request
📌request_parameters
(Object)
request_parameters
(Object)Echoes back the query parameters sent in the original API request. Helpful for debugging and understanding which input values were interpreted by the server.
output
string
request_parameters
Output format requested (usually "json"
)
language
string
request_parameters
Language used for result localization (e.g., "en_US"
)
include_html
boolean
request_parameters
Whether HTML fields should be included
asin
string
request_parameters
The Amazon Standard Identification Number being queried
a_plus_content
boolean
request_parameters
Whether A+ content is requested
type
string
request_parameters
Type of request, e.g. "DETAIL"
📌request_metadata
(Object)
request_metadata
(Object)Performance-related metadata about how long the request took and when it was processed. Can be useful for performance monitoring or logging purposes.
created_at
string (ISO datetime)
request_metadata
Timestamp when the request was initiated
processed_at
string (ISO datetime)
request_metadata
Timestamp when the request was fully processed
total_time_taken
number (float, seconds)
request_metadata
Duration in seconds from request initiation to completion
📦Core Response Payload – result
Section
result
SectionThis section contains the core product data fetched using the DETAIL API type. All relevant product details are nested inside the result.detail
object.
result └── detail ├── title ├── description ├── asin ├── brand ├── manufacturer ├── feature_bullets[] ├── specifications{} ├── images[] ├── categories[] ├── a_plus_content └── ...
✳️Flat Response Fields for Product Detail API
title
string
Full product title including all variant and descriptive information as listed on Amazon.
title_excluding_variant_name
string
Product title without the variant label (e.g., color, size); useful for grouping similar items.
keywords
string
Raw keyword string extracted from the product title; terms are comma-separated.
asin
string
Amazon Standard Identification Number for the current product.
gtin
string
Global Trade Item Number (e.g., EAN, UPC, or ISBN depending on the product type).
link
string
Canonical Amazon product URL.
brand
string
Brand name of the product.
variant_asins_flat
string
Comma-separated list of ASINs for all available variants (e.g., colors, sizes, editions).
categories_flat
string
Full category path of the product, with each level separated by " > ", e.g., "Home & Kitchen > Kitchen & Dining > Storage..."
description
string
Detailed product description highlighting features and usage information.
marketplace_id
string
Amazon marketplace identifier code where the product is listed (e.g., "ATVPDKIKX0DER" for Amazon US).
rating
float
Average customer rating of the product, typically between 1 and 5.
ratings_total
integer
Total number of customer ratings submitted for the product.
has_size_guide
boolean
Indicates whether a size guide is available for the product (true
or false
).
is_bundle
boolean
Indicates if the product is a bundle of multiple items (true
or false
).
specifications_flat
string
Flattened product specifications with key-value pairs separated by dots and colons.
bestsellers_rank_flat
string
Flattened bestseller ranks in categories with format like "Category: Kitchen & Dining
color
string
Primary color of the product as listed.
manufacturer
string
Name of the product manufacturer or brand.
weight
string
Weight of the product, including units (e.g., "1.79 pounds").
dimensions
string
Physical dimensions of the product with units (e.g., 5.28"W x 12.3"H
).
shipping_weight
string
Shipping weight of the item (usually same as product weight).
model_number
string
Manufacturer’s model number or product identifier.
feature_bullets_count
integer
Number of feature bullet points provided.
feature_bullets_flat
string
Flattened concatenated feature bullet points describing product highlights and benefits.
delivered_to
string
Destination city and ZIP code where the product was delivered (e.g., "New York 10011").
ms
string
Internal system reference or metadata string (usage context-specific).
✳️Structured Fields – Arrays and Objects
➡️ keywords_list
(array of strings)
keywords_list
(array of strings)List of keywords or phrases associated with the product, typically used for search optimization and relevance.
keywords_list
string[]
-
List of keywords and keyword phrases extracted from product title and description.
➡️ variants
(array of objects)
variants
(array of objects)A list of alternative product variants such as different sizes, colors, or configurations. Each element in the array represents one variant option.
asin
string
variants
ASIN of the variant product.
title
string
variants
Display title of the variant (e.g., "14 Ounces Hot Coral").
is_current_product
boolean
variants
Indicates whether this variant is the one currently being viewed.
link
string (URL)
variants
Direct URL to the variant product page.
dimensions
array of objects
variants
List of dimension attributes (e.g., Size, Color) for the variant.
name
string
variants > dimensions
Name of the variant attribute (e.g., "Size", "Color").
value
string
variants > dimensions
Value corresponding to the attribute name (e.g., "14 Ounces", "Hot Coral").
➡️ categories
(array of objects)
categories
(array of objects)A list representing the hierarchical path of the product's categories, starting from the top-level category down to the most specific one. Useful for categorization, filtering, and navigation.
name
string
categories
Display name of the category (e.g., "Home & Kitchen").
link
string
categories
URL to the category page on Amazon.
category_id
string
categories
Internal identifier (Amazon node ID) for the category.
➡️ images
(array of objects)
images
(array of objects)An array of image objects representing different views or versions of the product. Useful for rendering product galleries with multiple angles or variants (e.g., front, back, side).
link
string (URL)
images
Direct URL to the product image. Typically points to a high-resolution image hosted on Amazon’s CDN.
variant
string
images
Image variant type, such as MAIN
, SIDE
, BACK
, etc. Can be used to group or prioritize images.
➡️ videos_additional
(array of objects)
videos_additional
(array of objects)A list of influencer or vendor-generated product videos shown under related content on the product detail page. Helpful for visual product explanations, demonstrations, or influencer marketing.
id
string
videos_additional
Unique video identifier (Amazon internal format).
product_asin
string
videos_additional
ASIN of the product directly shown in the video.
parent_asin
string
videos_additional
Parent ASIN if the product is part of a variation family.
related_products
string
videos_additional
Comma-separated list of ASINs related to the video.
title
string
videos_additional
Title of the video, if provided (can be empty).
profile_name
string
videos_additional
Display name of the creator or influencer.
profile_image_url
string
videos_additional
URL to the creator's profile image.
profile_link
string
videos_additional
Relative URL to the creator’s Amazon storefront or profile.
creator_type
string
videos_additional
Type of content creator (e.g., Influencer
, Vendor
).
vendor_code
string
videos_additional
Internal vendor/influencer identifier.
vendor_name
string
videos_additional
Name of the vendor or influencer store.
vendor_tracking_id
string
videos_additional
Amazon affiliate tracking ID.
video_image_id
string
videos_additional
Image ID for the video thumbnail.
video_image_url
string
videos_additional
Direct URL to the video thumbnail.
video_image_width
integer
videos_additional
Width in pixels of the thumbnail image.
video_image_height
integer
videos_additional
Height in pixels of the thumbnail image.
video_image_extension
string
videos_additional
Thumbnail file format (e.g., jpg
).
video_url
string
videos_additional
Direct stream URL to the video (HLS format).
video_mime_type
string
videos_additional
MIME type of the video (e.g., application/x-mpegURL
).
duration
string
videos_additional
Duration of the video in mm:ss
format.
type
string
videos_additional
Classification of the video context (e.g., videos_for_related_products
).
➡️ attributes
(array of objects)
attributes
(array of objects)A list of key-value pairs that describe the product’s main properties. These are typically shown in product detail tables and are useful for specifications, filters, and search.
name
string
attributes
The name of the attribute (e.g., Brand, Color).
value
string
attributes
The value associated with the attribute.
➡️ top_reviews
(array of objects)
top_reviews
(array of objects)Each element in the top_reviews array is an object representing a detailed customer review of the product. Below is a breakdown of the fields within each review object:
id
string
top_reviews
Unique identifier for the review (Amazon-assigned).
title
string
top_reviews
The headline/title of the review.
body
string
top_reviews
The plain-text content of the review.
body_html
string
top_reviews
HTML-formatted content of the review.
link
string
top_reviews
URL to the review on Amazon.
rating
integer
top_reviews
Star rating given by the reviewer (1–5).
date.raw
string
top_reviews
Raw date string as seen on the site.
date.utc
string
top_reviews
UTC ISO 8601 formatted date.
profile
object
top_reviews
Reviewer profile object.
profile.name
string
profile
Reviewer's display name.
profile.link
string
profile
Public URL to the reviewer's Amazon profile.
profile.id
string
profile
Amazon internal reviewer ID.
verified_purchase
boolean
top_reviews
Whether the purchase was verified by Amazon.
review_country
string
top_reviews
Country where the review was posted.
is_global_review
boolean
top_reviews
Whether the review appears on multiple Amazon marketplaces.
helpful_votes
integer
top_reviews
Number of helpful votes the review received.
vine_program
boolean
top_reviews
Whether the review is part of Amazon Vine program.
➡️ specifications
(array of objects)
specifications
(array of objects)specifications
is an array of objects representing detailed product specifications. Each object within the array contains name
and value
fields describing a specific attribute of the product.
name
string
specifications
The name of the specification attribute (e.g., Brand, Color).
value
string
specifications
The value corresponding to the specification attribute.
➡️ bestsellers_rank
(array of objects)
bestsellers_rank
(array of objects)bestsellers_rank
is an array of objects representing the product's ranking in different bestseller categories. Each object contains the category name, the rank of the product within that category, and a link to the bestseller page.
category
string
bestsellers_rank
The name of the bestseller category (e.g., Kitchen & Dining).
rank
integer
bestsellers_rank
The product's rank within the specified category.
link
string
bestsellers_rank
URL linking to the bestseller page for the category.
➡️ feature_bullets
(array of strings)
feature_bullets
(array of strings)feature_bullets
is an array of strings, where each string represents a key feature or benefit of the product. These bullet points are typically displayed on product detail pages to quickly highlight its most important attributes to potential buyers.
feature_bullets
string[]
—
A list of marketing-oriented bullet points describing product features. Each item is a separate string in the array.
🚫not_match
(array of strings)
not_match
(array of strings)A list of known Amazon product fields that were not present for the current product during data extraction. Useful for diagnostics, UI fallbacks, or completeness checks.
not_match
array of strings
Contains field names that were checked but not found in the specific product's Amazon page.
🧩️ bought_activity
(object)
bought_activity
(object)Represents customer purchase activity over a specific period.
raw
string
bought_activity
The original unprocessed string showing total purchases and time.
value
number
bought_activity
The numerical value extracted from the raw string (e.g., 300).
period
string
bought_activity
The time period for which the purchase count applies (e.g., "past month").
🧩️ search_alias
(object)
search_alias
(object)Represents the Amazon category under which the product is listed.
title
string
search_alias
Display name of the category (e.g., "Sports & Outdoors").
value
string
search_alias
Internal category identifier (e.g., "sporting").
🧩️ sub_title
(object)
sub_title
(object)Represents the byline section typically shown below the product title. This section often displays a prompt like “Visit the [Brand] Store” and links to the corresponding brand or seller page on Amazon.
text
string
sub_title
The display text in the byline (e.g., “Visit the STANLEY Store”).
link
string
sub_title
URL linking to the brand’s store or product-related landing page.
🧩️ rating_breakdown
(object)
rating_breakdown
(object)Represents the distribution of customer ratings across different star levels. Each star level (five_star
, four_star
, three_star
, two_star
, one_star
) contains a pair of values: percentage
and count
. This structure avoids redundancy by using the same subfields across multiple parent keys.
percentage
number
five_star, four_star, three_star,two_star, one_star
The proportion of total ratings for the associated star level (0–100).
count
number
five_star, four_star, three_star,two_star, one_star
The number of customer reviews that gave the associated star rating.
🧩️ main_image
(object)
main_image
(object)Represents the main visual representation of the product, typically used as the primary image on a product detail page.
link
string
main_image
The identifier or relative path of the product’s main image, often used to generate or fetch the full image URL.
🧩️ first_available
(object)
first_available
(object)Represents the date when the product was first made available for purchase.
raw
string
first_available
The raw string representation of the product's release date (e.g., "February 4, 2025").
🧩️ brand_store
(object)
brand_store
(object)Represents the Amazon storefront associated with the product's brand. This typically links to a branded landing page managed by the seller or manufacturer.
id
string
brand_store
A unique identifier for the brand's Amazon Store.
link
string
brand_store
URL to the brand's Amazon storefront page. Users are redirected here to explore brand items.
🧩️ similar_to_consider
(object)
similar_to_consider
(object)Provides basic information about an alternative or recommended product that customers might want to consider instead of or in addition to the current product.
asin
string
similar_to_consider
Amazon Standard Identification Number (ASIN) of the similar product.
title
string
similar_to_consider
Title or name of the alternative product.
link
string
similar_to_consider
Relative Amazon URL that points to the similar product.
rating
string
similar_to_consider
CSS class representing the star rating (e.g., 4.5 stars); not a numerical value.
ratings_total
integer
similar_to_consider
Total number of ratings received by the similar product.
is_prime
boolean
similar_to_consider
Indicates whether the item is eligible for Amazon Prime shipping.
↳symbol
string
similar_to_consider > price
Currency symbol (e.g., "$").
↳value
number | null
similar_to_consider > price
Numeric price value if available.
↳currency
string
similar_to_consider > price
Currency code (e.g., USD).
↳raw
string
similar_to_consider > price
Raw price text, usually the formatted version.
🧩️ bestseller_badge
(object)
bestseller_badge
(object)Provides metadata about whether the product holds a "Best Seller" badge within a specific category on Amazon.
link
string
bestseller_badge
Full URL leading to the Amazon bestseller list page for the related category.
category
string
bestseller_badge
The name of the category in which the item is a bestseller (e.g., "Insulated Tumblers").
badge_text
string
bestseller_badge
The display text of the badge (often dynamically rendered).
🧩️ buybox_winner
(object)
buybox_winner
(object)Contains detailed information about the seller and offer currently occupying the Amazon "Buy Box" position.
offer_id
string
buybox_winner
Unique identifier for the offer.
is_prime
boolean
buybox_winner
Indicates Prime eligibility.
is_amazon_fresh
boolean
buybox_winner
Indicates whether fulfilled by Amazon Fresh.
↳is_new
boolean
buybox_winner > condition
Whether the product is new.
↳symbol
string
buybox_winner > price
Currency symbol.
↳value
number
buybox_winner > price
Price value of the offer.
↳currency
string
buybox_winner > price
Currency code (e.g., USD).
↳raw
string
buybox_winner > price
Full formatted price.
↳raw
string
buybox_winner > shipping
Shipping info (e.g., "FREE").
↳symbol
string
buybox_winner > rrp
Currency symbol of Recommended Retail Price.
↳value
string
buybox_winner > rrp
RRP value.
↳currency
string
buybox_winner > rrp
RRP currency.
↳raw
string
buybox_winner > rrp
RRP formatted value.
↳date
string
buybox_winner > fulfillment > standard_delivery
Standard delivery estimated date.
↳name
string
buybox_winner > fulfillment > standard_delivery
Label for standard delivery (e.g., "FREE").
↳date
string
buybox_winner > fulfillment > fastest_delivery
Fastest delivery estimated date.
↳name
string
buybox_winner > fulfillment > fastest_delivery
Label for fastest delivery.
↳value
number
buybox_winner > maximum_order_quantity
Maximum quantity allowed per order.
↳hard_maximum
boolean
buybox_winner > maximum_order_quantity
Whether it's a strict upper limit.
↳raw
string
buybox_winner > availability
Stock status as raw text.
↳min_quantity
number
buybox_winner > availability
Minimum quantity available.
↳real_count
boolean
buybox_winner > availability
Whether the min_quantity represents the real count.
↳offer_id
string
buybox_winner > secondary_buybox
ID of the secondary offer.
↳caption
string
buybox_winner > secondary_buybox
Caption for the secondary offer (e.g., “Used - Like New”).
Last updated