MCP Integration Model Context Protocol

Returns each ASIN on page one with its rank position, sponsored flag, price (incl. list price, discount %, coupon, and per-item price when present), review count, rating, monthly-sales estimate, Prime/stock, delivery estimates, and badges. Also returns any banners — the Sponsored Brands ad(s) at the top of the page (brand, headline, promoted ASINs) — plus related_keywords, the sponsored/total counts, and the delivery location. Pass an optional asin to get a target block with that product's exact position and full detail (it flags the known "not ranked" long-tail blind spot rather than silently dropping it). Pass an optional zip to localize the SERP to a delivery location — Amazon's ranking and which products appear vary by zip, and pinning one makes results stable and comparable across calls (without it the data service picks a location itself). delivery_to reflects the zip used.

Example result

The structured content the tool returns to your assistant.

{
    "query": "insulated water bottle",
    "marketplace": "us",
    "delivery_to": "Atlanta 30303",
    "total_results": 35618,
    "result_count": 48,
    "asin_count": 48,
    "sponsored_count": 0,
    "banners": [
        {
            "position": 0,
            "brand": "Stanley 1913",
            "headline": "Stay Hydrated All Summer",
            "seller_id": "AO1K5E7PGBCWQ",
            "asins": ["B0G96GNQSW", "B0GNCW7WG6", "B0G77D5SBY"],
            "ad_id": "301321056000602",
            "campaign_id": "200086555579371",
            "creative_id": "0"
        }
    ],
    "products": [
        {
            "asin": "B0D8J2ZB8P",
            "rank": 1,
            "sponsored": false,
            "title": "POWCAN 26 oz Insulated Water Bottle with 2-in-1 Straw and Spout Lid ...",
            "image_url": "https://m.media-amazon.com/images/I/515ELeeh4OL._AC_UL320_.jpg",
            "price": "$14.98",
            "price_num": 14.98,
            "list_price": 18.99,
            "price_per_item": null,
            "discount_pct": 21.12,
            "discount_amount": 4.01,
            "coupon": null,
            "rating": 4.6,
            "reviews": 11208,
            "monthly_sales": 9000,
            "is_prime": true,
            "stock_level": null,
            "free_delivery": "FREE delivery Tue, Jul 28",
            "fastest_delivery": "Tue, Jul 28",
            "html_index": 3,
            "badges": []
        },
        {
            "asin": "B085DTZQNZ",
            "rank": 2,
            "sponsored": false,
            "title": "Owala FreeSip Insulated Stainless Steel Water Bottle with Straw, 24 oz ...",
            "image_url": "https://m.media-amazon.com/images/I/718RbhzhVbL._AC_UL320_.jpg",
            "price": "$29.97",
            "price_num": 29.97,
            "list_price": null,
            "price_per_item": null,
            "discount_pct": null,
            "discount_amount": null,
            "coupon": null,
            "rating": 4.7,
            "reviews": 130660,
            "monthly_sales": 20000,
            "is_prime": true,
            "stock_level": null,
            "free_delivery": "FREE delivery Tue, Jul 28",
            "fastest_delivery": "Tue, Jul 28",
            "html_index": 5,
            "badges": ["best_seller"]
        }
    ],
    "brands": [],
    "related_keywords": ["water bottle", "insulated water bottle 32oz", "insulated water bottle 40oz"],
    "has_more": true
}

Returns the owning seller id and name, winning price/currency, in-stock flag and stock "only N left" counter, FBA vs. merchant + ships_from, Prime status, and any used/used_price offer. seller_id, ships_from, fba, stock, and the used-offer fields are null when Amazon itself holds the Buy Box and populate for third-party listings. Pass an optional zip to add a location-specific delivery estimate — the response then also includes delivery_to, fastest_delivery, free_delivery, and free_shipping (only a fixed set of US postal codes is supported; others return an error).

Example result

The structured content the tool returns to your assistant.

{
    "asin": "B085DTZQNZ",
    "marketplace": "us",
    "seller_id": null,
    "sold_by": "Amazon.com",
    "price": 29.97,
    "currency": "$",
    "in_stock": true,
    "stock": null,
    "prime": true,
    "ships_from": null,
    "fba": null,
    "used": null,
    "used_price": null,
    "competing_offers": null,
    "zip": "30303",
    "delivery_to": "Atlanta 30303",
    "fastest_delivery": "Friday, July 24",
    "free_delivery": "Tuesday, July 28",
    "free_shipping": true
}

The mobile results can differ substantially from desktop — different ordering and a different number of sponsored placements. Same envelope as Keyword Rank (see that tool for the full field list); pass an optional asin to locate its mobile position. Amazon's mobile page exposes fewer fields per product, so some values come back null (e.g. price_num, reviews, discount details) and there are no top-ad banners or related_keywords. Pass an optional zip to localize results (same behavior as Keyword Rank).

Example result

The structured content the tool returns to your assistant.

{
    "query": "insulated water bottle",
    "marketplace": "us",
    "delivery_to": "Deliver to 11226",
    "total_results": 34953,
    "result_count": 21,
    "asin_count": 21,
    "sponsored_count": 7,
    "banners": [],
    "products": [
        {
            "asin": "B0CQZJPPKM",
            "rank": 1,
            "sponsored": true,
            "title": "WATERSY Stainless Steel Water Bottles, 17oz/500ml Insulated ...",
            "image_url": "https://m.media-amazon.com/images/I/61A0N+rp05L._AC_SX148_SY213_QL70_.jpg",
            "price": "$11.99",
            "price_num": null,
            "list_price": null,
            "price_per_item": null,
            "discount_pct": null,
            "discount_amount": null,
            "coupon": null,
            "rating": 4.5,
            "reviews": null,
            "monthly_sales": 800,
            "is_prime": false,
            "stock_level": null,
            "free_delivery": null,
            "fastest_delivery": null,
            "html_index": null,
            "badges": []
        },
        {
            "asin": "B085DTZQNZ",
            "rank": 3,
            "sponsored": false,
            "title": "Owala FreeSip Stainless Steel Water Bottle 24 oz ...",
            "image_url": "https://m.media-amazon.com/images/I/718RbhzhVbL._AC_SX148_SY213_QL70_.jpg",
            "price": "$29.97",
            "price_num": null,
            "list_price": null,
            "price_per_item": null,
            "discount_pct": null,
            "discount_amount": null,
            "coupon": null,
            "rating": 4.7,
            "reviews": null,
            "monthly_sales": 30000,
            "is_prime": false,
            "stock_level": null,
            "free_delivery": null,
            "fastest_delivery": null,
            "html_index": null,
            "badges": ["overall_pick"]
        }
    ],
    "brands": [],
    "related_keywords": [],
    "has_more": false
}

Parses the major elements out of the live product page into a product object — title, brand, star rating and ratings count, "about this item" bullets, category breadcrumbs, Best Sellers Rank, image URLs, availability, variations (colour/size/style and the sibling ASINs), badges (e.g. frequently_returned, amazons_choice, climate_pledge_friendly), whether it has A+ content, and the buy-box seller/fulfillment. Also returns a full details attribute table (material, dimensions, weight, UPC/GTIN, model, care instructions, …), the AI-generated customer_say review summary, monthly_sales (recent purchase volume), and A+ image URLs. The parsed fields are returned by default; set html=true (REST) to also include the full page HTML. (For a reliable price/currency, use buybox.)

Parsed fields are returned by default; add html=true (REST) for the full page HTML. Free repeats: re-requesting the same ASIN + marketplace within the freshness window (default 1 hour; see the since parameter) is served from cache and is not metered (cached: true) — so fetching parsed over MCP and then the full HTML via REST within that window counts as one request.

Example result

The structured content the tool returns to your assistant.

{
    "asin": "B085DTZQNZ",
    "marketplace": "us",
    "delivery_to": "Atlanta 30303",
    "html_bytes": 2585911,
    "cached": false,
    "product": {
        "parsed": true,
        "title": "Owala FreeSip Insulated Stainless Steel Water Bottle with Straw, 24 oz ...",
        "brand": "Owala",
        "rating": 4.7,
        "ratings_count": 130660,
        "availability": "In Stock",
        "bullets": ["...", "..."],
        "category": [
            "Home & Kitchen",
            "Kitchen & Dining",
            "Storage & Organization",
            "Thermoses",
            "Insulated Beverage Containers"
        ],
        "best_sellers_rank": [
            { "rank": 1, "category": "Kitchen & Dining" }
        ],
        "images": [
            "https://m.media-amazon.com/images/I/718RbhzhVbL._AC_SL1500_.jpg",
            "https://m.media-amazon.com/images/I/51NEAowN4KL._AC_SL1080_.jpg"
        ],
        "buybox": {
            "fba": true,
            "sold_by_amazon": true,
            "ships_from": "Amazon",
            "seller_name": "Amazon.com",
            "seller_id": "ATVPDKIKX0DER"
        },
        "variations": {
            "count": 93,
            "dimensions": ["size_name"],
            "values": { "size_name": ["24 oz", "32 oz", "40 oz"] },
            "current": ["24 oz"],
            "asins": [{ "asin": "B0BZYCJK89", "values": ["32 oz"] }]
        },
        "badges": [
            "amazons_choice",
            "climate_pledge_friendly"
        ],
        "details": {
            "Brand": "Owala",
            "Material": "Stainless Steel",
            "Capacity": "24 fluid ounces",
            "Item Weight": "13.6 ounces",
            "UPC": "847280062256"
        },
        "customer_say": "Customers love this bottle for its temperature retention, leak-proof design, and hidden straw; durability gets mixed feedback.",
        "monthly_sales": 30000,
        "has_aplus": true,
        "aplus_images": [
            "https://m.media-amazon.com/images/S/aplus-media-library-service-media/....png"
        ]
    }
}

Returns a sample of a product's reviews (roughly a dozen top/recent reviews per marketplace, not the full set) with rating, author, verified-purchase flag, helpful count, variant, and date.

Returns only a sample (about a dozen reviews) and does not page deeply. Content is limited: review title and body text are frequently empty (metadata only), and aggregate figures such as the total rating count are not provided — for a product's total review count use keyword_rank.

Example result

The structured content the tool returns to your assistant.

{
    "asin": "B085DTZQNZ",
    "marketplace": "us",
    "page": 1,
    "review_count": 13,
    "total_ratings": null,
    "with_reviews": null,
    "has_more": false,
    "reviews": [
        {
            "id": "R2JOXHNAD1YZ3R",
            "rating": 5,
            "author": "A. Shopper",
            "verified": true,
            "variant": "Size: 24 oz, Colour: Very, Very Dark",
            "date": "Reviewed in the United States on 8 June 2026",
            "helpful": 16
        }
    ]
}

Returns the seller name, star rating, rating count, description, and registered business details.

Example result

The structured content the tool returns to your assistant.

{
    "seller_id": "A2NQT1E7XE9C8I",
    "marketplace": "us",
    "name": "RAYMYLO Direct",
    "rating": "4.9",
    "rating_count": "543",
    "description": "RAYMYLO Direct is committed to providing each customer with the highest standard of customer service.",
    "details": [
        "Business Name:",
        "ShenZhenShiJunXinLaiKeJiYouXianGongSi",
        "Business Address:",
        "Bantian Street",
        "Kaisa Yunwangfu Building 3, Room 2904",
        "Shenzhen",
        "Longgang District",
        "Guangdong",
        "518000",
        "CN"
    ],
    "logo_url": "https://m.media-amazon.com/images/S/..."
}

Lists the delivery codes that keyword_rank, mobile_search, and buybox accept as an optional zip (unsupported codes are rejected). Returns { zip, delivery } rows for the marketplace. Not metered — it doesn't spend credits. The full list is also browsable at /docs/zip-codes.

Un-metered. Use it to pick a valid zip before calling a tool that takes one.

Example result

The structured content the tool returns to your assistant.

{
    "marketplace": "us",
    "count": 308,
    "zips": [
        { "zip": "10001", "delivery": "NEW YORK - 10001" },
        { "zip": "30303", "delivery": "ATLANTA - 30303" },
        { "zip": "90001", "delivery": "LOS ANGELES - 90001" }
    ]
}