{"openapi":"3.1.0","info":{"title":"ASIN402","version":"2.0.0","description":"Amazon product data and analysis for AI agents, paid per call with x402 (USDC)."},"servers":[{"url":"https://asin402.com"}],"paths":{"/api/product":{"get":{"summary":"Amazon product snapshot","description":"Title, brand, category, buy box / Amazon / lowest new and used price, sales rank, estimated monthly sales, rating, review count and offer count for one ASIN. Price: $0.01 USDC per call Paid via x402.","parameters":[{"name":"asin","in":"query","required":true,"description":"Amazon ASIN, 10 characters (books: ISBN-10)","schema":{"type":"string"}},{"name":"domain","in":"query","required":false,"description":"Marketplace: us, uk, de, fr, jp, ca, it, es, in, mx, br. Default us","schema":{"type":"string"}}],"responses":{"200":{"description":"Result JSON"},"400":{"description":"Invalid input (not charged)"},"402":{"description":"Payment required (x402): price and payment details. Pay and retry."},"404":{"description":"No data (not charged)"},"503":{"description":"Temporarily at capacity (not charged); see Retry-After"}},"x-x402-price":"$0.01"}},"/api/deal-check":{"get":{"summary":"Is this Amazon price actually a deal?","description":"Compares the current price with 30/90/180-day averages and its typical 180-day range (outlier offers filtered out), and returns a verdict: buy_now, fair_price, wait or verify_offer. Price: $0.02 USDC per call Paid via x402.","parameters":[{"name":"asin","in":"query","required":true,"description":"Amazon ASIN, 10 characters (books: ISBN-10)","schema":{"type":"string"}},{"name":"domain","in":"query","required":false,"description":"Marketplace: us, uk, de, fr, jp, ca, it, es, in, mx, br. Default us","schema":{"type":"string"}}],"responses":{"200":{"description":"Result JSON"},"400":{"description":"Invalid input (not charged)"},"402":{"description":"Payment required (x402): price and payment details. Pay and retry."},"404":{"description":"No data (not charged)"},"503":{"description":"Temporarily at capacity (not charged); see Retry-After"}},"x-x402-price":"$0.02"}},"/api/fba-profit":{"get":{"summary":"Amazon FBA profit calculator","description":"Referral fee, FBA fulfillment fee, net profit, margin, ROI, break-even cost and max cost for 30% ROI for selling this ASIN via FBA. Price: $0.05 USDC per call Paid via x402.","parameters":[{"name":"asin","in":"query","required":true,"description":"Amazon ASIN, 10 characters (books: ISBN-10)","schema":{"type":"string"}},{"name":"domain","in":"query","required":false,"description":"Marketplace: us, uk, de, fr, jp, ca, it, es, in, mx, br. Default us","schema":{"type":"string"}},{"name":"cost","in":"query","required":false,"description":"Your unit cost of goods","schema":{"type":"number"}},{"name":"shipping","in":"query","required":false,"description":"Inbound shipping per unit","schema":{"type":"number"}},{"name":"price","in":"query","required":false,"description":"Override the sell price (defaults to current buy box)","schema":{"type":"number"}}],"responses":{"200":{"description":"Result JSON"},"400":{"description":"Invalid input (not charged)"},"402":{"description":"Payment required (x402): price and payment details. Pay and retry."},"404":{"description":"No data (not charged)"},"503":{"description":"Temporarily at capacity (not charged); see Retry-After"}},"x-x402-price":"$0.05"}},"/api/sell-score":{"get":{"summary":"Should I sell this product? Opportunity score 0-100","description":"Scores a product as a selling opportunity from demand, competition, Amazon's presence, price stability, review moat and price fit, with plain-language risk flags. Price: $0.10 USDC per call Paid via x402.","parameters":[{"name":"asin","in":"query","required":true,"description":"Amazon ASIN, 10 characters (books: ISBN-10)","schema":{"type":"string"}},{"name":"domain","in":"query","required":false,"description":"Marketplace: us, uk, de, fr, jp, ca, it, es, in, mx, br. Default us","schema":{"type":"string"}}],"responses":{"200":{"description":"Result JSON"},"400":{"description":"Invalid input (not charged)"},"402":{"description":"Payment required (x402): price and payment details. Pay and retry."},"404":{"description":"No data (not charged)"},"503":{"description":"Temporarily at capacity (not charged); see Retry-After"}},"x-x402-price":"$0.10"}},"/api/data/product":{"get":{"summary":"Full Amazon product data, every parameter","description":"Everything tracked about 1-100 products: details, categories, images, dimensions, fees, price and sales-rank history, statistics, buy box, live offers, stock, rating history, variations. Base 1 credit per product; options add credits (see each parameter). Price: dynamic: data credits used x $0.002, minimum $0.005. The exact price for your query is in the 402 response. Paid via x402.","parameters":[{"name":"asin","in":"query","required":false,"description":"ASIN or comma-separated list of up to 100 ASINs. Use asin OR code.","schema":{"type":"string"}},{"name":"code","in":"query","required":false,"description":"UPC, EAN, GTIN or ISBN-13 (comma-separated, up to 100). Use asin OR code.","schema":{"type":"string"}},{"name":"domain","in":"query","required":false,"description":"Amazon marketplace: us, uk, de, fr, jp, ca, it, es, in, mx, br. Default us.","schema":{"type":"string"}},{"name":"format","in":"query","required":false,"description":"clean (default): readable JSON, prices in currency units, ISO dates. raw: compact native format (prices in cents, timestamps as minutes since 2011-01-01, flat history arrays).","schema":{"type":"string","enum":["clean","raw"]}},{"name":"series","in":"query","required":false,"description":"clean format only. Comma-separated price/rank histories to include, or \"all\". Default BUY_BOX_SHIPPING,AMAZON,NEW,SALES_RANK. Available: AMAZON, NEW, USED, SALES_RANK, LIST_PRICE, COLLECTIBLE, REFURBISHED, NEW_FBM_SHIPPING, LIGHTNING_DEAL, WAREHOUSE, NEW_FBA, COUNT_NEW, COUNT_USED, COUNT_REFURBISHED, COUNT_COLLECTIBLE, EXTRA_INFO_UPDATES, RATING, COUNT_REVIEWS, BUY_BOX_SHIPPING, USED_NEW_SHIPPING, USED_VERY_GOOD_SHIPPING, USED_GOOD_SHIPPING, USED_ACCEPTABLE_SHIPPING, COLLECTIBLE_NEW_SHIPPING, COLLECTIBLE_VERY_GOOD_SHIPPING, COLLECTIBLE_GOOD_SHIPPING, COLLECTIBLE_ACCEPTABLE_SHIPPING, REFURBISHED_SHIPPING, EBAY_NEW_SHIPPING, EBAY_USED_SHIPPING, TRADE_IN, RENT, BUY_BOX_USED_SHIPPING, PRIME_EXCL.","schema":{"type":"string"}},{"name":"stats","in":"query","required":false,"description":"Add a statistics object (current, averages, min/max) over the last N days. Default 180. 0 to disable. No extra cost.","schema":{"type":"integer"}},{"name":"history","in":"query","required":false,"description":"1 (default) includes full price/rank history; 0 removes it for a smaller, faster response.","schema":{"type":"integer","enum":[0,1]}},{"name":"days","in":"query","required":false,"description":"Limit history to the last N days.","schema":{"type":"integer"}},{"name":"offers","in":"query","required":false,"description":"20-100. Fetch live marketplace offers (sellers, prices, FBA/FBM, Prime). Costs about 6 credits per 10 offers per product instead of the base credit; takes 2-20 seconds.","schema":{"type":"integer"}},{"name":"only_live_offers","in":"query","required":false,"description":"With offers: return only currently live offers.","schema":{"type":"integer","enum":[0,1]}},{"name":"buybox","in":"query","required":false,"description":"Buy box price, winner history and buy box statistics. +2 credits per product (included free with offers).","schema":{"type":"integer","enum":[0,1]}},{"name":"rating","in":"query","required":false,"description":"Rating and review-count history. Up to +1 credit per product.","schema":{"type":"integer","enum":[0,1]}},{"name":"stock","in":"query","required":false,"description":"With offers: stock quantity per offer. Up to +2 credits per product.","schema":{"type":"integer","enum":[0,1]}},{"name":"update","in":"query","required":false,"description":"Refresh data older than N hours. 0 = force live refresh (+1 credit per product if recently updated). -1 = never refresh. Default 1.","schema":{"type":"integer"}},{"name":"videos","in":"query","required":false,"description":"Include video metadata. No extra cost.","schema":{"type":"integer","enum":[0,1]}},{"name":"aplus","in":"query","required":false,"description":"Include A+ content. No extra cost.","schema":{"type":"integer","enum":[0,1]}},{"name":"historical_variations","in":"query","required":false,"description":"Include historical and out-of-stock variation ASINs. +1 credit per product with a parent.","schema":{"type":"integer","enum":[0,1]}},{"name":"code_limit","in":"query","required":false,"description":"With code: max products returned per code.","schema":{"type":"integer"}}],"responses":{"200":{"description":"Result JSON"},"400":{"description":"Invalid input (not charged)"},"402":{"description":"Payment required (x402): price and payment details. Pay and retry."},"404":{"description":"No data (not charged)"},"503":{"description":"Temporarily at capacity (not charged); see Retry-After"}},"x-x402-price":"from $0.005"}},"/api/data/search":{"get":{"summary":"Search Amazon products by keyword","description":"Keyword search like the Amazon search bar. Returns up to 10 full products per page with stats and history. 10 credits per page. Price: dynamic: data credits used x $0.002, minimum $0.005. The exact price for your query is in the 402 response. Paid via x402.","parameters":[{"name":"term","in":"query","required":true,"description":"Search keywords.","schema":{"type":"string"}},{"name":"page","in":"query","required":false,"description":"Result page, 0-9. Default 0.","schema":{"type":"integer"}},{"name":"domain","in":"query","required":false,"description":"Amazon marketplace: us, uk, de, fr, jp, ca, it, es, in, mx, br. Default us.","schema":{"type":"string"}},{"name":"format","in":"query","required":false,"description":"clean (default): readable JSON, prices in currency units, ISO dates. raw: compact native format (prices in cents, timestamps as minutes since 2011-01-01, flat history arrays).","schema":{"type":"string","enum":["clean","raw"]}},{"name":"series","in":"query","required":false,"description":"clean format only. Comma-separated price/rank histories to include, or \"all\". Default BUY_BOX_SHIPPING,AMAZON,NEW,SALES_RANK. Available: AMAZON, NEW, USED, SALES_RANK, LIST_PRICE, COLLECTIBLE, REFURBISHED, NEW_FBM_SHIPPING, LIGHTNING_DEAL, WAREHOUSE, NEW_FBA, COUNT_NEW, COUNT_USED, COUNT_REFURBISHED, COUNT_COLLECTIBLE, EXTRA_INFO_UPDATES, RATING, COUNT_REVIEWS, BUY_BOX_SHIPPING, USED_NEW_SHIPPING, USED_VERY_GOOD_SHIPPING, USED_GOOD_SHIPPING, USED_ACCEPTABLE_SHIPPING, COLLECTIBLE_NEW_SHIPPING, COLLECTIBLE_VERY_GOOD_SHIPPING, COLLECTIBLE_GOOD_SHIPPING, COLLECTIBLE_ACCEPTABLE_SHIPPING, REFURBISHED_SHIPPING, EBAY_NEW_SHIPPING, EBAY_USED_SHIPPING, TRADE_IN, RENT, BUY_BOX_USED_SHIPPING, PRIME_EXCL.","schema":{"type":"string"}},{"name":"stats","in":"query","required":false,"description":"Add a statistics object (current, averages, min/max) over the last N days. Default 180. 0 to disable. No extra cost.","schema":{"type":"integer"}},{"name":"history","in":"query","required":false,"description":"1 (default) includes full price/rank history; 0 removes it for a smaller, faster response.","schema":{"type":"integer","enum":[0,1]}},{"name":"days","in":"query","required":false,"description":"Limit history to the last N days.","schema":{"type":"integer"}}],"responses":{"200":{"description":"Result JSON"},"400":{"description":"Invalid input (not charged)"},"402":{"description":"Payment required (x402): price and payment details. Pay and retry."},"404":{"description":"No data (not charged)"},"503":{"description":"Temporarily at capacity (not charged); see Retry-After"}},"x-x402-price":"from $0.020"}},"/api/data/finder":{"get":{"summary":"Product Finder: filter the whole Amazon catalog","description":"Find ASINs matching any combination of 300+ filters: price ranges, sales rank, monthly sales, offer counts, buy box share, Amazon presence, brand, category, rating, dimensions, price drops, out-of-stock rates and more. Pass the Product Finder query as JSON in 'selection' (GET) or as the JSON body (POST). Returns ASINs; fetch details with /api/data/product. 10 credits + 1 credit per 100 results; stats=1 adds 30 credits. Price: dynamic: data credits used x $0.002, minimum $0.005. The exact price for your query is in the 402 response. Paid via x402.","parameters":[{"name":"selection","in":"query","required":true,"description":"Product Finder query JSON. Example: {\"current_SALES_lte\":20000,\"current_BUY_BOX_SHIPPING_gte\":2000,\"current_BUY_BOX_SHIPPING_lte\":6000,\"buyBoxIsAmazon\":false,\"totalOfferCount_lte\":8,\"perPage\":50,\"sort\":[[\"current_SALES\",\"asc\"]]}. Prices in cents. All fields: /docs/finder","schema":{"type":"string"}},{"name":"domain","in":"query","required":false,"description":"Amazon marketplace: us, uk, de, fr, jp, ca, it, es, in, mx, br. Default us.","schema":{"type":"string"}},{"name":"stats","in":"query","required":false,"description":"1 adds search insights (aggregate stats of all matches). +30 credits.","schema":{"type":"integer","enum":[0,1]}}],"responses":{"200":{"description":"Result JSON"},"400":{"description":"Invalid input (not charged)"},"402":{"description":"Payment required (x402): price and payment details. Pay and retry."},"404":{"description":"No data (not charged)"},"503":{"description":"Temporarily at capacity (not charged); see Retry-After"}},"x-x402-price":"from $0.020"},"post":{"summary":"Product Finder: filter the whole Amazon catalog","description":"Find ASINs matching any combination of 300+ filters: price ranges, sales rank, monthly sales, offer counts, buy box share, Amazon presence, brand, category, rating, dimensions, price drops, out-of-stock rates and more. Pass the Product Finder query as JSON in 'selection' (GET) or as the JSON body (POST). Returns ASINs; fetch details with /api/data/product. 10 credits + 1 credit per 100 results; stats=1 adds 30 credits. Price: dynamic: data credits used x $0.002, minimum $0.005. The exact price for your query is in the 402 response. Paid via x402.","parameters":[{"name":"domain","in":"query","description":"Amazon marketplace: us, uk, de, fr, jp, ca, it, es, in, mx, br. Default us.","schema":{"type":"string"}},{"name":"stats","in":"query","description":"1 adds search insights (aggregate stats of all matches). +30 credits.","schema":{"type":"integer"}}],"requestBody":{"description":"Product Finder query JSON. Example: {\"current_SALES_lte\":20000,\"current_BUY_BOX_SHIPPING_gte\":2000,\"current_BUY_BOX_SHIPPING_lte\":6000,\"buyBoxIsAmazon\":false,\"totalOfferCount_lte\":8,\"perPage\":50,\"sort\":[[\"current_SALES\",\"asc\"]]}. Prices in cents. All fields: /docs/finder","content":{"application/json":{"schema":{"type":"object"}}}},"responses":{"200":{"description":"Result JSON"},"400":{"description":"Invalid input (not charged)"},"402":{"description":"Payment required (x402): price and payment details. Pay and retry."},"404":{"description":"No data (not charged)"},"503":{"description":"Temporarily at capacity (not charged); see Retry-After"}},"x-x402-price":"from $0.020"}},"/api/data/deals":{"get":{"summary":"Live Amazon price drops and deals","description":"Products whose price (or sales rank) changed recently, with filters for category, discount size, price range, rating, Amazon presence, lowest-ever price and more. Up to 150 deals per page. 5 credits per page. Price: dynamic: data credits used x $0.002, minimum $0.005. The exact price for your query is in the 402 response. Paid via x402.","parameters":[{"name":"selection","in":"query","required":true,"description":"Deal query JSON. Example: {\"page\":0,\"priceTypes\":[0],\"dateRange\":0,\"isFilterEnabled\":true,\"isLowest90\":true,\"isRangeEnabled\":true,\"deltaPercentRange\":[20,100]}. priceTypes: 0 Amazon, 1 New, 2 Used, 18 Buy Box, 8 Lightning deal, 9 Warehouse. dateRange: 0 day, 1 week, 2 month, 3 three months. All fields: /docs/deals","schema":{"type":"string"}},{"name":"domain","in":"query","required":false,"description":"Amazon marketplace: us, uk, de, fr, jp, ca, it, es, in, mx, br. Default us. Sets domainId if the selection omits it.","schema":{"type":"string"}}],"responses":{"200":{"description":"Result JSON"},"400":{"description":"Invalid input (not charged)"},"402":{"description":"Payment required (x402): price and payment details. Pay and retry."},"404":{"description":"No data (not charged)"},"503":{"description":"Temporarily at capacity (not charged); see Retry-After"}},"x-x402-price":"from $0.010"},"post":{"summary":"Live Amazon price drops and deals","description":"Products whose price (or sales rank) changed recently, with filters for category, discount size, price range, rating, Amazon presence, lowest-ever price and more. Up to 150 deals per page. 5 credits per page. Price: dynamic: data credits used x $0.002, minimum $0.005. The exact price for your query is in the 402 response. Paid via x402.","parameters":[{"name":"domain","in":"query","description":"Amazon marketplace: us, uk, de, fr, jp, ca, it, es, in, mx, br. Default us. Sets domainId if the selection omits it.","schema":{"type":"string"}}],"requestBody":{"description":"Deal query JSON. Example: {\"page\":0,\"priceTypes\":[0],\"dateRange\":0,\"isFilterEnabled\":true,\"isLowest90\":true,\"isRangeEnabled\":true,\"deltaPercentRange\":[20,100]}. priceTypes: 0 Amazon, 1 New, 2 Used, 18 Buy Box, 8 Lightning deal, 9 Warehouse. dateRange: 0 day, 1 week, 2 month, 3 three months. All fields: /docs/deals","content":{"application/json":{"schema":{"type":"object"}}}},"responses":{"200":{"description":"Result JSON"},"400":{"description":"Invalid input (not charged)"},"402":{"description":"Payment required (x402): price and payment details. Pay and retry."},"404":{"description":"No data (not charged)"},"503":{"description":"Temporarily at capacity (not charged); see Retry-After"}},"x-x402-price":"from $0.010"}},"/api/data/bestsellers":{"get":{"summary":"Amazon best sellers list for a category","description":"Ordered ASIN list of best sellers in a category (up to 500,000 for root categories, 10,000 for sub-categories), by current rank or 30/90/180-day average or a past month. 50 credits per list (not charged if no list exists). Price: dynamic: data credits used x $0.002, minimum $0.005. The exact price for your query is in the 402 response. Paid via x402.","parameters":[{"name":"category","in":"query","required":true,"description":"Category node ID, or a product group name such as Beauty. Find IDs with /api/data/category-search.","schema":{"type":"string"}},{"name":"range","in":"query","required":false,"description":"0 = current rank (default), or 30/90/180-day average rank.","schema":{"type":"integer","enum":[0,30,90,180]}},{"name":"month","in":"query","required":false,"description":"1-12, with year: monthly average rank for a past month (last 36 months).","schema":{"type":"integer"}},{"name":"year","in":"query","required":false,"description":"4-digit year, with month.","schema":{"type":"integer"}},{"name":"variations","in":"query","required":false,"description":"1 = all variations, 0 = one per parent (default).","schema":{"type":"integer","enum":[0,1]}},{"name":"sublist","in":"query","required":false,"description":"1 = rank by sub-category instead of main category.","schema":{"type":"integer","enum":[0,1]}},{"name":"limit","in":"query","required":false,"description":"Return only the top N ASINs (does not change cost). Default 1000.","schema":{"type":"integer"}},{"name":"domain","in":"query","required":false,"description":"Amazon marketplace: us, uk, de, fr, jp, ca, it, es, in, mx, br. Default us.","schema":{"type":"string"}}],"responses":{"200":{"description":"Result JSON"},"400":{"description":"Invalid input (not charged)"},"402":{"description":"Payment required (x402): price and payment details. Pay and retry."},"404":{"description":"No data (not charged)"},"503":{"description":"Temporarily at capacity (not charged); see Retry-After"}},"x-x402-price":"from $0.100"}},"/api/data/seller":{"get":{"summary":"Amazon seller information and storefront","description":"Seller name, ratings, FBA usage and history for up to 100 sellers; optionally the seller's full storefront ASIN list. 1 credit per seller; storefront +9. Price: dynamic: data credits used x $0.002, minimum $0.005. The exact price for your query is in the 402 response. Paid via x402.","parameters":[{"name":"seller","in":"query","required":true,"description":"Seller ID, or comma-separated list of up to 100 (storefront allows only one).","schema":{"type":"string"}},{"name":"storefront","in":"query","required":false,"description":"1 = include the seller's ASIN list (up to 100,000). +9 credits.","schema":{"type":"integer","enum":[0,1]}},{"name":"domain","in":"query","required":false,"description":"Amazon marketplace: us, uk, de, fr, jp, ca, it, es, in, mx, br. Default us.","schema":{"type":"string"}}],"responses":{"200":{"description":"Result JSON"},"400":{"description":"Invalid input (not charged)"},"402":{"description":"Payment required (x402): price and payment details. Pay and retry."},"404":{"description":"No data (not charged)"},"503":{"description":"Temporarily at capacity (not charged); see Retry-After"}},"x-x402-price":"from $0.005"}},"/api/data/category":{"get":{"summary":"Amazon category details","description":"Name, parent, children, product count and sales-rank thresholds for category IDs. 1 credit per category; parents=1 adds the parent tree. Price: dynamic: data credits used x $0.002, minimum $0.005. The exact price for your query is in the 402 response. Paid via x402.","parameters":[{"name":"category","in":"query","required":true,"description":"Category ID or comma-separated list (up to 10). 0 = all root categories.","schema":{"type":"string"}},{"name":"parents","in":"query","required":false,"description":"1 = include the full parent tree. +1 credit per category.","schema":{"type":"integer","enum":[0,1]}},{"name":"domain","in":"query","required":false,"description":"Amazon marketplace: us, uk, de, fr, jp, ca, it, es, in, mx, br. Default us.","schema":{"type":"string"}}],"responses":{"200":{"description":"Result JSON"},"400":{"description":"Invalid input (not charged)"},"402":{"description":"Payment required (x402): price and payment details. Pay and retry."},"404":{"description":"No data (not charged)"},"503":{"description":"Temporarily at capacity (not charged); see Retry-After"}},"x-x402-price":"from $0.005"}},"/api/data/category-search":{"get":{"summary":"Find Amazon category IDs by name","description":"Search categories by keyword to get the IDs needed by bestsellers, finder and deals. 1 credit. Price: dynamic: data credits used x $0.002, minimum $0.005. The exact price for your query is in the 402 response. Paid via x402.","parameters":[{"name":"term","in":"query","required":true,"description":"Category name keywords, e.g. water bottles.","schema":{"type":"string"}},{"name":"domain","in":"query","required":false,"description":"Amazon marketplace: us, uk, de, fr, jp, ca, it, es, in, mx, br. Default us.","schema":{"type":"string"}}],"responses":{"200":{"description":"Result JSON"},"400":{"description":"Invalid input (not charged)"},"402":{"description":"Payment required (x402): price and payment details. Pay and retry."},"404":{"description":"No data (not charged)"},"503":{"description":"Temporarily at capacity (not charged); see Retry-After"}},"x-x402-price":"from $0.005"}},"/api/data/topsellers":{"get":{"summary":"Most-rated Amazon sellers","description":"Ordered list of seller IDs with the most ratings in a marketplace (up to 100,000). 50 credits. Price: dynamic: data credits used x $0.002, minimum $0.005. The exact price for your query is in the 402 response. Paid via x402.","parameters":[{"name":"limit","in":"query","required":false,"description":"Return only the top N seller IDs. Default 1000.","schema":{"type":"integer"}},{"name":"domain","in":"query","required":false,"description":"Amazon marketplace: us, uk, de, fr, jp, ca, it, es, in, mx, br. Default us.","schema":{"type":"string"}}],"responses":{"200":{"description":"Result JSON"},"400":{"description":"Invalid input (not charged)"},"402":{"description":"Payment required (x402): price and payment details. Pay and retry."},"404":{"description":"No data (not charged)"},"503":{"description":"Temporarily at capacity (not charged); see Retry-After"}},"x-x402-price":"from $0.100"}}}}