{"data":{"name":"app.apiguru/amazon-data","title":"Apiguru Amazon Data","description":"Live Amazon product, review, search, deal, offer/stock and seller data across 23 marketplaces.","version":"1.1.69","websiteUrl":"https://apiguru.app","repositoryUrl":"https://github.com/apiguru-app/agent-kit","remotes":[{"type":"streamable-http","url":"https://mcp.apiguru.app/mcp","headers":[{"description":"Optional. Apiguru API key. Omit it to use the keyless free-probe-then-402 path.","isSecret":true,"name":"X-API-KEY"}]}],"packages":[{"registryType":"pypi","identifier":"apiguru-mcp","version":"1.1.69","runtimeHint":"stdio","runtimeArguments":null,"environmentVariables":null},{"registryType":"npm","identifier":"apiguru-mcp","version":"1.1.69","runtimeHint":"stdio","runtimeArguments":null,"environmentVariables":null}],"status":"active","isLatest":true,"publishedAt":"2026-11-19T11:49:31.242Z","updatedAt":"2026-11-19T11:49:31.242Z","source":"official-registry","verification":"official","confidence":100,"stars":null,"sources":[{"source":"official-registry","sourceId":"app.apiguru/amazon-data","verification":"official","confidence":100,"stars":null,"updatedAt":"2026-11-19T11:49:31.242Z","title":"Apiguru Amazon Data","description":"Live Amazon product, review, search, deal, offer/stock and seller data across 23 marketplaces.","websiteUrl":"https://apiguru.app","repositoryUrl":"https://github.com/apiguru-app/agent-kit"}],"toolIndex":{"tools":[{"serverName":"app.apiguru/amazon-data","endpointFingerprint":"4aac7ba000e1ed402cdea8eae911c2fc4fe5a422db23fc660fa1d009498ac4be","name":"best_sellers","title":"Best-seller rankings for a category","description":"Use for what sells best in a department right now. The rank is Amazon's, not a sales figure. Best-seller rankings for a department of one marketplace, 50 per page. Every answer carries the department it resolved to and how (category_resolution: by slug, name or a fragment of a name, with a hint when a fragment such as 'shoes' landed on the whole 'Clothing, Shoes & Jewelry' department, or 'subcategory' when a word such as 'camera' named a subcategory), available_categories (that marketplace's departments with slugs; MCP: with compact=false) and available_subcategories (the children of the node shown, with the ids subcategory_code takes). On amazon.com subcategory_code also takes any browse node id at any depth, or a name resolved under the department (\"women's shoes\", \"mules & clogs\"); category.subcategory_path gives the node's full path and category.heading the page's own title line. Price: $0.003 per call. No required parameters - calling it bare returns US appliances page 1. `category` accepts a slug, a display name, one of the older US department names, or a unique fragment; category_resolution.via says which, and a fragment match adds a hint naming the subcategories that carry the word, with ids. On amazon.com the whole browse tree is known: subcategory_code takes any node id or a name at any depth, subcategory_name and subcategory_path are filled without a fetch, and available_subcategories lists the node's real children (empty on a leaf). Other marketplaces name only what their navigation showed. page is capped at 5 (a 400 beyond, not a 500). `rank` is the position within the requested list on this page. Rows are the same for every marketplace; only the department vocabulary differs, and the answer carries it.","inputSchema":{"type":"object","properties":{"category":{"default":"appliances","description":"Best-seller department, by slug or by name as Amazon shows it for that marketplace (case-insensitive; a unique fragment works, and the answer's category_resolution says when a fragment was used -- 'shoes' is the whole 'Clothing, Shoes & Jewelry' department, and the hint then lists the Shoes subcategories with their ids). Departments and their slugs differ per marketplace: amazon.com has electronics, amazon.de has ce-de (Electronics & Photo). A word that names a subcategory works too: category=camera on amazon.es is Electronics > Camera & Photo (category_resolution.via says 'subcategory'; several equally good matches are a free 400 listing each as category + subcategory_code). REST answers list the marketplace's departments under available_categories (the MCP tool with compact=false); an unknown name is a free 400 listing them.","title":"Category","type":"string"},"subcategory_code":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Browse node id under `category`: one from available_subcategories of a previous answer, or on amazon.com any node id at any depth (679410011 is Women > Shoes > Mules & Clogs) or a name resolved under the department (\"women's shoes\", \"mens boots\", \"mules & clogs\"). A name that fits two nodes equally (Men > Shoes > Boots and Women > Shoes > Boots) is a free 400 listing both ids with their paths.","title":"Subcategory Code"},"page":{"default":1,"description":"Result page, 1-based, 50 rows each; Amazon's lists stop at page 5.","maximum":5,"minimum":1,"title":"Page","type":"integer"},"geo":{"default":"US","description":"Marketplace country code.","enum":["US","CA","DE","MX","UK","FR","IT","ES","AU","BR","IN","JP","NL","AE","PL","SA","SG","SE","TR","BE","IE","ZA","EG"],"title":"Geo","type":"string"},"limit":{"default":10,"description":"How many ranked products to return from this page (0 = all of them). A full page is up to 48 rows and about 54 KB, which most clients spill to a file instead of showing inline. The answer carries _truncated with the true count when it trims.","minimum":0,"title":"Limit","type":"integer"},"compact":{"default":true,"description":"Return light rows: identity, price, rating, badges and one delivery_date, dropping the long delivery prose that repeats itself across three fields. false returns every field the REST API sends (roughly 3x the size).","title":"Compact","type":"boolean"},"fields":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Comma-separated row fields to return instead of the light set, e.g. \"asin,product_title,product_price\". Rows list what they left out under _omitted_fields.","title":"Fields"}},"title":"best_sellersArguments"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true},"definitionHash":"aa22a84a33e171a8da7452696aeb6d22cf7336296be1572ba24e332f4d057a28","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-14T01:47:08.661Z","metadataTrust":"untrusted"},{"serverName":"app.apiguru/amazon-data","endpointFingerprint":"4aac7ba000e1ed402cdea8eae911c2fc4fe5a422db23fc660fa1d009498ac4be","name":"deals","title":"Current Amazon deals with filters","description":"Use for items currently promoted in Amazon's deals feed. Not for one product's price (product_details); for a brand by name use search with brand= and today_deals=true. Returns the current Amazon deals feed: ASIN, title, deal price, list price, discount, deal badge, start/end time and product links. Filter by department (categories), brand id (brands), rating cut-off, price bounds, minimum discount and Prime program. Every answer carries available_filters (the category and brand ids this marketplace accepts, with names), filters_applied / filters_ignored (what took effect) and next_offset (the next page, null when the feed ends). Price: $0.003 per call. Filters are by id: categories takes a department id or name, brands takes brand ids only; available_filters in every answer lists both with names, and filters_applied / filters_ignored report what Amazon honoured. A page is 30 rows; page with offset=next_offset (null when exhausted); total_count caps at 500. min_price, max_price, min_discount and max_discount are applied to the rows after retrieval, scanning up to 3 feed pages per call, so a page can hold fewer than 30 rows and total_count does not reflect them. An empty answer carries a hint saying why. Deal prices expire: check deal_ends_at. The older price_range and discount_range parameters are still accepted, as buckets (1-5 = under 25 / 25-50 / 50-100 / 100-200 / 200 and up; 1-4 = 10 / 25 / 50 / 70 percent off or more) or as bands such as 25-50 and 70+.","inputSchema":{"type":"object","properties":{"geo":{"default":"US","description":"Marketplace country code.","enum":["US","CA","DE","MX","UK","FR","IT","ES","AU","BR","IN","JP","NL","AE","PL","SA","SG","SE","TR","BE","IE","ZA","EG"],"title":"Geo","type":"string"},"offset":{"default":0,"description":"Row to start at. A page is 30 rows; pass the previous answer's next_offset for the next page.","minimum":0,"title":"Offset","type":"integer"},"categories":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Department to restrict to: its id from available_filters.categories, or its name as Amazon shows it for that marketplace (case-insensitive; a unique fragment such as \"electronics\" works). US departments: Amazon Devices & Accessories, Appliances, Arts Crafts & Sewing, Audible Books & Originals, Automotive, Baby Products, Beauty & Personal Care, Books, CDs & Vinyl, Cell Phones & Accessories, Clothing Shoes & Jewelry, Collectibles & Fine Art, Electronics, Everything Else, Grocery & Gourmet Food, Handmade Products, Health & Household, Home & Kitchen, Industrial & Scientific, Kindle Store, Movies & TV, Musical Instruments, Office Products, Patio Lawn & Garden, Pet Supplies, Software, Sports & Outdoors, Tools & Home Improvement, Toys & Games, Video Games. Other marketplaces use their own localised names -- read them from available_filters.categories of any deals answer for that geo. An unknown name is a free 400 listing the valid names.","title":"Categories"},"brands":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Comma-separated brand ids, e.g. 46655 for Samsung on US. Take them from brand_id on any deals row or from available_filters.brands (the brands present in the current result). Names resolve only when this marketplace has already shown that brand; for a brand by name use /search with brand=<name> and today_deals=true instead.","title":"Brands"},"min_product_star_rating":{"anyOf":[{"enum":["4","ALL"],"type":"string"},{"type":"null"}],"default":null,"description":"Amazon's deals feed offers one rating cut-off: 4 = four stars and up. ALL or omitted = no cut-off. Other values are rejected with a free 400.","title":"Min Product Star Rating"},"min_price":{"anyOf":[{"minimum":0,"type":"number"},{"type":"null"}],"default":null,"description":"Lowest deal price to return, in the marketplace currency. Applied to the fetched rows; see notes.","title":"Min Price"},"max_price":{"anyOf":[{"minimum":0,"type":"number"},{"type":"null"}],"default":null,"description":"Highest deal price to return, in the marketplace currency.","title":"Max Price"},"min_discount":{"anyOf":[{"maximum":100,"minimum":0,"type":"integer"},{"type":"null"}],"default":null,"description":"Smallest discount percentage to return, e.g. 50 for half price or better.","title":"Min Discount"},"max_discount":{"anyOf":[{"maximum":100,"minimum":0,"type":"integer"},{"type":"null"}],"default":null,"description":"Largest discount percentage to return.","title":"Max Discount"},"prime_exclusive":{"default":false,"description":"Only deals in Amazon's Prime Exclusive program.","title":"Prime Exclusive","type":"boolean"},"prime_early_access":{"default":false,"description":"Only Prime Early Access deals. A marketplace lists the programs it is running under available_filters.prime_programs; when Early Access is not running the answer is empty with a hint saying so.","title":"Prime Early Access","type":"boolean"},"limit":{"default":10,"description":"How many deals to return from this page (0 = all of them). A full page is 30 rows and roughly 35 KB with every field, which most clients spill to a file instead of showing inline. The answer carries _truncated with the true count when it trims.","minimum":0,"title":"Limit","type":"integer"},"compact":{"default":true,"description":"Return light rows: identity, prices, discount, badge, end time, links, brand_id and department_ids, dropping the image arrays. false returns every field the REST API sends.","title":"Compact","type":"boolean"},"fields":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Comma-separated row fields to return instead of the light set, e.g. \"asin,product_title,product_price\". Rows list what they left out under _omitted_fields.","title":"Fields"}},"title":"dealsArguments"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true},"definitionHash":"b04efeb5ee048ac077d51faecdb69f6dfef213bca781906a42b9d70fc71b1377","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-14T01:47:08.661Z","metadataTrust":"untrusted"},{"serverName":"app.apiguru/amazon-data","endpointFingerprint":"4aac7ba000e1ed402cdea8eae911c2fc4fe5a422db23fc660fa1d009498ac4be","name":"list_capabilities","title":"List endpoints, prices and marketplaces (free)","description":"List every Apiguru endpoint with its price, required parameters and\n        supported marketplaces, plus your current access mode, cache and\n        session budget. Free: answers locally with no network request and no\n        charge. Call this before paid tools if you need to plan.","inputSchema":{"type":"object","properties":{},"title":"list_capabilitiesArguments"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"c9096d1788d903e8d35849113e6140a448da0ed2c9d15c9f4e8991c0cbbcc501","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-14T01:47:08.661Z","metadataTrust":"untrusted"},{"serverName":"app.apiguru/amazon-data","endpointFingerprint":"4aac7ba000e1ed402cdea8eae911c2fc4fe5a422db23fc660fa1d009498ac4be","name":"offers_stock","title":"Live offers and inventory for up to 10 ASINs","description":"Use to compare sellers' current offers and see who holds the buy box, and, with check_inventory, how many units a buyer can add to the cart now. The stock number is not a sales estimate. Not for the listing's own details (product_details). Returns the current offer list per ASIN (seller, price, condition, buy-box winner) and, optionally, the actual purchasable stock quantity. Price: $0.0045 per item (max 10). Billed per lookup, which is more than one per ASIN when check_inventory is true. offers_count=winner returns only the offer flagged is_buybox_winner (offers_total keeps the full count); it used to scope only the inventory check and return every offer. /scrape is a legacy alias for the same handler. When Amazon will not return the offer list for an ASIN, the result carries source=product_page: the featured (buy-box) offer read from the product page, offers_on_amazon (how many offers Amazon says exist) and a note; other sellers' offers and stock are then not included. With check_inventory, a cart check that cannot read a quantity is retried once on another session; one that still fails says so on the offer, inventory_response {\"error\": \"cart check failed\", \"code\": \"cart_check_failed\", \"retryable\": true}, is not billed, and never reads as a quantity of 0. Each offer carries `ships_from` (the \"Ships from\" name: Amazon for FBA, else the seller), `delivery_message` (the offer's own delivery promise, e.g. \"FREE delivery Friday, October 16 on orders shipped by Amazon over $35\") and `delivery_message_secondary` (the \"Or fastest delivery ...\" line), null when the offer shows none. `delivery` is the same value as `ships_from`, kept for existing integrations; it never held delivery information. A row for an ASIN that could not be answered carries `error`, `code`, `http_status`, `billed`, `retryable` and `next_step`, like a top-level error: `upstream_unavailable` (not billed, retry that ASIN), `no_offers` (\"No offers found\": the offer list holds no offer that can be bought as is -- customizable listings have none; billed like a 404) or `asin_redirected` (Amazon answers the ASIN with another listing's offers; billed like a 404). On agent.apiguru.app the answer also carries `success` and `_links` (self, and `details_url` per row); `billable_requests_count` is there on your own key only.","inputSchema":{"type":"object","properties":{"asins":{"description":"Comma-separated ASIN list, maximum 10. Each must be 10 uppercase alphanumeric characters; malformed entries are rejected with 400. An Amazon product URL (…/dp/ASIN) works too, in place of an ASIN; lower case is fine. A URL's domain sets the marketplace unless geo says otherwise.","title":"Asins","type":"string"},"geo":{"default":"US","description":"Marketplace country code.","enum":["US","CA","DE","MX","UK","FR","IT","ES","AU","BR","IN","JP","NL","AE","PL","SA","SG","SE","TR","BE","IE","ZA","EG"],"title":"Geo","type":"string"},"check_inventory":{"default":false,"description":"Add each offer's purchasable stock quantity (`inventory_response`), read with a cart check. Slower, and each check that reads a quantity is billed, so leave off unless you need the number.","title":"Check Inventory","type":"boolean"},"offers_count":{"default":"all","description":"'all' for every offer (default), 'winner' for the buy-box offer only, or a specific alphanumeric Offer ID. Every offer carries is_buybox_winner; with 'winner' the per-ASIN data holds that one offer and offers_total says how many exist. An ASIN with no featured offer answers an empty list with an explanatory error. The response echoes filters_applied.","title":"Offers Count","type":"string"},"condition":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Comma-separated condition filter: ALL, NEW, USED_LIKE_NEW, USED_VERY_GOOD, USED_GOOD, USED_ACCEPTABLE (case-insensitive). Omit for every offer. An unknown value is a free 400 listing the allowed ones; it used to be silently treated as ALL.","title":"Condition"}},"required":["asins"],"title":"offers_stockArguments"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true},"definitionHash":"0e8a686bf40b7cf9961f1523cebc9403b1826f65f21084ac79cd8331e9b0add9","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-14T01:47:08.661Z","metadataTrust":"untrusted"},{"serverName":"app.apiguru/amazon-data","endpointFingerprint":"4aac7ba000e1ed402cdea8eae911c2fc4fe5a422db23fc660fa1d009498ac4be","name":"product_details","title":"Full product detail for a single ASIN","description":"Use for one product's current listing. Not for several ASINs (product_details_batch), seller offers or stock (offers_stock), or review text (product_reviews). Fetches the complete product record for one ASIN on one marketplace: title, price, star rating, rating count, images, description, feature bullets, variations and category. Price: $0.003 per call. 404 means the ASIN is absent from that marketplace and IS billed. 503 is a temporary failure on our side and is NOT billed - retry. Bullet points and specs are what Amazon shows for the listing; on multi-variant listings they can describe the product family rather than the exact variant. A null field means Amazon did not show it. Keys of `product_information`, `tech_specs` and the other specification tables are trimmed: Amazon prints some rows twice, once with a trailing space (\"Package Dimensions \"), and the copies are merged under the clean name; when they differ the listing's own value wins (the second copy of \"ASIN\" on a variant often names the parent).","inputSchema":{"type":"object","properties":{"asin":{"description":"Single Amazon ASIN, 10 uppercase alphanumeric characters. Exactly one - comma-separated lists are rejected; use product_details_batch for many. An Amazon product URL (…/dp/ASIN) works too, in place of an ASIN; lower case is fine. A URL's domain sets the marketplace unless geo says otherwise.","pattern":"^\\s*(?:[A-Za-z0-9]{10}|https?://\\S+)\\s*$","title":"Asin","type":"string"},"geo":{"default":"US","description":"Marketplace country code.","enum":["US","CA","DE","MX","UK","FR","IT","ES","AU","BR","IN","JP","NL","AE","PL","SA","SG","SE","TR","BE","IE","ZA","EG"],"title":"Geo","type":"string"},"compact":{"default":true,"description":"Return the compact record (about 4 KB: identity, price, rating, availability, bullets, category, offer, buy box). false returns the full record (about 75 KB, includes from_manufacturer, tech_specs, product_information, product_reviews).","title":"Compact","type":"boolean"},"fields":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Comma-separated top-level fields to return instead of the compact set, e.g. \"tech_specs,product_information\". Any response lists what it left out under _omitted_fields.","title":"Fields"}},"required":["asin"],"title":"product_detailsArguments"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true},"definitionHash":"878349aba6c5b0106ee677ad991265aeaa7a0600d481281d9f5125075103ab65","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-14T01:47:08.661Z","metadataTrust":"untrusted"},{"serverName":"app.apiguru/amazon-data","endpointFingerprint":"4aac7ba000e1ed402cdea8eae911c2fc4fe5a422db23fc660fa1d009498ac4be","name":"product_details_batch","title":"Product detail for up to 20 ASINs in one call","description":"Use to enrich a list of ASINs in one call; compare the ASINs in `results` with the ones you sent. Batch variant of product_details. Accepts a comma-separated ASIN list, deduplicates it, and fetches all of them concurrently. Far cheaper and faster than N single calls. Price: $0.0024 per item (max 20). Billed per ASIN processed, including ones that come back not-found. More than 20 ASINs returns 413. Bullet points and specs are what Amazon shows for the listing; on multi-variant listings they can describe the product family rather than the exact variant. A null field means Amazon did not show it. ASINs Amazon has no record for on that marketplace are listed in not_returned (billed, like a not-found product_details call; retrying will not help). The batch record comes from Amazon's app, not the product page: price, rating, availability, images, bullets and variants, but no best-seller ranks, no category path and no merchant (seller) id. For those call product_details per ASIN. On an API key both cost one request per ASIN, so the batch saves calls and time, not money; keyless (x402) it is also cheaper per item. Compact rows carry brand, weight {raw, unit, value} and dimension {length, width, height, unit, raw} in product_details' shape, read from the row's product_attributes (package dimensions first); outside amazon.com Amazon's app prints centimetres under an inches label, so there dimension.unit is cm while raw keeps Amazon's text.","inputSchema":{"type":"object","properties":{"asins":{"description":"Comma-separated ASIN list, maximum 20 after de-duplication. Each must be 10 uppercase alphanumeric characters. An Amazon product URL (…/dp/ASIN) works too, in place of an ASIN; lower case is fine. A URL's domain sets the marketplace unless geo says otherwise.","title":"Asins","type":"string"},"geo":{"default":"US","description":"Marketplace country code.","enum":["US","CA","DE","MX","UK","FR","IT","ES","AU","BR","IN","JP","NL","AE","PL","SA","SG","SE","TR","BE","IE","ZA","EG"],"title":"Geo","type":"string"},"compact":{"default":true,"description":"Return the compact record (about 2-7 KB a row: title, brand, price, availability, rating summary, bullets, weight, dimension, variation_summary). false returns the full app record (15-150 KB a row: the product_attributes and product_details spec tables, images, the variation maps).","title":"Compact","type":"boolean"},"fields":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Comma-separated top-level fields to return instead of the compact set, e.g. \"weight,dimension,brand\" or \"product_attributes\" (the whole spec table). Any response lists what it left out under _omitted_fields.","title":"Fields"}},"required":["asins"],"title":"product_details_batchArguments"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true},"definitionHash":"f6c692e6107cb2ca4ed7720bbf77f447069738f2c00edfec64fa83b95bcc190c","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-14T01:47:08.661Z","metadataTrust":"untrusted"},{"serverName":"app.apiguru/amazon-data","endpointFingerprint":"4aac7ba000e1ed402cdea8eae911c2fc4fe5a422db23fc660fa1d009498ac4be","name":"product_reviews","title":"Customer reviews for a single ASIN","description":"Use for what customers say about one product. Not for its full review history (Amazon serves full and star-filtered review lists only to signed-in accounts) or for seller feedback (seller_reviews). Returns the overall rating, rating count, review_histogram (percent of all ratings per star), Amazon's 'customers say' AI summary where that marketplace shows one, and the reviews on the product page (typically up to 8 from this marketplace and 5 from other countries), each with rating, review_date, review_country, from_this_marketplace, verified flag and helpful_votes; from_rating/to_rating keep a star window. Price: $0.003 per call. Same 404-billed / 503-not-billed semantics as product_details. No paging or sort: the reviews are those on the product page; review_coverage says how many and from where. from_rating/to_rating filter them. review_histogram (here and on product_details) gives the share of every rating. customers_say is null where Amazon shows no summary (several marketplaces never do); customers_say_note then says so.","inputSchema":{"type":"object","properties":{"asin":{"description":"Single Amazon ASIN, 10 uppercase alphanumeric characters. An Amazon product URL (…/dp/ASIN) works too, in place of an ASIN; lower case is fine. A URL's domain sets the marketplace unless geo says otherwise.","pattern":"^\\s*(?:[A-Za-z0-9]{10}|https?://\\S+)\\s*$","title":"Asin","type":"string"},"geo":{"default":"US","description":"Marketplace country code.","enum":["US","CA","DE","MX","UK","FR","IT","ES","AU","BR","IN","JP","NL","AE","PL","SA","SG","SE","TR","BE","IE","ZA","EG"],"title":"Geo","type":"string"},"from_rating":{"anyOf":[{"maximum":5,"minimum":1,"type":"integer"},{"type":"null"}],"default":null,"description":"Lowest star rating to include, 1-5. Filters the reviews the product page shows (see review_coverage).","title":"From Rating"},"to_rating":{"anyOf":[{"maximum":5,"minimum":1,"type":"integer"},{"type":"null"}],"default":null,"description":"Highest star rating to include, 1-5. from_rating=1&to_rating=3 keeps the critical ones among them.","title":"To Rating"},"max_reviews":{"default":10,"description":"Cap on individual reviews returned (0 = all). The rating summary, review_histogram and customers_say are always returned; _reviews_total is the number of reviews on the product page (not all reviews; see review_coverage).","minimum":0,"title":"Max Reviews","type":"integer"}},"required":["asin"],"title":"product_reviewsArguments"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true},"definitionHash":"fddc6e804ec95a2369aba1b23343279e30cc4347bf7f26a9e0280e714e484f96","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-14T01:47:08.661Z","metadataTrust":"untrusted"},{"serverName":"app.apiguru/amazon-data","endpointFingerprint":"4aac7ba000e1ed402cdea8eae911c2fc4fe5a422db23fc660fa1d009498ac4be","name":"search","title":"Search Amazon products by keyword","description":"Use to find products by keyword and filters. Rows are result snippets; for the authoritative record of one ASIN call product_details. Search Amazon products by keyword. Filters: page, sort_by, category_id (browse node), min_price / max_price (decimals), product_condition (NEW / USED / RENEWED), brand, seller_id, today_deals and deal_type (coupons, all_discounts, buy_more_save_more). Every answer carries filters_applied, filters_ignored (with the reason) and available_filters for that marketplace. Price: $0.003 per call. Blank values and the literal string 'null' are treated as unset. Invalid page, sort_by, price, product_condition or deal_type is a free 400 naming the parameter and the allowed values. Condition and deal refinements are per marketplace; a marketplace that lacks one gets the unfiltered feed plus an entry under filters_ignored, never a silent empty page. `product_num_ratings` is an integer; `offers_count` is the \"N offers\" count a result card shows, an integer, and null when the card shows none (most cards; it used to default to 1); `product_brand` is the brand line Amazon prints above some titles (fashion and many branded listings) and null on cards without one -- product_details has `brand_name` for every ASIN; `product_star_rating`, `product_price` and `product_original_price` are decimal strings; a null field means Amazon did not show it. `is_prime` is true when the result carries a Prime badge or its delivery line offers Prime delivery. `metadata.reachable_pages` says how far `page` can go: Amazon serves at most 7 pages of a query even when `metadata.total_pages` counts more (then `pagination_note` says how to split the query). `_links.next` is the next page while there is one; a page past the end is a free 400 `page_out_of_range`. A full page is up to 48 results and about 54 KB; the tool returns the first 10 as light rows by default and the answer carries `_truncated`, `_omitted_fields`, `_projection` and `_notes`. filters_applied echoes the effective sort_by (RELEVANCE when none was sent). A BEST_SELLERS ordering is Amazon's query-scoped popularity, not a category rank: a row's `badges` / `is_best_seller` are what the result card showed for this query, and an ASIN that is #1 in its subcategory can carry no badge here while product_details reports best_seller=true with the rank. For a rank claim, use product_details or best_sellers. An empty `products` list is served as success only when Amazon itself reports 0 results (metadata.total is 0 and `hint` says so). Anything else that is not a usable result is an unbilled, retryable 503 with code upstream_unavailable.","inputSchema":{"type":"object","properties":{"query":{"description":"Search keywords. Required and must be non-empty.","minLength":1,"title":"Query","type":"string"},"page":{"default":1,"description":"Result page, 1-based. metadata.total_pages says how far it goes.","minimum":1,"title":"Page","type":"integer"},"geo":{"default":"US","description":"Marketplace country code.","enum":["US","CA","DE","MX","UK","FR","IT","ES","AU","BR","IN","JP","NL","AE","PL","SA","SG","SE","TR","BE","IE","ZA","EG"],"title":"Geo","type":"string"},"sort_by":{"default":"RELEVANCE","description":"Result ordering.","enum":["RELEVANCE","BEST_SELLERS","LOW_HIGH_PRICE","HIGH_LOW_PRICE","REVIEWS","NEWEST"],"title":"Sort By","type":"string"},"category_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Amazon browse node id to restrict to, e.g. 172282 (Electronics on US). Take one from a best_sellers answer's available_subcategories, a product's category_path, or node= in an Amazon URL. Ids differ per marketplace.","title":"Category Id"},"min_price":{"anyOf":[{"minimum":0,"type":"number"},{"type":"null"}],"default":null,"description":"Lowest price, in the marketplace currency; decimals such as 19.99 are fine.","title":"Min Price"},"max_price":{"anyOf":[{"minimum":0,"type":"number"},{"type":"null"}],"default":null,"description":"Highest price, in the marketplace currency.","title":"Max Price"},"product_condition":{"anyOf":[{"enum":["NEW","USED","RENEWED"],"type":"string"},{"type":"null"}],"default":null,"description":"NEW, USED or RENEWED (case-insensitive). Applied with the marketplace's own condition node; where a marketplace does not offer one, the answer's filters_ignored says so and available_filters lists what it does offer.","title":"Product Condition"},"brand":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Brand name as Amazon spells it (case-insensitive), e.g. Samsung.","title":"Brand"},"seller_id":{"anyOf":[{"pattern":"^[Aa][A-Za-z0-9]{9,20}$","type":"string"},{"type":"null"}],"default":null,"description":"Restrict results to one seller's offers: an Amazon seller id, 'A' followed by 9-20 letters and digits (e.g. A2A1RNLLUK3HYA).","title":"Seller Id"},"today_deals":{"default":false,"description":"Only items in Today's Deals, using that marketplace's own refinement. Where a marketplace has none (amazon.fr on 2026-09-08) it is reported under filters_ignored.","title":"Today Deals","type":"boolean"},"deal_type":{"anyOf":[{"enum":["today_deals","all_discounts","coupons","buy_more_save_more"],"type":"string"},{"type":"null"}],"default":null,"description":"A specific promotion refinement: today_deals, all_discounts, coupons or buy_more_save_more. available_filters.deal_type lists the ones this marketplace has.","title":"Deal Type"},"limit":{"default":10,"description":"How many search results to return from this page (0 = all of them). A full page is up to 48 rows and about 54 KB, which most clients spill to a file instead of showing inline. The answer carries _truncated with the true count when it trims.","minimum":0,"title":"Limit","type":"integer"},"compact":{"default":true,"description":"Return light rows: identity, price, rating, badges and one delivery_date, dropping the long delivery prose that repeats itself across three fields. false returns every field the REST API sends (roughly 3x the size).","title":"Compact","type":"boolean"},"fields":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Comma-separated row fields to return instead of the light set, e.g. \"asin,product_title,product_price\". Rows list what they left out under _omitted_fields.","title":"Fields"}},"required":["query"],"title":"searchArguments"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true},"definitionHash":"841280964d146a00ad547e896386fd07f6354e8361b83e0b9fde30354d8ed2d7","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-14T01:47:08.661Z","metadataTrust":"untrusted"},{"serverName":"app.apiguru/amazon-data","endpointFingerprint":"4aac7ba000e1ed402cdea8eae911c2fc4fe5a422db23fc660fa1d009498ac4be","name":"seller_products","title":"Products listed by a seller","description":"Use to list one seller's storefront. Products listed by a seller: a storefront search. Takes the same filters as search -- query, page, sort_by, category_id, min_price / max_price, product_condition, brand, today_deals, deal_type -- and answers with filters_applied, filters_ignored and available_filters like search does. Price: $0.003 per call. A malformed seller_id is a free 400, as on seller_profile_batch. metadata.total_pages counts every page of the result (48 rows a page), but Amazon serves at most 7 pages of one query: metadata.reachable_pages is how far page can go, and when it is less, pagination_note says how to see the rest (min_price/max_price bands or category_id). _links.next is the next page while there is one; a page past the end is a free 400 page_out_of_range. Invalid sort_by, price, product_condition or deal_type is a free 400 that lists the allowed values. No single sort order lists a whole storefront: Amazon's relevance order (the default) can count far fewer products than the store holds and repeats products across pages, and other orders include products it leaves out (measured on one store: relevance 321, NEWEST 1,898; on another, relevance and NEWEST shared 90 of 161 products). Page 1 of a storefront without `query` carries `coverage_note` with the recipe: page through sort_by=RELEVANCE and sort_by=NEWEST, split a store larger than 336 products into min_price/max_price bands, dedupe by asin. An empty storefront carries `note`: Amazon reports 0 products for a seller with no listings on that marketplace and for an id that is not a seller alike, so check it with seller_profile_batch (`_links.seller_profile`). Rows have the search row shape: `offers_count` is null unless the card shows a count, and `product_brand` is null on most storefront cards (Amazon prints no brand line there; product_details has `brand_name`).","inputSchema":{"type":"object","properties":{"seller_id":{"description":"Amazon seller id whose storefront to list: 'A' followed by 9-20 letters and digits, the seller= or me= value of a storefront URL (e.g. A2A1RNLLUK3HYA). Required.","pattern":"^[Aa][A-Za-z0-9]{9,20}$","title":"Seller Id","type":"string"},"query":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Optional keywords to search within this seller's storefront.","title":"Query"},"page":{"default":1,"description":"Result page, 1-based. metadata.total_pages says how far it goes.","minimum":1,"title":"Page","type":"integer"},"geo":{"default":"US","description":"Marketplace country code.","enum":["US","CA","DE","MX","UK","FR","IT","ES","AU","BR","IN","JP","NL","AE","PL","SA","SG","SE","TR","BE","IE","ZA","EG"],"title":"Geo","type":"string"},"sort_by":{"default":"RELEVANCE","description":"Result ordering.","enum":["RELEVANCE","BEST_SELLERS","LOW_HIGH_PRICE","HIGH_LOW_PRICE","REVIEWS","NEWEST"],"title":"Sort By","type":"string"},"category_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Amazon browse node id to restrict to, e.g. 172282 (Electronics on US). Take one from a best_sellers answer's available_subcategories, a product's category_path, or node= in an Amazon URL. Ids differ per marketplace.","title":"Category Id"},"min_price":{"anyOf":[{"minimum":0,"type":"number"},{"type":"null"}],"default":null,"description":"Lowest price, in the marketplace currency; decimals such as 19.99 are fine.","title":"Min Price"},"max_price":{"anyOf":[{"minimum":0,"type":"number"},{"type":"null"}],"default":null,"description":"Highest price, in the marketplace currency.","title":"Max Price"},"product_condition":{"anyOf":[{"enum":["NEW","USED","RENEWED"],"type":"string"},{"type":"null"}],"default":null,"description":"NEW, USED or RENEWED (case-insensitive). Applied with the marketplace's own condition node; where a marketplace does not offer one, the answer's filters_ignored says so and available_filters lists what it does offer.","title":"Product Condition"},"brand":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Brand name as Amazon spells it (case-insensitive), e.g. Samsung.","title":"Brand"},"today_deals":{"default":false,"description":"Only items in Today's Deals, using that marketplace's own refinement. Where a marketplace has none (amazon.fr on 2026-09-08) it is reported under filters_ignored.","title":"Today Deals","type":"boolean"},"deal_type":{"anyOf":[{"enum":["today_deals","all_discounts","coupons","buy_more_save_more"],"type":"string"},{"type":"null"}],"default":null,"description":"A specific promotion refinement: today_deals, all_discounts, coupons or buy_more_save_more. available_filters.deal_type lists the ones this marketplace has.","title":"Deal Type"},"limit":{"default":10,"description":"How many the seller's products to return from this page (0 = all of them). A full page is up to 48 rows and about 54 KB, which most clients spill to a file instead of showing inline. The answer carries _truncated with the true count when it trims.","minimum":0,"title":"Limit","type":"integer"},"compact":{"default":true,"description":"Return light rows: identity, price, rating, badges and one delivery_date, dropping the long delivery prose that repeats itself across three fields. false returns every field the REST API sends (roughly 3x the size).","title":"Compact","type":"boolean"},"fields":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Comma-separated row fields to return instead of the light set, e.g. \"asin,product_title,product_price\". Rows list what they left out under _omitted_fields.","title":"Fields"}},"required":["seller_id"],"title":"seller_productsArguments"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true},"definitionHash":"d958389c9640c8d87efe82a01a4da3a871b3b4130f2a83de708cd67e387a64d7","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-14T01:47:08.661Z","metadataTrust":"untrusted"},{"serverName":"app.apiguru/amazon-data","endpointFingerprint":"4aac7ba000e1ed402cdea8eae911c2fc4fe5a422db23fc660fa1d009498ac4be","name":"seller_profile_batch","title":"Seller profiles for up to 10 seller IDs","description":"Use to vet sellers: name, rating and feedback counts as Amazon displays them. Returns the storefront profile for each seller id: business name, rating, feedback counts, address and marketplace presence. Price: $0.0036 per item (max 10). Seller ID validation is all-or-nothing: one malformed id rejects the entire request with 400. Every row in results is an object with `status`: `ok` (the profile), `not_found` (Amazon has no page for that id on this marketplace; billed, like a 404) or `unavailable` (could not be retrieved right now; NOT billed on the keyed path, `retryable: true`). A row is never null. billable_requests_count counts ok + not_found rows; on the pay-per-call rail the per-item quote is settled up front, so retry `unavailable` ids in a separate call rather than expecting a partial refund. On agent.apiguru.app the answer also carries `success` and `_links.self`; `billable_requests_count` is there on your own key only.","inputSchema":{"type":"object","properties":{"seller_ids":{"description":"Comma-separated seller IDs, maximum 10. Each must be an Amazon seller id -- 'A' followed by 9-20 letters and digits, e.g. A2A1RNLLUK3HYA -- or the whole call 400s.","pattern":"^[Aa][A-Za-z0-9]{9,20}(,[Aa][A-Za-z0-9]{9,20})*$","title":"Seller Ids","type":"string"},"geo":{"default":"US","description":"Marketplace country code.","enum":["US","CA","DE","MX","UK","FR","IT","ES","AU","BR","IN","JP","NL","AE","PL","SA","SG","SE","TR","BE","IE","ZA","EG"],"title":"Geo","type":"string"}},"required":["seller_ids"],"title":"seller_profile_batchArguments"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true},"definitionHash":"6d1b13277d96ddb52c2c4e30bb582fa240b071f53c6f78ce75bcc3f5c8a36219","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-14T01:47:08.661Z","metadataTrust":"untrusted"},{"serverName":"app.apiguru/amazon-data","endpointFingerprint":"4aac7ba000e1ed402cdea8eae911c2fc4fe5a422db23fc660fa1d009498ac4be","name":"seller_reviews","title":"Feedback reviews for a seller","description":"Use for a seller's customer feedback (service, shipping). Not for product reviews (product_reviews). Returns paginated seller feedback, optionally filtered to a star-rating window. Price: $0.003 per call. from_rating and to_rating are optional; omit both for unfiltered feedback. A page holds 5 reviews and the answer carries current_page and has_next_page; Amazon exposes no total, so page until has_next_page is false (up to page 100).","inputSchema":{"type":"object","properties":{"seller_id":{"description":"Amazon seller id: 'A' followed by 9-20 letters and digits, the seller= or me= value of a storefront URL (e.g. A2A1RNLLUK3HYA). Required.","pattern":"^[Aa][A-Za-z0-9]{9,20}$","title":"Seller Id","type":"string"},"page":{"default":1,"description":"Result page, 1-based, 5 reviews a page; has_next_page in the answer says whether another exists.","minimum":1,"title":"Page","type":"integer"},"from_rating":{"anyOf":[{"maximum":5,"minimum":1,"type":"integer"},{"type":"null"}],"default":null,"description":"Lowest star rating to include, 1-5.","title":"From Rating"},"to_rating":{"anyOf":[{"maximum":5,"minimum":1,"type":"integer"},{"type":"null"}],"default":null,"description":"Highest star rating to include, 1-5.","title":"To Rating"},"geo":{"default":"US","description":"Marketplace country code.","enum":["US","CA","DE","MX","UK","FR","IT","ES","AU","BR","IN","JP","NL","AE","PL","SA","SG","SE","TR","BE","IE","ZA","EG"],"title":"Geo","type":"string"},"limit":{"default":10,"description":"How many seller reviews to return from this page (0 = all of them). A full page is up to 48 rows and about 54 KB, which most clients spill to a file instead of showing inline. The answer carries _truncated with the true count when it trims.","minimum":0,"title":"Limit","type":"integer"},"compact":{"default":true,"description":"Return light rows: identity, price, rating, badges and one delivery_date, dropping the long delivery prose that repeats itself across three fields. false returns every field the REST API sends (roughly 3x the size).","title":"Compact","type":"boolean"},"fields":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Comma-separated row fields to return instead of the light set, e.g. \"asin,product_title,product_price\". Rows list what they left out under _omitted_fields.","title":"Fields"}},"required":["seller_id"],"title":"seller_reviewsArguments"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true},"definitionHash":"07c0a9d6b5ce5289d758481ceb44530fb56c06f28dd1a04e0bb510802218ff37","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-14T01:47:08.661Z","metadataTrust":"untrusted"},{"serverName":"app.apiguru/amazon-data","endpointFingerprint":"4aac7ba000e1ed402cdea8eae911c2fc4fe5a422db23fc660fa1d009498ac4be","name":"send_feedback","title":"Report a bug or request a feature (free)","description":"Report a bug, ask for a field, or say what would make this API more\n        useful. Free: never billed, no API key needed.\n\n        Prefer GitHub if you have an account -- an issue at\n        https://github.com/apiguru-app/agent-kit/issues gets a reply on the\n        thread, this wall does not. Use this tool when you have no GitHub\n        account or nothing to attach one to.\n\n        message:  what happened or what you want. Be specific: the tool, the\n                  parameters, the field, what you expected, what you got, and\n                  the request_id from the answer. One issue per entry -- a\n                  five-point list cannot be closed point by point.\n        category: bug | wish | praise | question | other\n        endpoint: which tool or path it is about, e.g. \"search\".\n        agent:    what you are, e.g. \"acme-pricing-bot/2.1\". Optional.\n        contact:  a GitHub handle or email if you want a reply. Shown\n                  publicly on the wall. Optional.\n        ","inputSchema":{"type":"object","properties":{"message":{"title":"Message","type":"string"},"category":{"default":"other","title":"Category","type":"string"},"endpoint":{"default":"","title":"Endpoint","type":"string"},"agent":{"default":"","title":"Agent","type":"string"},"contact":{"default":"","title":"Contact","type":"string"}},"required":["message"],"title":"send_feedbackArguments"},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true},"definitionHash":"5a343a929d4bebd887521d66c5b072dfb36d65c5d894ca7fe81f1d132f8a7f69","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-14T01:47:08.661Z","metadataTrust":"untrusted"}],"endpoints":[{"endpointFingerprint":"4aac7ba000e1ed402cdea8eae911c2fc4fe5a422db23fc660fa1d009498ac4be","protocol":"streamable-http","status":"indexed","toolCount":12,"observedAt":"2026-11-14T01:47:08.661Z"}],"authentication":"unknown"},"connectionConfigurations":{"status":"ready","authentication":"not embedded","clients":{"Claude Desktop":{"mcpServers":{"app.apiguru/amazon-data":{"url":"https://mcp.apiguru.app/mcp"}}},"Cursor":{"mcpServers":{"app.apiguru/amazon-data":{"url":"https://mcp.apiguru.app/mcp"}}},"VS Code":{"servers":{"app.apiguru/amazon-data":{"type":"http","url":"https://mcp.apiguru.app/mcp"}}}}},"resourceType":"mcp-server","callable":true,"runtime":{"callable":true,"protocols":["mcp"]},"interfaces":[{"protocol":"mcp","transport":"streamable-http","url":"https://mcp.apiguru.app/mcp"},{"protocol":"mcp","package":"apiguru-mcp","registryType":"pypi","version":"1.1.69"},{"protocol":"mcp","package":"apiguru-mcp","registryType":"npm","version":"1.1.69"}],"profile":{"apiVersion":"1","schemaVersion":"1","id":"mcp-server:app.apiguru%2Famazon-data","resourceType":"mcp-server","canonicalUrl":"https://www.agentsjunction.com/api/v1/servers/app.apiguru%2Famazon-data","name":"app.apiguru/amazon-data","description":"Live Amazon product, review, search, deal, offer/stock and seller data across 23 marketplaces.","interfaces":[{"protocol":"mcp","transport":"streamable-http","url":"https://mcp.apiguru.app/mcp"},{"protocol":"mcp","package":"apiguru-mcp","registryType":"pypi","version":"1.1.69"},{"protocol":"mcp","package":"apiguru-mcp","registryType":"npm","version":"1.1.69"}],"capabilities":[],"identity":{"source":"official-registry","websiteUrl":"https://apiguru.app","repositoryUrl":"https://github.com/apiguru-app/agent-kit","version":"1.1.69"},"verification":{"state":"official","confidence":100},"operations":{"resourceType":"mcp-server","name":"app.apiguru/amazon-data","status":"online","lastCheckedAt":"2026-11-20T05:17:43.941Z","lastSuccessfulCheck":"2026-11-20T05:17:43.941Z","latencyMs":330,"consecutiveFailures":0,"isStale":false,"checks":{"endpointReachable":true,"protocolValid":true,"agentCardValid":null,"mcpHandshakeValid":true},"lastSeen":null,"lastSuccessfulInteraction":null,"lastHealthCheck":"2026-11-20T05:17:43.941Z","source":{"type":"health-check","url":null},"observedAt":"2026-11-20T05:17:43.941Z"},"security":null,"timestamps":{"createdAt":"2026-11-19T11:49:31.242Z","updatedAt":"2026-11-19T11:49:31.242Z","observedAt":"2026-11-20T05:17:43.941Z"},"compatibility":{"serverVersion":"1.1.69","protocolVersions":[{"protocol":"mcp","version":null}]}}}}