Amazon Search API

Query any keyword and get the products Amazon is showing: title, price, rating, image, and whether the row is sponsored. The organic order is the rank.

100 free requests/month, then $0.01/request. Premium $99/mo for 20K.

Request
GET https://rest.canopyapi.co/api/amazon/search?searchTerm=wireless+earbuds
API-KEY: YOUR_API_KEY
Response
{
  "data": {
    "amazonProductSearchResults": {
      "productResults": {
        "results": [
          {
            "asin": "B0BSHF7WHW",
            "title": "Example wireless earbuds",
            "price": { "display": "$49.99" },
            "sponsored": false
          }
        ]
      }
    }
  }
}

Why Use This API?

Everything you need to integrate Amazon data into your application

Keyword search

Pass searchTerm and an optional domain. Filter by browse-node category, price range, and condition, then sort the page.

Sponsored vs organic

Each result has a sponsored flag. Organic rank is the position among results where sponsored is false. There is no separate rank field.

Current results

Each call reads the search page Amazon is serving, including the current price and rating on each result.

Pages and refinements

page and limit walk the result set. availableRefinements lists filters Amazon is offering for that query.

Try It Out

See how easy it is to fetch Amazon data with our API

bash
curl -G "https://rest.canopyapi.co/api/amazon/search" \
  -H "API-KEY: YOUR_API_KEY" \
  --data-urlencode "searchTerm=wireless earbuds" \
  --data-urlencode "domain=US" \
  --data-urlencode "page=1" \
  --data-urlencode "sort=FEATURED"
Response
{
  "data": {
    "amazonProductSearchResults": {
      "productResults": {
        "results": [
          {
            "asin": "B0BSHF7WHW",
            "title": "Example wireless earbuds",
            "url": "https://www.amazon.com/dp/B0BSHF7WHW",
            "price": {
              "symbol": "$",
              "value": 49.99,
              "currency": "USD",
              "display": "$49.99"
            },
            "rating": 4.5,
            "ratingsTotal": 1200,
            "mainImageUrl": "https://m.media-amazon.com/images/I/61ed7I5z0IL._AC_UY218_.jpg",
            "isPrime": true,
            "sponsored": false
          }
        ],
        "pageInfo": {
          "currentPage": 1,
          "hasNextPage": true,
          "hasPrevPage": false
        }
      }
    }
  }
}

What Can You Build?

Here are some popular use cases for this API

1

Check where an ASIN sits in organic results for a keyword

2

Collect the first pages of a keyword for market research

3

Compare sponsored and organic rows on the same search

Understanding the Response

Key fields returned by the API

asin, title, url

Each result includes the ASIN, listing title, and Amazon URL. Fetch the full listing from the product endpoint when you need bullets or the gallery.

price

Price object with symbol, value, currency, and display. It can be null when Amazon is not showing a price on that row.

sponsored

True when the row is an ad. Organic rank is the index among results where sponsored is false, counting from 1 on that page.

rating, ratingsTotal, isPrime, mainImageUrl

Star rating, rating count, Prime eligibility, and the main image URL for the result row.

pageInfo

currentPage, hasNextPage, and hasPrevPage. Pass page to request the next page of results. limit optionally caps how many products come back (pages are often about 20 to 40 results).

availableRefinements

Filters Amazon is offering for this query, each with a name and options. Useful when you want to mirror the sidebar shoppers see.

What you can send to the Amazon search API

REST is GET /api/amazon/search with an API-KEY header. Required query parameter: searchTerm. Optional: domain (default US), categoryId (an Amazon browse-node id for that marketplace), page (default 1), limit, minPrice, maxPrice, conditions, and sort.

conditions is a comma-separated list of NEW, USED, and RENEWED. sort is one of FEATURED (the default), MOST_RECENT, PRICE_ASCENDING, PRICE_DESCENDING, or AVERAGE_CUSTOMER_REVIEW. categoryId here is a browse node. It is not a bestsellers slug from the bestsellers endpoint.

For a single ASIN’s title, bullets, and gallery, use the Amazon product API. To check one ASIN in the browser, use the free keyword rank checker.

Use it as a rank tracking API

There is no position field in the response. To track keyword rank, request a page, walk productResults.results in order, skip rows where sponsored is true, and count the organic rows until you hit the ASIN. Page 2 continues the count from the previous page.

That is the ranking API path: the same Amazon search API, called on a schedule, with the organic index stored next to the keyword and ASIN. A one-off check belongs in the keyword rank checker. A written walkthrough is in the Amazon rank tracking guide.

Free tier

Accounts include 100 free requests a month, then $0.01 per request with automatic volume discounts. Each search page is a request. Sign in to create a key, or read the docs for the full query.

Frequently Asked Questions

What is the Amazon search API?

It returns the product rows Amazon shows for a keyword: ASIN, title, URL, price, rating, image, Prime flag, and a sponsored flag. Call GET https://rest.canopyapi.co/api/amazon/search with searchTerm and an API-KEY header, or use the amazonProductSearchResults GraphQL field.

How do I get a keyword’s rank from the response?

Walk productResults.results in order and ignore rows with sponsored set to true. The organic position of your ASIN on that page is your rank. Request the next page while hasNextPage is true.

How many results come back?

A page typically includes about 20 to 40 products if you do not set limit. Pass page to continue, and limit if you want fewer rows.

Can I filter or sort?

Yes. categoryId filters to a browse node. minPrice and maxPrice set a price range. conditions accepts NEW, USED, and RENEWED. sort accepts FEATURED, MOST_RECENT, PRICE_ASCENDING, PRICE_DESCENDING, and AVERAGE_CUSTOMER_REVIEW.

Which marketplaces can I search?

domain accepts US, UK, DE, FR, IT, ES, CA, MX, BR, IN, JP, AU, AE, NL, PL, SE, and SG. It defaults to US.

Ready to Get Started?

Start building with our Amazon API today. Get 100 free requests every month.