Amazon MCP server for AI agents
Let Claude, ChatGPT or your own agent read and act on Amazon: 20 typed functions through one MCP server. No Amazon API key needed.
- Site
- amazon.com
- Functions
- 20
- Sign-in
- For account actions
- Works with
- MCP, HTTP, Node, Python
Connect
An MCP server for Amazon alone, with one tool per function. Paste it into Claude, ChatGPT, Cursor or any MCP client as a remote server.
https://api.bowmark.ai/mcp/site/amazonOne MCP server for Amazon and every other site Bowmark covers. Your agent looks up what it needs and calls it.
https://api.bowmark.ai/mcpSet it up in your clientBoth need a Bowmark API key. The quickstart gets you one and a first result in a few minutes. Functions that need a login use the person's own account: how sign-in works.
Functions
Open a function to see its arguments, what it returns and how to call it.
getCartRead what is in the cart, line items, quantities, per-item and total price, and, for a cart with items, a checkout handoff URL (checkout) for the…Arguments
Name Type Required opts{ connection?: string }No Returns
AmazonCartinterface AmazonCartItem { asin: string; title: string; quantity: number; price: number | null; } interface AmazonCart { itemCount: number; items: AmazonCartItem[]; readAs?: "signed-in" | "guest"; // addToCart and getCart, which cart answered // The checkout handoff. Amazon never gets an order from Bowmark: give the person handoff.url, tell them // handoff.account.hint, and stop. status "ready_to_checkout" (urlKind "carries_items": Amazon's own // add-to-cart link carrying every cart row, for a guest cart; or "signed_in_cart" with // account.signedInAs: the account's own cart page), "needs_login" (signed in, account name unknown: // the cart page, after signing in to the connected account), or "unavailable" with a reason // (out_of_stock, region_not_served, not_sold_online). Absent on getCart for an empty cart. A status // you do not recognise means: show the person handoff.url and stop. checkout?: { status: string; url: string; urlKind?: string; account: { site: string; hint: string; signedInAs?: string }; summary: unknown; warnings: string[]; reason?: string; detail?: string; }; warnings?: string[]; // only when the cart read answered but no handoff could be built from it }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/amazon/getCartCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.amazon.getCart();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.amazon.getCart())curl -X POST https://api.bowmark.ai/v1/sites/amazon/getCart \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.amazon.getCart();getDeliveryEstimateWhen a product would actually arrive at a given US ZIP, and what it costs to get it there.Arguments
Name Type Required productstringRequired: or pass it as asin, which the runtime reads as the same field.No asinstringNo zipstringYes Returns
AmazonDeliveryEstimateinterface AmazonDeliveryEstimate { asin: string; zip: string; zipResolved: boolean; // false = the fields below are Amazon's default location, not this zip deliveryDate: string | null; priceLabel: string | null; condition: string | null; // the site's own labels, read the values off a result, never guess one from prose options: { kind: "standard" | "fastest"; deliveryDate: string | null; deliveryDateIso: string | null; priceLabel: string | null; condition: string | null; cutoff: string | null }[]; // every promise the buy box renders; "fastest" = Prime/paid same- or next-day }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/amazon/getDeliveryEstimateCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.amazon.getDeliveryEstimate({ product: "B00006JSUA", zip: "10001" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.amazon.getDeliveryEstimate({"product": "B00006JSUA", "zip": "10001"}))curl -X POST https://api.bowmark.ai/v1/sites/amazon/getDeliveryEstimate \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"product":"B00006JSUA","zip":"10001"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.amazon.getDeliveryEstimate({ product: "B00006JSUA", zip: "10001" });getProductRead one product page on any Amazon market the way a shopper reads it.Arguments
Name Type Required asinOrUrlstringYes options.marketAmazonMarketWhich Amazon store to ask; amazon.com when omitted.No Returns
AmazonProductDetailinterface AmazonBestSellerRankEntry { category: string; rank: number; } interface AmazonProductDetail { asin: string; title: string; url: string; brand: string | null; price: number | null; listPrice: number | null; currency: string; // ISO 4217 of the prices on this row: the call's market ("USD" on amazon.com, "INR" on amazon.in) inStock: boolean; availabilityText: string | null; rating: number | null; ratingCount: number | null; features: string[]; // the site's own free-text bullet points, read them off a result, never guess one from prose specifications: Record<string, string>; breadcrumbs: string[]; bestSellersRank: AmazonBestSellerRankEntry[]; images: string[]; soldBy: string | null; sellerId: string | null; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/amazon/getProductCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.amazon.getProduct("B00006JSUA");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.amazon.getProduct("B00006JSUA"))curl -X POST https://api.bowmark.ai/v1/sites/amazon/getProduct \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"asinOrUrl":"B00006JSUA"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.amazon.getProduct("B00006JSUA");getReviewSummaryWhat reviewers say about a product, as Amazon shows it to a shopper who is not logged in: the star rating, the rating count, the percent at each…Arguments
Name Type Required asinOrUrlstringYes options.marketAmazonMarketWhich Amazon store to ask; amazon.com when omitted.No Returns
AmazonReviewSummaryinterface AmazonReviewAspect { label: string; // Amazon's own, e.g. "ease of cleaning" sentiment: string; // "positive" | "negative" | "mixed" mentions: number | null; // how many reviews mention it summary: string; excerpts: Array<{ reviewId: string; text: string }>; // real review excerpts, verbatim } interface AmazonReviewSummary { asin: string; rating: number | null; ratingCount: number | null; histogram: Record<string, number>; // percent at each star, keyed "5" … "1" summary: string | null; // the "Customers say" paragraph aspects: AmazonReviewAspect[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/amazon/getReviewSummaryCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.amazon.getReviewSummary("B00006JSUA");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.amazon.getReviewSummary("B00006JSUA"))curl -X POST https://api.bowmark.ai/v1/sites/amazon/getReviewSummary \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"asinOrUrl":"B00006JSUA"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.amazon.getReviewSummary("B00006JSUA");getSellerRead a marketplace seller's storefront.Arguments
Name Type Required sellerIdstringYes options.marketAmazonMarketWhich Amazon store to ask; amazon.com when omitted.No Returns
AmazonSellerinterface AmazonSellerRatingPeriod { averageRating: number | null; ratingCount: number | null; } interface AmazonSeller { sellerId: string; name: string; positivePercentageLast12Months: number | null; // Amazon's own headline figure; no lifetime equivalent is published ratings: { last30Days: AmazonSellerRatingPeriod; last90Days: AmazonSellerRatingPeriod; last12Months: AmazonSellerRatingPeriod; lifetime: AmazonSellerRatingPeriod; }; businessName: string | null; businessAddress: string[]; aboutSeller: string | null; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/amazon/getSellerCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.amazon.getSeller("AYBHI2AQPIRDU");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.amazon.getSeller("AYBHI2AQPIRDU"))curl -X POST https://api.bowmark.ai/v1/sites/amazon/getSeller \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"sellerId":"AYBHI2AQPIRDU"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.amazon.getSeller("AYBHI2AQPIRDU");listBestSellerCategoriesList the departments Amazon publishes rankings for.Arguments
Name Type Required marketAmazonMarketWhich Amazon store to ask; amazon.com when omitted.No Returns
AmazonBestSellerCategory[]interface AmazonBestSellerCategory { name: string; slug: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/amazon/listBestSellerCategoriesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.amazon.listBestSellerCategories();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.amazon.listBestSellerCategories())curl -X POST https://api.bowmark.ai/v1/sites/amazon/listBestSellerCategories \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.amazon.listBestSellerCategories();listBestSellersAmazon's hourly-updated top 100 in a department.Arguments
Name Type Required argsstring | ListBestSellersArgsYes options.marketAmazonMarketWhich Amazon store to ask; amazon.com when omitted.No type AmazonMarket = "com" | "in" | "com.br" | "ca" | "co.uk" | "de" | "fr" | "com.mx"; interface ListBestSellersArgs { market?: AmazonMarket; // which Amazon store: "com" (default), "in", "com.br", "ca", "co.uk", "de", "fr", "com.mx" department: string; page?: number; }Returns
AmazonBestSellerEntry[]interface AmazonBestSellerEntry { asin: string; rank: number; title: string; url: string; price: number | null; currency: string; // ISO 4217 of the prices on this row: the call's market ("USD" on amazon.com, "INR" on amazon.in) rating: number | null; ratingCount: number | null; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/amazon/listBestSellersCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.amazon.listBestSellers("kitchen");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.amazon.listBestSellers("kitchen"))curl -X POST https://api.bowmark.ai/v1/sites/amazon/listBestSellers \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":"kitchen"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.amazon.listBestSellers("kitchen");listCategoryProductsBrowse a whole department with no keyword at all.Arguments
Name Type Required marketAmazonMarketWhich Amazon store: "com" (default), "in", "com.br", "ca", "co.uk", "de", "fr", "com.mx".No departmentstringYes sortstringNo pagenumberNo Returns
AmazonCategoryListinginterface AmazonProduct { asin: string; title: string; url: string; price: number | null; listPrice: number | null; currency: string; // ISO 4217 of the prices on this row: the call's market ("USD" on amazon.com, "INR" on amazon.in) rating: number | null; ratingCount: number | null; sponsored: boolean; image: string | null; // the card's thumbnail URL } interface AmazonCategoryListing { department: string; // display label, e.g. "Kitchen & Dining", not an input anywhere departmentAlias: string; // the &i= alias that produced the page: pass THIS back to listCategoryProducts / searchProducts as department (not a listBestSellers slug) products: AmazonProduct[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/amazon/listCategoryProductsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.amazon.listCategoryProducts({ department: "kitchen", sort: "review-rank" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.amazon.listCategoryProducts({"department": "kitchen", "sort": "review-rank"}))curl -X POST https://api.bowmark.ai/v1/sites/amazon/listCategoryProducts \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"department":"kitchen","sort":"review-rank"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.amazon.listCategoryProducts({ department: "kitchen", sort: "review-rank" });listDealsToday's Deals, what is discounted right now, with the deal price, the price it was, the percentage off and any "limited time" wording.Arguments
Name Type Required marketAmazonMarketWhich Amazon store to ask; amazon.com when omitted.No Returns
AmazonDeal[]interface AmazonDeal { asin: string; title: string; url: string; dealPrice: number; listPrice: number | null; currency: string; // ISO 4217 of the prices on this row: the call's market ("USD" on amazon.com, "INR" on amazon.in) percentOff: number | null; limitedTimeText: string | null; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/amazon/listDealsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.amazon.listDeals();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.amazon.listDeals())curl -X POST https://api.bowmark.ai/v1/sites/amazon/listDeals \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.amazon.listDeals();listMostWishedForWhat people in a department are adding to wish lists and registries most.Arguments
Name Type Required departmentstringYes options.marketAmazonMarketWhich Amazon store to ask; amazon.com when omitted.No Returns
AmazonBestSellerEntry[]interface AmazonBestSellerEntry { asin: string; rank: number; title: string; url: string; price: number | null; currency: string; // ISO 4217 of the prices on this row: the call's market ("USD" on amazon.com, "INR" on amazon.in) rating: number | null; ratingCount: number | null; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/amazon/listMostWishedForCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.amazon.listMostWishedFor("kitchen");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.amazon.listMostWishedFor("kitchen"))curl -X POST https://api.bowmark.ai/v1/sites/amazon/listMostWishedFor \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"department":"kitchen"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.amazon.listMostWishedFor("kitchen");listNewReleasesWhat is newly out in a department, in Amazon's own hot-new-releases order.Arguments
Name Type Required argsstring | ListBestSellersArgsYes options.marketAmazonMarketWhich Amazon store to ask; amazon.com when omitted.No type AmazonMarket = "com" | "in" | "com.br" | "ca" | "co.uk" | "de" | "fr" | "com.mx"; interface ListBestSellersArgs { market?: AmazonMarket; // which Amazon store: "com" (default), "in", "com.br", "ca", "co.uk", "de", "fr", "com.mx" department: string; page?: number; }Returns
AmazonBestSellerEntry[]interface AmazonBestSellerEntry { asin: string; rank: number; title: string; url: string; price: number | null; currency: string; // ISO 4217 of the prices on this row: the call's market ("USD" on amazon.com, "INR" on amazon.in) rating: number | null; ratingCount: number | null; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/amazon/listNewReleasesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.amazon.listNewReleases("kitchen");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.amazon.listNewReleases("kitchen"))curl -X POST https://api.bowmark.ai/v1/sites/amazon/listNewReleases \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":"kitchen"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.amazon.listNewReleases("kitchen");listOrdersThe signed-in customer's own Amazon orders, newest first.Arguments
Name Type Required args{ limit?: number; cursor?: string }No Returns
SignedInOrderPageinterface SignedInOrder { id: string; // Amazon's order number, e.g. "114-1234567-1234567" placedAt: string | null; // YYYY-MM-DD status: string; // Amazon's own words: "Delivered October 5", "Cancelled", "Refunded" total: number | null; // dollars currency: string | null; // "USD" merchant: string | null; // always null here, Amazon's card does not name a seller itemCount: number | null; url: string; // the order's details page } interface SignedInOrderPage { orders: SignedInOrder[]; // newest first nextCursor: string | null; // pass back as { cursor } for older orders }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/amazon/listOrdersCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.amazon.listOrders();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.amazon.listOrders())curl -X POST https://api.bowmark.ai/v1/sites/amazon/listOrders \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.amazon.listOrders();listRelatedProductsThe other products Amazon puts next to this one.Arguments
Name Type Required asinOrUrlstringYes options.marketAmazonMarketWhich Amazon store to ask; amazon.com when omitted.No Returns
AmazonRelatedProductsinterface AmazonRelatedProduct { asin: string; title: string; url: string; price: number | null; currency: string; // ISO 4217 of the prices on this row: the call's market ("USD" on amazon.com, "INR" on amazon.in) rating: number | null; // null on a "Frequently bought together" row, that rail never shows one ratingCount: number | null; } interface AmazonRelatedProducts { boughtTogether: AmazonRelatedProduct[]; // complements, never the current ASIN related: AmazonRelatedProduct[]; // "Customers who viewed this item also viewed", substitutes unavailableRails: string[]; // sims-consolidated-N_feature_div ids Amazon lazy-loads rather than serving inline }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/amazon/listRelatedProductsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.amazon.listRelatedProducts("B00006JSUA");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.amazon.listRelatedProducts("B00006JSUA"))curl -X POST https://api.bowmark.ai/v1/sites/amazon/listRelatedProducts \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"asinOrUrl":"B00006JSUA"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.amazon.listRelatedProducts("B00006JSUA");listReviewsRead what customers actually wrote about a product.Arguments
Name Type Required asinOrUrlstringYes options.marketAmazonMarketWhich Amazon store to ask; amazon.com when omitted.No Returns
AmazonReview[]interface AmazonReview { reviewId: string; author: string; rating: number; title: string; date: string; // the site's own sentence, e.g. "Reviewed in the United States on August 9, 2026" variant: string | null; // e.g. "Style: Skillet, Size: 15-inch" verifiedPurchase: boolean; body: string; // paragraphs joined with a blank line, in the site's own order helpfulCount: number; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/amazon/listReviewsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.amazon.listReviews("B00006JSUA");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.amazon.listReviews("B00006JSUA"))curl -X POST https://api.bowmark.ai/v1/sites/amazon/listReviews \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"asinOrUrl":"B00006JSUA"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.amazon.listReviews("B00006JSUA");listSellerOffersEvery seller offering the same product, side by side.Arguments
Name Type Required asinOrUrlstringYes options.marketAmazonMarketWhich Amazon store to ask; amazon.com when omitted.No Returns
AmazonSellerOffersResultinterface AmazonSellerOffer { condition: string; // e.g. "New", "Used - Good", "Used - Acceptable", read the values off a result, never guess one from prose price: number | null; currency: string; // ISO 4217 of the prices on this row: the call's market ("USD" on amazon.com, "INR" on amazon.in) shippingCost: number | null; // derived from shippingLabel ("FREE" -> 0) shippingLabel: string | null; // the site's own delivery-price label, e.g. "FREE" or "$3.99" deliveryEstimate: string | null; // e.g. "September 24 - 29" sellerName: string; // "Amazon.com" when Amazon itself is the seller sellerId: string | null; // null when sold by Amazon.com itself, getSeller's argument otherwise sellerRating: number | null; // 0-5 sellerRatingCount: number | null; } interface AmazonSellerOffersResult { asin: string; totalOfferCount: number | null; // Amazon's own count, including offers this page did not render offers: AmazonSellerOffer[]; // page one only, up to 10, see the note on listSellerOffers }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/amazon/listSellerOffersCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.amazon.listSellerOffers("0486404536");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.amazon.listSellerOffers("0486404536"))curl -X POST https://api.bowmark.ai/v1/sites/amazon/listSellerOffers \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"asinOrUrl":"0486404536"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.amazon.listSellerOffers("0486404536");listVariationsList every version of a product that is really the same listing.Arguments
Name Type Required asinOrUrlstringYes options.marketAmazonMarketWhich Amazon store to ask; amazon.com when omitted.No Returns
AmazonVariation[]interface AmazonVariation { asin: string; dimensions: Record<string, string>; // e.g. { style_name: "Skillet", size_name: "12-inch" }, the site's own dimension names isCurrent: boolean; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/amazon/listVariationsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.amazon.listVariations("B00006JSUA");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.amazon.listVariations("B00006JSUA"))curl -X POST https://api.bowmark.ai/v1/sites/amazon/listVariations \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"asinOrUrl":"B00006JSUA"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.amazon.listVariations("B00006JSUA");searchProductsSearch any Amazon market by keywords.Arguments
Name Type Required argsSearchProductsArgsYes type AmazonMarket = "com" | "in" | "com.br" | "ca" | "co.uk" | "de" | "fr" | "com.mx"; // `query` is the same field as `keywords`: the runtime reads either, so the type admits either. // `market` picks which Amazon store: "com" (default), "in", "com.br", "ca", "co.uk", "de", "fr", "com.mx". type SearchProductsArgs = | { market?: AmazonMarket; keywords: string; department?: string; sort?: string; priceMin?: number; priceMax?: number; brand?: string; page?: number } | { market?: AmazonMarket; query: string; department?: string; sort?: string; priceMin?: number; priceMax?: number; brand?: string; page?: number };Returns
AmazonSearchResultinterface AmazonProduct { asin: string; title: string; url: string; price: number | null; listPrice: number | null; currency: string; // ISO 4217 of the prices on this row: the call's market ("USD" on amazon.com, "INR" on amazon.in) rating: number | null; ratingCount: number | null; sponsored: boolean; image: string | null; // the card's thumbnail URL } interface AmazonSearchResult { products: AmazonProduct[]; totalResultCount: number; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/amazon/searchProductsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.amazon.searchProducts({ keywords: "cast iron skillet" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.amazon.searchProducts({"keywords": "cast iron skillet"}))curl -X POST https://api.bowmark.ai/v1/sites/amazon/searchProducts \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"keywords":"cast iron skillet"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.amazon.searchProducts({ keywords: "cast iron skillet" });searchWholeFoodsSearch Whole Foods Market groceries on amazon.com by keyword and get product cards with current price and list price.Arguments
Name Type Required keywordsstringYes sortstringNo pagenumberNo Returns
AmazonSearchResultinterface AmazonProduct { asin: string; title: string; url: string; price: number | null; listPrice: number | null; currency: string; // ISO 4217 of the prices on this row: the call's market ("USD" on amazon.com, "INR" on amazon.in) rating: number | null; ratingCount: number | null; sponsored: boolean; image: string | null; // the card's thumbnail URL } interface AmazonSearchResult { products: AmazonProduct[]; totalResultCount: number; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/amazon/searchWholeFoodsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.amazon.searchWholeFoods({ keywords: "organic bananas" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.amazon.searchWholeFoods({"keywords": "organic bananas"}))curl -X POST https://api.bowmark.ai/v1/sites/amazon/searchWholeFoods \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"keywords":"organic bananas"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.amazon.searchWholeFoods({ keywords: "organic bananas" });suggestKeywordsAsk Amazon's own search box what it would autocomplete a prefix to.Arguments
Name Type Required prefixstringYes options.marketAmazonMarketWhich Amazon store to ask; amazon.com when omitted.No Returns
AmazonKeywordSuggestion[]interface AmazonKeywordSuggestion { value: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/amazon/suggestKeywordsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.amazon.suggestKeywords("cast iron");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.amazon.suggestKeywords("cast iron"))curl -X POST https://api.bowmark.ai/v1/sites/amazon/suggestKeywords \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"prefix":"cast iron"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.amazon.suggestKeywords("cast iron");
addToCartAdd a product to the cart and hand back a checkout link for everything the cart now holds; Bowmark never places the order and never reaches checkout…Arguments
Name Type Required asinOrUrlstring | { asin: string; quantity?: number } | { product: string | { asin: string }; quantity?: number } | { url: string; quantity?: number }Yes opts{ connection?: string }No Returns
AmazonCartinterface AmazonCartItem { asin: string; title: string; quantity: number; price: number | null; } interface AmazonCart { itemCount: number; items: AmazonCartItem[]; readAs?: "signed-in" | "guest"; // addToCart and getCart, which cart answered // The checkout handoff. Amazon never gets an order from Bowmark: give the person handoff.url, tell them // handoff.account.hint, and stop. status "ready_to_checkout" (urlKind "carries_items": Amazon's own // add-to-cart link carrying every cart row, for a guest cart; or "signed_in_cart" with // account.signedInAs: the account's own cart page), "needs_login" (signed in, account name unknown: // the cart page, after signing in to the connected account), or "unavailable" with a reason // (out_of_stock, region_not_served, not_sold_online). Absent on getCart for an empty cart. A status // you do not recognise means: show the person handoff.url and stop. checkout?: { status: string; url: string; urlKind?: string; account: { site: string; hint: string; signedInAs?: string }; summary: unknown; warnings: string[]; reason?: string; detail?: string; }; warnings?: string[]; // only when the cart read answered but no handoff could be built from it }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/amazon/addToCartCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.amazon.addToCart("<asinOrUrl>");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.amazon.addToCart("<asinOrUrl>"))curl -X POST https://api.bowmark.ai/v1/sites/amazon/addToCart \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"asinOrUrl":"<asinOrUrl>"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.amazon.addToCart("<asinOrUrl>");
Use it from code
- Node
npm i @bowmark/web - Python
pip install bowmark-web - HTTP
POST /v1/sites/amazon/<function> - OpenAPI
/v1/sites/amazon/openapi.json