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)

πŸ“Œ 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.

Field
Type
Parent
Description

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)

Echoes back the query parameters sent in the original API request. Helpful for debugging and understanding which input values were interpreted by the server.

Field
Type
Parent
Description

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)

Performance-related metadata about how long the request took and when it was processed. Can be useful for performance monitoring or logging purposes.

Field
Type
Parent
Description

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

This 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

Field
Type
Description

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)

List of keywords or phrases associated with the product, typically used for search optimization and relevance.

Field Name
Type
Parent
Description

keywords_list

string[]

-

List of keywords and keyword phrases extracted from product title and description.

chevron-rightπŸ§ͺ Sample Output – keywords_listhashtag

➑️ 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.

Field Name
Type
Parent
Description

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").

chevron-rightπŸ§ͺ Sample Output – variantshashtag

➑️ 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.

Field Name
Type
Parent
Description

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.

chevron-rightπŸ§ͺ Sample Output – categorieshashtag

➑️ 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).

Field
Type
Parent
Description

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.

chevron-rightπŸ§ͺ Sample Output – imageshashtag

➑️ 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.

Field
Type
Parent
Description

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).

chevron-rightπŸ§ͺ Sample Output – videos_additionalhashtag

➑️ 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.

Field
Type
Parent
Description

name

string

attributes

The name of the attribute (e.g., Brand, Color).

value

string

attributes

The value associated with the attribute.

chevron-rightπŸ§ͺ Sample Output – attributes hashtag

➑️ 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:

Field
Type
Parent
Description

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.

chevron-rightπŸ§ͺ Sample Output – top_reviews hashtag

➑️ 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.

Field
Type
Parent
Description

name

string

specifications

The name of the specification attribute (e.g., Brand, Color).

value

string

specifications

The value corresponding to the specification attribute.

chevron-rightπŸ§ͺ Sample Output – specificationshashtag

➑️ 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.

Field
Type
Parent
Description

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.

chevron-rightπŸ§ͺ Sample Output – bestsellers_rank hashtag

➑️ 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.

Field
Type
Parent
Description

feature_bullets

string[]

β€”

A list of marketing-oriented bullet points describing product features. Each item is a separate string in the array.

chevron-rightπŸ§ͺ Sample Output – feature_bullets hashtag

🚫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.

Field
Type
Description

not_match

array of strings

Contains field names that were checked but not found in the specific product's Amazon page.

chevron-rightπŸ§ͺ Sample Output – not_matchhashtag

🧩️ bought_activity(object)

Represents customer purchase activity over a specific period.

Field
Type
Parent
Description

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").

chevron-rightπŸ§ͺ Sample Output – bought_activityhashtag

🧩️ search_alias (object)

Represents the Amazon category under which the product is listed.

Field
Type
Parent
Description

title

string

search_alias

Display name of the category (e.g., "Sports & Outdoors").

value

string

search_alias

Internal category identifier (e.g., "sporting").

chevron-rightπŸ§ͺ Sample Output – search_alias hashtag

🧩️ 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.

Field
Type
Parent
Description

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.

chevron-rightπŸ§ͺ Sample Output – sub_titlehashtag

🧩️ 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.

Field
Type
Parent
Description

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.

chevron-rightπŸ§ͺ Sample Output – rating_breakdownhashtag

🧩️ main_image(object)

Represents the main visual representation of the product, typically used as the primary image on a product detail page.

Field
Type
Parent
Description

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.

chevron-rightπŸ§ͺ Sample Output – main_imagehashtag

🧩️ first_available(object)

Represents the date when the product was first made available for purchase.

Field
Type
Parent
Description

raw

string

first_available

The raw string representation of the product's release date (e.g., "February 4, 2025").

chevron-rightπŸ§ͺ Sample Output – main_imagehashtag

🧩️ 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.

Field
Type
Parent
Description

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.

chevron-rightπŸ§ͺ Sample Output – brand_storehashtag

🧩️ 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.

Field
Type
Parent
Description

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.

chevron-rightπŸ§ͺ Sample Output – similar_to_considerhashtag

🧩️ bestseller_badge(object)

Provides metadata about whether the product holds a "Best Seller" badge within a specific category on Amazon.

Field
Type
Parent
Description

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).

chevron-rightπŸ§ͺ Sample Output – bestseller_badgehashtag

🧩️ buybox_winner(object)

Contains detailed information about the seller and offer currently occupying the Amazon "Buy Box" position.

Field
Type
Parent
Description

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”).

chevron-rightπŸ§ͺ Sample Output – buybox_winnerhashtag

Last updated