Amazon Search API by Keyword or ASIN

What the Amazon search API returns

The Product Search endpoint takes a keyword or a list of ASINs and returns the matching Amazon products as structured records, so you can compare a whole search result page without scraping it.

Each item in items[] describes one product. The fields most teams use first:

The example values come from one documented response: revenue is units × averagePrice (167539 × 735.81 ≈ 123276872). The full field list is in the Product Search reference.

{
  "marketplace": "US",
  "keyword": "wireless charger",
  "match_type": "phrase",
  "page": 1,
  "size": 10
}

{
  "request_id": "392dfdcb-8c88-4c5b-b2f2-2115df573e3b",
  "data": {
    "total": 4615,
    "pages": 462,
    "page": 1,
    "size": 10,
    "items": [
      {
        "asin": "B0CNTH3F7P",
        "brand": "Ouotoo",
        "title": "3 in 1 Mag-Safe Wireless Charger Stand for iPhone Apple Watch AirPods",
        "nodeLabelPath": "Cell Phones & Accessories:Accessories:Chargers & Power Adapters:Wireless Chargers",
        "bsr": 45,
        "price": 21.99,
        "units": 44607,
        "revenue": 802479.94,
        "rating": 4.4,
        "ratings": 9018,
        "availableDate": 1702425600000,
        "fulfillment": "FBA",
        "sellers": 3,
        "sellerNation": "CN"
      },
      {
        "asin": "B0GGPBR4YP",
        "brand": "SMILE STATION",
        "title": "MagSafe 25W Wireless Charger for Apple Magnetic Fast Charging Pad",
        "nodeLabelPath": "Cell Phones & Accessories:Accessories:Chargers & Power Adapters:Wireless Chargers",
        "bsr": 42,
        "price": 13.92,
        "units": 44206,
        "revenue": 615347.5,
        "rating": 4.4,
        "ratings": 3610,
        "availableDate": 1768435200000,
        "fulfillment": "FBA",
        "sellers": 7,
        "sellerNation": "CN"
      },
      {
        "asin": "B0BFCC18FS",
        "brand": "Anlmz",
        "title": "Anlmz 3 in 1 Charging Station - Wireless Charger for Apple Multiple Devices",
        "nodeLabelPath": "Cell Phones & Accessories:Accessories:Chargers & Power Adapters:Charging Stations",
        "bsr": 59,
        "price": 15.29,
        "units": 35954,
        "revenue": 549736.7,
        "rating": 4.2,
        "ratings": 41555,
        "availableDate": 1664236800000,
        "fulfillment": "FBA",
        "sellers": 8,
        "sellerNation": "CN"
      }
    ]
  }
}

Request example

curl --request POST \
  --url https://ecommercedataapi.com/v1/amazon/product/competitor-lookup \
  --header "Content-Type: application/json" \
  --header "X-API-Key: ${ECOMMERCE_DATA_API_KEY}" \
  --data '{
    "marketplace": "US",
    "keyword": "wireless charger",
    "match_type": "phrase",
    "include_variations": false,
    "page": 1,
    "size": 20
  }'

• Send exactly one of keyword or asins. asins takes an array such as ["B08CK5Z5Q1"] when you already know which products to compare.
• include_variations decides whether variation listings are included in the results.
• marketplace accepts US, JP, UK, DE, FR, IT, ES, CA, IN, MX, BR, AU and AE.
• Results are paginated with page and size (up to 200 per page); the response also carries total and pages. asins takes up to 40 ASINs per call.

Choosing a match type

match_type decides which products count as a match for keyword:

Start with phrase. Switch to broad only when the phrase set is too small to compare, because broad results quickly mix in unrelated products.

What one keyword search looks like

A call in October 2026 for "keyword": "wireless charger" in the US with match_type phrase and size 10 matched 4,615 products. The first six results, which come back ordered by estimated monthly units:

Three things this one table already answers:

• A new listing can still win. The second product was listed in January 2026 and sells about as many units as the leader with well under half its ratings.
• One phrase spans several categories. The top six sit in four leaf categories. Group by nodeIdPath before comparing prices, or a $7.99 watch cable will drag down the average for chargers.
• Rating count is not the moat it looks like. In this table, the two products with more than 40,000 ratings rank third and sixth by units.

Every number here comes from one response; units is a model estimate, as explained below.

Common workflows

1. Read a search result page as a table. Search the keyword you want to rank for, then sort the items by units or revenue to see how demand is split between the top listings. Getting onto the first page explains what to look for.
2. Build a competitor set. Pass your own ASIN and your main competitors in asins to get the same fields for all of them in one call. The competitor analysis method turns that table into decisions, and the Amazon reviews API shows what buyers complain about in each of them.
3. Shortlist products. From the results, keep the products in your price band with a rating count you can compete with, then check the shortlisted ASINs with product details. For category-wide screening, the product research endpoint offers range filters instead of a keyword. See the product research workflow.
4. Replace a scraper. A structured API avoids CAPTCHAs, layout changes and proxy costs; the hidden costs of scraping Amazon compares the two approaches.

Limits worth knowing

• units and revenue are model estimates, not Amazon's own sales figures. They are reliable for ranking and comparing products and should not be read as exact volumes. What sales estimates can and cannot tell you goes into the details.
• Fields that are not available for a product come back as null or -1 (for example primePrice: -1), so check for them before doing arithmetic.
• badge values are either N or the label Amazon shows, such as "#1 Best Seller in Cell Phone Wireless Chargers". Test for !== "N" rather than === "Y".
• Each successful call consumes one billing unit. Handle 429 responses as described in errors and rate limits.

FAQ

Is this the Amazon Product Advertising API? No. The Product Advertising API is for affiliates and does not return sales estimates or BSR history. This endpoint is built for product and market research and does not require an Associates account.

How many products does one call return? Up to 200 per page with size, and pages tells you how many pages the keyword has.

Can I look up a single ASIN? Yes: pass it in asins. For richer data on one product, such as the full listing, use the Amazon product data API.

Can an AI agent call it? Yes. The endpoint is exposed as a tool through the remote MCP server, so MCP clients like Claude Code and Cursor can search products directly.