Amazon Seller Reviews API

Endpoint

GET /v1/amazon/seller/reviews

Parameters

seller_id *

Amazon seller ID

page

Page number, 1-20 (default: 1)

star_rating

all (default), 5_stars, 4_stars, 3_stars, 2_stars, 1_stars, positive, critical

country

Marketplace country code (default: us)

get_sentiment

Set to true to add AI emotion analysis (+$0.001/request)

Response fields

reviews

Array of seller reviews

author_name

Reviewer display name

review_text

Review body text

rating

Star rating, 1-5

review_date

Review date (e.g. August 30, 2026)

has_response

Whether the seller responded

sentiment

Emotion analysis: emotions, dominant_emotion, emotional_intensity, polarity (when get_sentiment=true)

seller_id

Echo of the seller ID

page

Current page number

star_rating

Echo of the star rating filter

has_next_page

Whether another page of reviews exists

count

Number of reviews returned

Example Request

curl "https://apidirect.io/v1/amazon/seller/reviews?seller_id=A2L77EE7U53NWQ" \
  -H "X-API-Key: YOUR_API_KEY"

import requests

response = requests.get(
    "https://apidirect.io/v1/amazon/seller/reviews",
    headers={"X-API-Key": "YOUR_API_KEY"},
    params={"seller_id": "A2L77EE7U53NWQ"}
)
print(response.json())

Example Response

{
  "reviews": [
    {
      "author_name": "Tammy Parson",
      "review_text": "Received the next day in perfect condition. Contacted the seller and was answered promptly.",
      "rating": 5.0,
      "review_date": "August 30, 2026",
      "has_response": false
    }
  ],
  "count": 5,
  "seller_id": "A2L77EE7U53NWQ",
  "page": 1,
  "star_rating": "all",
  "has_next_page": true
}

Frequently asked questions

How does pagination work?

Pass page (1-20). Each page returns the next batch of reviews; has_next_page tells you whether to keep going.

What do positive and critical mean?

positive returns 4-5 star feedback, critical returns 1-2 star feedback — the same buckets Amazon uses on the seller page.

Can I analyze review sentiment automatically?

Yes — set get_sentiment=true to add per-review AI emotion analysis (emotions, dominant emotion, intensity, polarity) for +$0.001 per request.

How does pricing work?

You only pay for successful requests. The Amazon Seller Reviews 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.