# ASIN402

> Pay-per-call Amazon product data for AI agents. No API key, no account: pay each request in USDC with the x402 protocol (HTTP 402).

## How to use
1. Call an endpoint. You receive HTTP 402 with the exact price for your query and payment details.
2. Pay with any x402 client (x402-fetch, x402-axios, Coinbase Agentic Wallet, etc.) and retry. You receive JSON.
3. Invalid input, missing data or upstream errors return 4xx/5xx and are never charged.
4. Full parameter descriptions: /openapi.json and /.well-known/x402.

Network: base. Marketplaces: us, uk, de, fr, jp, ca, it, es, in, mx, br.

## Ready-made answers (fixed price)
- GET https://asin402.com/api/product ($0.01): Amazon product snapshot. 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.
  Example: https://asin402.com/api/product?asin=0735211299
  Parameters: asin (required), domain
- GET https://asin402.com/api/deal-check ($0.02): Is this Amazon price actually a deal?. 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.
  Example: https://asin402.com/api/deal-check?asin=0735211299
  Parameters: asin (required), domain
- GET https://asin402.com/api/fba-profit ($0.05): Amazon FBA profit calculator. Referral fee, FBA fulfillment fee, net profit, margin, ROI, break-even cost and max cost for 30% ROI for selling this ASIN via FBA.
  Example: https://asin402.com/api/fba-profit?asin=0735211299&cost=4.50&shipping=0.80
  Parameters: asin (required), domain, cost, shipping, price
- GET https://asin402.com/api/sell-score ($0.10): Should I sell this product? Opportunity score 0-100. 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.
  Example: https://asin402.com/api/sell-score?asin=0735211299
  Parameters: asin (required), domain

## Full Amazon data (price follows the data credits your query uses)
- GET https://asin402.com/api/data/product (from $0.005): Full Amazon product data, every parameter. 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).
  Example: https://asin402.com/api/data/product?asin=0735211299&buybox=1&rating=1
  Parameters: asin, code, domain, format, series, stats, history, days, offers, only_live_offers, buybox, rating, stock, update, videos, aplus, historical_variations, code_limit
- GET https://asin402.com/api/data/search (from $0.020): Search Amazon products by keyword. Keyword search like the Amazon search bar. Returns up to 10 full products per page with stats and history. 10 credits per page.
  Example: https://asin402.com/api/data/search?term=insulated%20water%20bottle&history=0
  Parameters: term (required), page, domain, format, series, stats, history, days
- GET,POST https://asin402.com/api/data/finder (from $0.020): Product Finder: filter the whole Amazon catalog. 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.
  Example: https://asin402.com/api/data/finder?selection={"current_SALES_lte":10000,"buyBoxIsAmazon":false,"perPage":50}
  Parameters: selection (required), domain, stats
- GET,POST https://asin402.com/api/data/deals (from $0.010): Live Amazon price drops and deals. 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.
  Example: https://asin402.com/api/data/deals?selection={"page":0,"priceTypes":[18],"dateRange":0}
  Parameters: selection (required), domain
- GET https://asin402.com/api/data/bestsellers (from $0.100): Amazon best sellers list for a category. 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).
  Example: https://asin402.com/api/data/bestsellers?category=3375251&limit=100
  Parameters: category (required), range, month, year, variations, sublist, limit, domain
- GET https://asin402.com/api/data/seller (from $0.005): Amazon seller information and storefront. 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.
  Example: https://asin402.com/api/data/seller?seller=A2L77EE7U53NWQ&storefront=1
  Parameters: seller (required), storefront, domain
- GET https://asin402.com/api/data/category (from $0.005): Amazon category details. Name, parent, children, product count and sales-rank thresholds for category IDs. 1 credit per category; parents=1 adds the parent tree.
  Example: https://asin402.com/api/data/category?category=3375251&parents=1
  Parameters: category (required), parents, domain
- GET https://asin402.com/api/data/category-search (from $0.005): Find Amazon category IDs by name. Search categories by keyword to get the IDs needed by bestsellers, finder and deals. 1 credit.
  Example: https://asin402.com/api/data/category-search?term=water%20bottles
  Parameters: term (required), domain
- GET https://asin402.com/api/data/topsellers (from $0.100): Most-rated Amazon sellers. Ordered list of seller IDs with the most ratings in a marketplace (up to 100,000). 50 credits.
  Example: https://asin402.com/api/data/topsellers?limit=100
  Parameters: limit, domain

## Tips
- Use /api/data/finder to find ASINs by filters, then /api/data/product (up to 100 ASINs per call) for details.
- Use /api/data/category-search to get category IDs for bestsellers, finder and deals.
- Add history=0 to product/search calls for small, fast responses when you only need current data.
- Product Finder fields: https://asin402.com/docs/finder · Deal query fields: https://asin402.com/docs/deals