↑ ↓ to move ↵ to open
Amazon Commerce API reference

Amazon Seller Feedback

amazon.seller.feedback

Read a seller's public feedback with rating, date and text, filtered by star rating and time period. Rater names are never included.

At a glance

Endpoint ID
amazon.seller.feedback
Price
0.5 credits per call; failed calls are free
Runs for up to
45 seconds
Request
POST /execute
Run an endpoint
MCP tool when pinned
amazon__seller__feedback
Pin tools
OpenAPI
openapi.json
Download

Request

Send the endpoint ID as capability and its fields as input. Set UPSCRAPE_API_KEY to your key first.

curl --request POST \  --url https://data.upscrape.com/execute \  --header "Authorization: Bearer $UPSCRAPE_API_KEY" \  --header "Content-Type: application/json" \  --header "Prefer: wait=30" \  --data '{  "capability": "amazon.seller.feedback",  "input": {    "limit": 5,    "page": 1,    "period": "365d",    "seller_id": "A151FB8X73UXPJ"  }}'

Input

FieldTypeRequiredWhat it doesExample
seller_id string yes The seller's ID, from its Amazon seller page link. A151FB8X73UXPJ
limit integer no How many feedback entries to return, up to 50. 5
page integer no Which page of feedback, from 1 to 100. 1
period string no How far back: the last 30, 90 or 365 days, or all time. 365d
rating integer no Only feedback with this many stars.

Response

A finished call answers with HTTP 200; the data is in results[0].data, and billing.credits_charged is what it cost. A call still running after the wait answers 202: see jobs and results.

This is results[0].data from a real run:

results[0].data
{  "has_next": true,  "total": 48,  "results": [    {      "text": "this game are great, thank you.",      "rating": 5,      "date": "September 24, 2026",      "fulfillment_channel": "UNKNOWN"    },    {      "text": "Outstanding seller highly recommended love your Nintendo DS game thank you",      "rating": 5,      "date": "September 22, 2026",      "fulfillment_channel": "UNKNOWN"    }  ]}

Fields

FieldTypeWhat it isExample
results[].rating integer The star rating given. 5
results[].date string When the feedback was left. September 24, 2026
results[].text string What the buyer wrote. this game are great, thank you.
results[].fulfillment_channel string UNKNOWN
has_next boolean Whether another page follows; ask for the next page number. true
results array The feedback entries. 5 records
total integer How many feedback entries the seller has. 48

If a call fails

A failed call costs nothing. The response carries an error.code you can branch on; Errors and retries lists every code and which ones to retry.

Other Amazon Commerce endpoints

Something missing or unclear? Ask the team that builds the Amazon Commerce endpoints.