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.

🧪 Sample Output – keywords_list
{
   "keywords_list": [
                "Stanley",
                "Quencher",
                "H2.0",
                "Tumbler",
                "with",
                "Handle",
                "and",
                "Straw",
                "40",
                "oz",
                "Flowstate",
                "3-Position",
                "Lid",
                "Cup",
                "Holder",
                "Compatible",
                "for",
                "Travel",
                "Insulated",
                "Stainless",
                "Steel",
                "BPA-Free",
                "Toast",
                "Stanley Quencher H2.0 Tumbler with Handle and Straw 40 oz",
                "Flowstate 3-Position Lid",
                "Cup Holder Compatible for Travel",
                "Insulated Stainless Steel Cup"
            ]
}

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

🧪 Sample Output – variants
{
  "variants": [
    {
      "asin": "B0DR9PCY9H",
      "title": "14 Ounces Hot Coral",
      "is_current_product": false,
      "link": "https://amazon.com/dp/B0DR9PCY9H?th=1&psc=1",
      "dimensions": [
        {
          "name": "Size",
          "value": "14 Ounces"
        },
        {
          "name": "Color",
          "value": "Hot Coral"
        }
      ]
    },
    {
      "asin": "B0CRN1XC69",
      "title": "30 Ounces Plum",
      "is_current_product": false,
      "link": "https://amazon.com/dp/B0CRN1XC69?th=1&psc=1",
      "dimensions": [
        {
          "name": "Size",
          "value": "30 Ounces"
        },
        {
          "name": "Color",
          "value": "Plum"
        }
      ]
    }
  ]
}

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

🧪 Sample Output – categories
{
  "categories": [
                {
                    "name": "Home & Kitchen",
                    "link": "https://amazon.com/home-garden-kitchen-furniture-bedding/b/ref=dp_bc_1?ie=UTF8&node=1055398",
                    "category_id": "1055398"
                },
                {
                    "name": "Kitchen & Dining",
                    "link": "https://amazon.com/kitchen-dining/b/ref=dp_bc_2?ie=UTF8&node=284507",
                    "category_id": "284507"
                }

  ]
}

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

🧪 Sample Output – images
{
 "images": [
                {
                    "link": "https://m.media-amazon.com/images/I/31J5v542jbL._AC_.jpg",
                    "variant": "MAIN"
                },
                {
                    "link": "https://m.media-amazon.com/images/I/411OJyT+xRL._AC_.jpg",
                    "variant": "SIDE"
                },
                {
                    "link": "https://m.media-amazon.com/images/I/31xAZitd75L._AC_.jpg",
                    "variant": "BACK"
                }
          ]
}

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

🧪 Sample Output – videos_additional
[
  {
    "id": "amzn1.vse.video.02ee8c97e9224f76b06fa19c90e567fa",
    "product_asin": "B0DQY6J9TL",
    "parent_asin": "B0F165F7V9",
    "related_products": "B0DVF5V7J2",
    "title": "",
    "profile_name": "Kia Shops 🛒",
    "profile_image_url": "https://m.media-amazon.com/images/I/71HnjmNkOwL._CR0,0,1124,1124_._FMjpg_._SL34_.jpg",
    "profile_link": "/shop/influencer-402bc029",
    "creator_type": "Influencer",
    "vendor_code": "influencer-402bc029:shop",
    "vendor_name": "Kia Shops 🛒",
    "vendor_tracking_id": "onamz00206e0-20",
    "video_image_id": "61mibcWtkwL",
    "video_image_url": "https://m.media-amazon.com/images/I/61mibcWtkwL._CR0,0,640,361_SR342,193_.jpg",
    "video_image_width": 640,
    "video_image_height": 1137,
    "video_image_extension": "jpg",
    "video_url": "https://m.media-amazon.com/images/S/vse-vms-transcoding-artifact-us-east-1-prod/15d2ed30-2319-49f6-b58e-fa4b366e26c9/default.vertical.jobtemplate.hls.m3u8",
    "video_mime_type": "application/x-mpegURL",
    "duration": "0:23",
    "type": "videos_for_related_products"
  }
]

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

🧪 Sample Output – attributes
[
  {
    "name": "Brand",
    "value": "STANLEY"
  },
  {
    "name": "Color",
    "value": "Toast"
  },
  {
    "name": "Special Feature",
    "value": "Dishwasher Safe"
  },
  {
    "name": "Style",
    "value": "40 oz"
  },
  {
    "name": "Recommended Uses For Product",
    "value": "Travel, Home"
  }
]

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

🧪 Sample Output – top_reviews
{
  "top_reviews": [
    {
      "id": "R2EVMFNZROZZ7E",
      "title": "The Ultimate Hydration Companion with Laser Engraving Perfection",
      "body": "STANLEY Quencher H2.0 FlowState Stainless Steel – The Ultimate Hydration Companion with Laser Engraving PerfectionAs someone who appreciates both form and function, I’ve been on the lookout for a high-quality water bottle that can keep my drinks at the perfect temperature while also offering a unique touch of personalization. The STANLEY Quencher H2.0 FlowState Stainless Steel water bottle has not only been an amazing companion for my daily hydration needs but also a standout product for laser engraving with my Xtool P2 55W CO2 laser.Performance & Design• Durable & Insulated Construction: The STANLEY Quencher is made from high-quality stainless steel that ensures excellent insulation. Whether I’m enjoying ice-cold water during a workout or hot coffee on a cold morning, the double-wall insulation keeps my drinks at the perfect temperature for hours.• Ergonomic and Practical Design: The FlowState lid provides multiple options, including a straw lid, making it easy to drink on the go. The handle is perfect for carrying, and the wide mouth ensures it’s easy to clean and fill. The design is sleek, modern, and perfect for active lifestyles, and it’s also great for those who like to make their hydration tools unique and personalized.Laser Engraving with Xtool• Precision Engraving: One of the coolest aspects of the STANLEY Quencher is its ability to be customized with laser engraving. The Xtool P2 55W CO2 laser makes it incredibly easy to engrave intricate designs, personalized text, or even logos onto the stainless steel surface. The results are clean, crisp engravings that look professional and are deeply etched into the bottle, ensuring the design won’t wear off over time.• Smooth Surface for Engraving: The stainless steel of the STANLEY Quencher is smooth and receptive to laser engraving, making it an ideal canvas for personalized gifts, corporate branding, or simply adding a personal touch to your own hydration bottle. Whether engraving names, quotes, or logos, the Xtool P2 handles the task effortlessly, producing stunning results every time.Perfect for a Variety of Uses• Personalized Gifts: The ability to engrave designs onto the STANLEY Quencher makes it a great gift option. Whether you’re personalizing it for a birthday, anniversary, or holiday, the engraving adds a thoughtful and unique touch to the bottle.• Business Branding: If you’re looking for a way to promote your business, the STANLEY Quencher is a fantastic option. Companies can engrave their logos or brand messages onto the bottles, creating a memorable and practical promotional item that people will actually use.• Outdoor & Active Use: With its durable construction, this bottle is perfect for hiking, sports, or just daily hydration. The ergonomic design and wide opening make it easy to drink from, and the stainless steel keeps your drink cool or warm for hours, no matter where you are.Pros:• High-quality stainless steel with excellent insulation for keeping drinks at the right temperature• Multiple lid options (including a straw lid) for easy drinking• Ergonomic design with a handle for easy carrying• Great for laser engraving—perfect for personalizing or branding• Durable and long-lasting, with no wear on the engraving over timeCons:• Size: It’s a large bottle, so if you prefer something more compact or portable, it may not be ideal for you.• Weight: The STANLEY Quencher is slightly heavier than other plastic bottles, so it might not be the best option for minimalist packers.Final ThoughtsThe STANLEY Quencher H2.0 FlowState Stainless Steel water bottle is a fantastic hydration companion that combines practical functionality with the ability to customize and personalize through laser engraving. Whether you use it for daily hydration, personal gifts, or corporate branding, the Xtool P2 55W CO2 laser makes engraving easy and ensures professional, lasting results on the stainless steel surface.If you’re looking for a high-quality, durable, and customizable water bottle that keeps your drinks at the perfect temperature and can be engraved with a personal touch, the STANLEY Quencher is an excellent choice.Pro Tip: For the best engraving results, be sure to adjust the laser settings based on the stainless steel to ensure crisp and clean designs that stand out.",
      "body_html": "<script>(function() {P.when('cr-A', 'ready').execute(function(A) {if(typeof A.toggleExpanderAriaLabel === 'function') {A.toggleExpanderAriaLabel('review_text_read_more', 'Read more of this review', 'Read less of this review');}});})();</script><style>.review-text-read-more-expander:focus-visible {outline: 2px solid #2162a1;outline-offset: 2px;border-radius: 5px;}</style><div data-a-expander-name=\"review_text_read_more\" data-a-expander-collapsed-height=\"300\" class=\"a-expander-collapsed-height a-row a-expander-container a-expander-partial-collapse-container review-text-read-more-expander\" style=\"max-height:300px\"><div data-hook=\"review-collapsed\" data-expanded=\"false\" class=\"a-expander-content reviewText review-text-content a-expander-partial-collapse-content\"><span>STANLEY Quencher H2.0 FlowState Stainless Steel &#x2013; The Ultimate Hydration Companion with Laser Engraving Perfection<br><br>As someone who appreciates both form and function, I&#x2019;ve been on the lookout for a high-quality water bottle that can keep my drinks at the perfect temperature while also offering a unique touch of personalization. The STANLEY Quencher H2.0 FlowState Stainless Steel water bottle has not only been an amazing companion for my daily hydration needs but also a standout product for laser engraving with my Xtool P2 55W CO2 laser.<br><br>Performance &amp; Design<br>&#x2022; Durable &amp; Insulated Construction: The STANLEY Quencher is made from high-quality stainless steel that ensures excellent insulation. Whether I&#x2019;m enjoying ice-cold water during a workout or hot coffee on a cold morning, the double-wall insulation keeps my drinks at the perfect temperature for hours.<br>&#x2022; Ergonomic and Practical Design: The FlowState lid provides multiple options, including a straw lid, making it easy to drink on the go. The handle is perfect for carrying, and the wide mouth ensures it&#x2019;s easy to clean and fill. The design is sleek, modern, and perfect for active lifestyles, and it&#x2019;s also great for those who like to make their hydration tools unique and personalized.<br><br>Laser Engraving with Xtool<br>&#x2022; Precision Engraving: One of the coolest aspects of the STANLEY Quencher is its ability to be customized with laser engraving. The Xtool P2 55W CO2 laser makes it incredibly easy to engrave intricate designs, personalized text, or even logos onto the stainless steel surface. The results are clean, crisp engravings that look professional and are deeply etched into the bottle, ensuring the design won&#x2019;t wear off over time.<br>&#x2022; Smooth Surface for Engraving: The stainless steel of the STANLEY Quencher is smooth and receptive to laser engraving, making it an ideal canvas for personalized gifts, corporate branding, or simply adding a personal touch to your own hydration bottle. Whether engraving names, quotes, or logos, the Xtool P2 handles the task effortlessly, producing stunning results every time.<br><br>Perfect for a Variety of Uses<br>&#x2022; Personalized Gifts: The ability to engrave designs onto the STANLEY Quencher makes it a great gift option. Whether you&#x2019;re personalizing it for a birthday, anniversary, or holiday, the engraving adds a thoughtful and unique touch to the bottle.<br>&#x2022; Business Branding: If you&#x2019;re looking for a way to promote your business, the STANLEY Quencher is a fantastic option. Companies can engrave their logos or brand messages onto the bottles, creating a memorable and practical promotional item that people will actually use.<br>&#x2022; Outdoor &amp; Active Use: With its durable construction, this bottle is perfect for hiking, sports, or just daily hydration. The ergonomic design and wide opening make it easy to drink from, and the stainless steel keeps your drink cool or warm for hours, no matter where you are.<br><br>Pros:<br>&#x2022; High-quality stainless steel with excellent insulation for keeping drinks at the right temperature<br>&#x2022; Multiple lid options (including a straw lid) for easy drinking<br>&#x2022; Ergonomic design with a handle for easy carrying<br>&#x2022; Great for laser engraving&#x2014;perfect for personalizing or branding<br>&#x2022; Durable and long-lasting, with no wear on the engraving over time<br><br>Cons:<br>&#x2022; Size: It&#x2019;s a large bottle, so if you prefer something more compact or portable, it may not be ideal for you.<br>&#x2022; Weight: The STANLEY Quencher is slightly heavier than other plastic bottles, so it might not be the best option for minimalist packers.<br><br>Final Thoughts<br><br>The STANLEY Quencher H2.0 FlowState Stainless Steel water bottle is a fantastic hydration companion that combines practical functionality with the ability to customize and personalize through laser engraving. Whether you use it for daily hydration, personal gifts, or corporate branding, the Xtool P2 55W CO2 laser makes engraving easy and ensures professional, lasting results on the stainless steel surface.<br><br>If you&#x2019;re looking for a high-quality, durable, and customizable water bottle that keeps your drinks at the perfect temperature and can be engraved with a personal touch, the STANLEY Quencher is an excellent choice.<br><br>Pro Tip: For the best engraving results, be sure to adjust the laser settings based on the stainless steel to ensure crisp and clean designs that stand out.<br></span></div><div class=\"a-expander-header a-expander-partial-collapse-header\"><div class=\"a-expander-content-fade\"></div><a href=\"javascript:void(0)\" data-hook=\"expand-collapse-read-more-less\" aria-label=\"Read more of this review\" aria-expanded=\"false\" role=\"button\" data-action=\"a-expander-toggle\" class=\"a-declarative\" data-a-expander-toggle=\"{&quot;allowLinkDefault&quot;:true, &quot;expand_prompt&quot;:&quot;Read more&quot;, &quot;collapse_prompt&quot;:&quot;Read less&quot;}\"><i class=\"a-icon a-icon-extender-expand\"></i><span class=\"a-expander-prompt\">Read more</span></a></div></div>",
      "link": "https://amazon.com/gp/customer-reviews/R2EVMFNZROZZ7E/ref=cm_cr_dp_d_rvw_ttl?ie=UTF8&ASIN=B0DQY6J9TL",
      "rating": 5,
      "date": {
        "raw": "Reviewed in the United States on February 22, 2025",
        "utc": "2025-02-22T00:00:00.000Z"
      },
      "profile": {
        "name": "VinnieVinnie",
        "link": "https://amazon.com/gp/profile/amzn1.account.AEAEY35KPNP6BCDMA2JEUIBF2WTA/ref=cm_cr_dp_d_gw_tr?ie=UTF8",
        "id": "AEAEY35KPNP6BCDMA2JEUIBF2WTA"
      },
      "verified_purchase": true,
      "review_country": "USA",
      "is_global_review": true,
      "helpful_votes": 65,
      "vine_program": false
    },
    {
      "id": "R1Q6EOE2ZC38UI",
      "title": "I Sold My Soul to Stanley and Now My Beverage is Immortal",
      "body": "Look, I didn’t want to love it. I really didn’t. I’m not a “trendy tumbler” kind of person. I scoffed. I rolled my eyes. I made fun of the pastel army of influencers and soccer moms clutching these like they held the secret to eternal youth.And then… I got one.Left it in my office overnight—overnight in Texas heat—and came back the next morning fully expecting lukewarm sadness. Instead, I was greeted by ice. Pristine, solid ice. Like it had been cryogenically preserved by the gods of hydration.Now here I am, a walking cliché, dragging this tank of a tumbler everywhere like it’s part of my body. I hate what I’ve become. But also… my drink is freezing cold at 9 a.m. and still arctic at 4 p.m. What kind of sorcery is this?Am I a trend-following sellout now? Yes. But I’m a well-hydrated sellout. And honestly? It feels amazing.",
      "body_html": "<div data-a-expander-name=\"review_text_read_more\" data-a-expander-collapsed-height=\"300\" class=\"a-expander-collapsed-height a-row a-expander-container a-expander-partial-collapse-container review-text-read-more-expander\" style=\"max-height:300px\"><div data-hook=\"review-collapsed\" data-expanded=\"false\" class=\"a-expander-content reviewText review-text-content a-expander-partial-collapse-content\"><span>Look, I didn&#x2019;t want to love it. I really didn&#x2019;t. I&#x2019;m not a &#x201C;trendy tumbler&#x201D; kind of person. I scoffed. I rolled my eyes. I made fun of the pastel army of influencers and soccer moms clutching these like they held the secret to eternal youth.<br><br>And then&#x2026; I got one.<br><br>Left it in my office overnight&#x2014;overnight in Texas heat&#x2014;and came back the next morning fully expecting lukewarm sadness. Instead, I was greeted by ice. Pristine, solid ice. Like it had been cryogenically preserved by the gods of hydration.<br><br>Now here I am, a walking clich&#xE9;, dragging this tank of a tumbler everywhere like it&#x2019;s part of my body. I hate what I&#x2019;ve become. But also&#x2026; my drink is freezing cold at 9 a.m. and still arctic at 4 p.m. What kind of sorcery is this?<br><br>Am I a trend-following sellout now? Yes. But I&#x2019;m a well-hydrated sellout. And honestly? It feels amazing.<br></span></div><div class=\"a-expander-header a-expander-partial-collapse-header\"><div class=\"a-expander-content-fade\"></div><a href=\"javascript:void(0)\" data-hook=\"expand-collapse-read-more-less\" aria-label=\"Read more of this review\" aria-expanded=\"false\" role=\"button\" data-action=\"a-expander-toggle\" class=\"a-declarative\" data-a-expander-toggle=\"{&quot;allowLinkDefault&quot;:true, &quot;expand_prompt&quot;:&quot;Read more&quot;, &quot;collapse_prompt&quot;:&quot;Read less&quot;}\"><i class=\"a-icon a-icon-extender-expand\"></i><span class=\"a-expander-prompt\">Read more</span></a></div></div>",
      "link": "https://amazon.com/gp/customer-reviews/R1Q6EOE2ZC38UI/ref=cm_cr_dp_d_rvw_ttl?ie=UTF8&ASIN=B0DQY6J9TL",
      "rating": 5,
      "date": {
        "raw": "Reviewed in the United States on May 21, 2025",
        "utc": "2025-05-21T00:00:00.000Z"
      },
      "profile": {
        "name": "Julie HagarJulie Hagar",
        "link": "https://amazon.com/gp/profile/amzn1.account.AFB72S2ZEJLSZCDJKZ5QDKMR36TQ/ref=cm_cr_dp_d_gw_tr?ie=UTF8",
        "id": "AFB72S2ZEJLSZCDJKZ5QDKMR36TQ"
      },
      "verified_purchase": true,
      "review_country": "USA",
      "is_global_review": true,
      "helpful_votes": 4,
      "vine_program": false
    }
  ]
}

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

🧪 Sample Output – specifications
{
  "specifications": [
        {
          "name": "Brand",
          "value": "STANLEY"
        },
        {
          "name": "Color",
          "value": "Toast"
        },
        {
          "name": "Special Feature",
          "value": "Dishwasher Safe"
        },
        {
          "name": "Style",
          "value": "40 oz"
        },
        {
          "name": "Recommended Uses For Product",
          "value": "Home, Travel"
        },
        {
          "name": "Brand",
          "value": "STANLEY"
        },
        {
          "name": "Color",
          "value": "Toast"
        },
        {
          "name": "Special Feature",
          "value": "Dishwasher Safe"
        },
        {
          "name": "Style",
          "value": "40 oz"
        },
        {
          "name": "Recommended Uses For Product",
          "value": "Home, Travel"
        },
        {
          "name": "Included Components",
          "value": "Lid, Straw, Tumbler"
        },
        {
          "name": "Shape",
          "value": "Cylindrical"
        },
        {
          "name": "Product Care Instructions",
          "value": "Dishwasher Safe"
        },
        {
          "name": "Material Feature",
          "value": "Insulated"
        },
        {
          "name": "Reusability",
          "value": "Reusable"
        },
        {
          "name": "Unit Count",
          "value": "1.0 Count"
        },
        {
          "name": "Product Dimensions",
          "value": "5.28\"W x 12.3\"H"
        },
        {
          "name": "Number of Items",
          "value": "1"
        },
        {
          "name": "Manufacturer",
          "value": "Stanley"
        },
        {
          "name": "UPC",
          "value": "041604439094"
        },
        {
          "name": "Size",
          "value": "40 Ounces"
        },
        {
          "name": "Item Weight",
          "value": "1.79 pounds"
        },
        {
          "name": "Department",
          "value": "Unisex-Adult"
        },
        {
          "name": "ASIN",
          "value": "B0DQY6J9TL"
        },
        {
          "name": "Item model number",
          "value": "10-10824-894"
        },
        {
          "name": "Customer Reviews",
          "value": "4.7 out of 5 stars"
        },
        {
          "name": "Best Sellers Rank",
          "value": "#2 in Kitchen & Dining (See Top 100 in Kitchen & Dining)#1 in Insulated Tumblers"
        },
        {
          "name": "Date First Available",
          "value": "February 4, 2025"
        }
      ]
}

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

🧪 Sample Output – bestsellers_rank
{
  "bestsellers_rank": [
    {
      "category": "Kitchen & Dining",
      "rank": 2,
      "link": "https://amazon.com/gp/bestsellers/kitchen/ref=pd_zg_ts_kitchen"
    },
    {
      "category": "Insulated Tumblers",
      "rank": 1,
      "link": "https://amazon.com/gp/bestsellers/kitchen/21613423011/ref=pd_zg_hrsr_kitchen"
    }
  ]
}

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

🧪 Sample Output – feature_bullets
{
  "feature_bullets": [
    "YOUR DREAM TUMBLER: Whichever way your day flows, the H2.0 FlowState tumbler keeps you refreshed with fewer refills. Double wall vacuum insulation means drinks stay cold, iced or hot for hours. Choose between our 14oz, 20oz, 30oz,40oz and 64oz options depending on your hydration needs. The narrow base on all sizes (except 64oz) fits just about any car cup holder, keeping it right by your side.",
    "ADVANCED LID CONSTRUCTION: Whether you prefer small sips or maximum thirst quenching, Stanley has developed an advanced FlowState lid, featuring a rotating cover with three positions: a straw opening designed to resist splashes with a seal that holds the reusable straw in place, a drink opening, and a full-cover top for added leak resistance. We’ve also included an ergonomic, comfort-grip handle, so you can easily carry your ice-cold water to work, meetings, the gym or trips out of town.",
    "EARTH-FRIENDLY DURABILITY: Constructed of 90% recycled BPA free stainless steel for sustainable sipping, the Stanley Quencher H2.0 has the durability to stand up to a lifetime of use. Eliminate the use of single-use plastic bottles and straws with a travel tumbler built with sustainability in mind.",
    "DISHWASHER SAFE: Spend less time hunched over the sink and more time doing the things you love. Cleaning your tumbler and lid couldn't be easier, just pop them into the dishwasher. Unlike plastic bottles that retain stains & smells, this metallic beauty comes out pristine",
    "LIFETIME WARRANTY: Since 1913 we’ve promised to provide rugged, capable gear for food and drink - accessories built to last a lifetime. It’s a promise we still keep. Stanley products purchased from Stanley Resellers come with a lifetime warranty. Rest easy knowing we’ve got your back through it all."
  ]
}

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

🧪 Sample Output – not_match
"not_match": [
                "authors",
                "series",
                "format",
                "promotions",
                "promotions_feature",
                "parent_asin",
                "protection_plans",
                "add_an_accessory",
                "documents",
                "sell_on_amazon",
                "audible_sample",
                "proposition_65_warning",
                "size_guide_html",
                "energy_efficiency",
                "rich_product_description",
                "has_coupon",
                "coupon_text",
                "book_description",
                "editorial_reviews",
                "editorial_reviews_flat",
                "runtime",
                "videos",
                "videos_count",
                "videos_flat",
                "bundles",
                "bundle_contents",
                "publisher",
                "is_collection",
                "collection_size",
                "collection_children",
                "release_date",
                "language",
                "material",
                "recommended_age",
                "whats_in_the_box",
                "important_information",
                "additional_details",
                "additional_details_flat",
                "more_buying_choices",
                "frequently_bought_together",
                "compare_with_similar",
                "amazons_choice",
                "kindle_unlimited",
                "climate_pledge_friendly",
                "a_plus_content",
                "request_invite"
            ],

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

🧪 Sample Output – bought_activity
 "bought_activity": {
                "raw": "300+ bought in past month",
                "value": 300,
                "period": "past month"
            }

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

🧪 Sample Output – search_alias
 "search_alias": {
                "title": "Sports & Outdoors",
                "value": "sporting"
            }

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

🧪 Sample Output – sub_title
 "sub_title": {
                "text": "Visit the STANLEY Store",
                "link": "https://amazon.com/stores/Stanley/page/47A7E765-00AF-4F34-AC01-240A7EDD822A?is_byline_deeplink=true&deeplink=58C928EE-BE91-4E58-A3C4-D0C520199A59&redirect_store_id=47A7E765-00AF-4F34-AC01-240A7EDD822A&lp_asin=B0DQY6J9TL&ref_=ast_bln&store_ref=bl_ast_dp_brandLogo_sto"
            }

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

🧪 Sample Output – rating_breakdown
 "rating_breakdown": {
                "five_star": {
                    "percentage": 85,
                    "count": 49858
                },
                "four_star": {
                    "percentage": 7,
                    "count": 4106
                },
                "three_star": {
                    "percentage": 3,
                    "count": 1760
                },
                "two_star": {
                    "percentage": 2,
                    "count": 1173
                },
                "one_star": {
                    "percentage": 3,
                    "count": 1760
                }
            }

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

🧪 Sample Output – main_image
"main_image": {
                "link": "617ecXxEdeL"
            }

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

🧪 Sample Output – main_image
 "first_available": {
                "raw": "February 4, 2025"
            }

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

🧪 Sample Output – brand_store
 "brand_store": {
                "id": "47A7E765-00AF-4F34-AC01-240A7EDD822A",
                "link": "https://amazon.com/stores/Stanley/page/47A7E765-00AF-4F34-AC01-240A7EDD822A?is_byline_deeplink=true&deeplink=58C928EE-BE91-4E58-A3C4-D0C520199A59&redirect_store_id=47A7E765-00AF-4F34-AC01-240A7EDD822A&lp_asin=B0DQY6J9TL&ref_=ast_bln&store_ref=bl_ast_dp_brandLogo_sto"
            }

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

🧪 Sample Output – similar_to_consider
"similar_to_consider": {
                "asin": "B0DQY6J9TL",
                "title": "BJPKPK Insulated Tumblers With Handle And Straw 30 oz Stainless Steel Tumbler Cups With Lid,Mint",
                "link": "/dp/B0CGX85ZL4/ref=vp_d_cpf-substitute-widget_pd?_encoding=UTF8&pf_rd_p=36830697-9a0f-4e73-abfa-25ba9c698528&pf_rd_r=P14C00M1DW24H2FWEB5X&pd_rd_wg=BKmAa&pd_rd_i=B0CGX85ZL4&pd_rd_w=twLpQ&content-id=amzn1.sym.36830697-9a0f-4e73-abfa-25ba9c698528&pd_rd_r=1e956515-54d4-476f-ac6a-616beb7f944b&psc=1",
                "rating": "a-icon a-icon-star a-star-4-5",
                "ratings_total": 3767,
                "is_prime": true,
                "price": {
                    "symbol": "$",
                    "value": 13.75,
                    "currency": "USD",
                    "raw": "$13.75"
                }
            }

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

🧪 Sample Output – bestseller_badge
 "bestseller_badge": {
                "link": "https://amazon.com/gp/bestsellers/kitchen/21613423011/ref=zg_b_bs_21613423011_1",
                "category": "Insulated Tumblers",
                "badge_text": "#1 Best Seller in Insulated Tumblers"
            }

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

🧪 Sample Output – buybox_winner
 "buybox_winner": {
                "offer_id": "gGp9lm9Dw4ZpqSdQZkjrdBPhDzM0SZ9VWpthH3lxBoAMMAJT8G0SgmM8zk2cPzV90aUvDbOw%2FIgzgiJ1zms%2BvP2i1lZx2H9Aa1m%2BCpK85cZh9lBivdSZhQEfyCcGJOLoo8Y4i7vLg8rX7TRHopz8xg%3D%3D",
                "is_prime": true,
                "is_amazon_fresh": false,
                "condition": {
                    "is_new": true
                },
                "price": {
                    "symbol": "$",
                    "value": 45,
                    "currency": "USD",
                    "raw": "$45.00"
                },
                "shipping": {
                    "raw": "FREE"
                },
                "rrp": {
                    "symbol": "$",
                    "value": "45.00",
                    "currency": "USD",
                    "raw": "45.00"
                },
                "fulfillment": {
                    "standard_delivery": {
                        "date": "Thursday, May 29",
                        "name": "FREE"
                    },
                    "fastest_delivery": {
                        "date": "Tomorrow, May 25Tuesday, May 27",
                        "name": "Tomorrow, May 25Tuesday, May 27"
                    }
                },
                "maximum_order_quantity": {
                    "value": 2,
                    "hard_maximum": true
                },
                "availability": {
                    "raw": "In Stock",
                    "min_quantity": 20,
                    "real_count": false
                },
                "secondary_buybox": {
                    "offer_id": "gGp9lm9Dw4ZpqSdQZkjrdBPhDzM0SZ9V2efEfvCkTqUnPdmqcPeAA1YK8MXd84DhsJ6eo5h8kikZ7%2FNssC%2FXV1GY%2BANZxuAeG%2B1B41kB2ubgbApob4i8JLskgE2TLU%2F1CFm46K1tckMAL9yt0cotVjBQXlG5lHts%2BqSkCrl9Wvu0o7axXwH11i2OYnjKp9Ra",
                    "caption": "Save with Used - Like New"
                }
            }

Last updated