Amazon Product Search API

Endpoint

GET /v1/amazon/products

Parameters

query *

Search keyword or a product ASIN (max 500 characters)

page

Page number, 1-20 (default: 1). Each page returns ~16 results

country

Marketplace country code (default: us). One of: us, au, br, ca, cn, fr, de, in, it, mx, nl, sg, es, tr, ae, gb, jp, sa, pl, se, be, eg, za, ie

sort_by

relevance (default), lowest_price, highest_price, reviews, newest, best_sellers

category_id

Category slug, e.g. electronics. See /docs/amazon-categories for valid values per country

Response fields

products

Array of matching products

asin

Amazon product ASIN — use in Product Details

title

Product title

price

Current price with currency symbol (e.g. $299.99), null if unavailable

original_price

Pre-discount price when discounted (else null)

unit_price

Per-unit price when sold in multi-packs (else null)

unit_count

Units per pack (else null)

currency

Currency code (e.g. USD)

rating

Average star rating, 0.0-5.0

num_ratings

Total ratings count

url

Product page URL

photo

Main product image URL

num_offers

Number of offers

minimum_offer_price

Lowest offer price

is_best_seller

Has the Best Seller badge

is_amazon_choice

Has the Amazon's Choice badge

is_prime

Default offer is Prime

climate_pledge_friendly

Has the Climate Pledge Friendly badge

sales_volume

Sales volume text (e.g. 5K+ bought in past month), when shown

delivery

Delivery promise text

availability

Stock warning when low (e.g. Only 2 left in stock), else null

has_variations

Product has variants (colors, sizes, etc.)

badge

Listing badge text (e.g. Limited time deal, Overall Pick), when shown

coupon_text

Coupon text (e.g. Save 10% with coupon), when shown

total_products

Total matching products reported by Amazon

query

Echo of the search query

page

Current page number

count

Number of results returned

Example Request

curl "https://apidirect.io/v1/amazon/products?query=phone&sort_by=reviews&max_price=100" \
  -H "X-API-Key: YOUR_API_KEY"

import requests

response = requests.get(
    "https://apidirect.io/v1/amazon/products",
    headers={"X-API-Key": "YOUR_API_KEY"},
    params={
        "query": "phone",
        "sort_by": "reviews",
        "max_price": 100
    }
)
print(response.json())

Example Response

{
  "products": [
    {
      "asin": "B0CTW8TXGH",
      "title": "Motorola Moto g Play 2024 | 64GB | 50MP Camera | Sapphire Blue",
      "price": "$39.88",
      "original_price": null,
      "unit_price": null,
      "unit_count": null,
      "currency": "USD",
      "rating": 4.3,
      "num_ratings": 856,
      "url": "https://www.amazon.com/dp/B0CTW8TXGH",
      "photo": "https://m.media-amazon.com/images/I/71fflP-3W4L._AC_UY654_FMwebp_QL65_.jpg",
      "num_offers": 1,
      "minimum_offer_price": "$39.88",
      "is_best_seller": false,
      "is_amazon_choice": true,
      "is_prime": true,
      "climate_pledge_friendly": false,
      "sales_volume": "5K+ bought in past month",
      "delivery": "FREE delivery Mon, Jun 9",
      "availability": null,
      "has_variations": false,
      "badge": "Overall Pick",
      "coupon_text": null
    }
  ],
  "count": 16,
  "total_products": 132661,
  "query": "phone",
  "page": 1
}

Frequently asked questions

Which Amazon sites can I search?

All 24 Amazon marketplaces — set the country parameter (e.g. country=gb for amazon.co.uk, country=de for amazon.de). Prices come back in the marketplace's currency.

How do I filter by category?

Two ways: category_id takes a category slug like electronics (see /docs/amazon-categories for the full per-country list), and category takes numeric node IDs from any Amazon URL's ?node= parameter.

Why do some Prime-filtered results show is_prime: false?

is_prime=true filters to products with Prime-eligible offers. The is_prime field on each result reflects the default displayed offer's badge, which can differ from the offer that matched the filter.

How many results per page?

Amazon returns about 16 results per page. Use the page parameter (1-20) to paginate; each call is billed as one request.

How does pricing work?

You only pay for successful requests. The Amazon Product Search API costs $0.005 per request. There are no monthly fees or commitments. You get 50 free requests per endpoint every month.

Do I need a credit card to start?

No. You can sign up and use the free tier (50 requests/endpoint/month) without adding a payment method. You only need to add a card when you want to exceed the free tier.

Are there rate limits?

Yes, there's a concurrency limit of 5 simultaneous requests per endpoint per user. If you need more, just get in touch.