↑ ↓ to move ↵ to open
Amazon Commerce API reference

Amazon Seller Products

amazon.seller.products

List the products a seller offers, with title, rating, review count and Prime.

At a glance

Endpoint ID
amazon.seller.products
Price
0.75 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__products
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.products",  "input": {    "limit": 5,    "page": 1,    "seller_id": "A151FB8X73UXPJ"  }}'

Input

FieldTypeRequiredWhat it doesExample
seller_id string yes Seller identifier. A151FB8X73UXPJ
limit integer no Maximum number of results to return. From 1 to 100. 5
page integer no One-based result page to fetch. From 1 to 100. 1

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,  "results": [    {      "title": "PlayStation DualSense™ Wireless Controller - for PS5, PC, MAC & Mobile",      "rating": 4.7,      "asin": "B0FY6X2XXY",      "position": 1,      "prime": false,      "reviews_count": 49,      "sponsored": false,      "url": "https://www.amazon.com/dp/B0FY6X2XXY"    },    {      "title": "Minecraft - Nintendo Switch",      "rating": 4.8,      "asin": "B07D13QGXM",      "position": 2,      "prime": false,      "reviews_count": 46,      "sponsored": false,      "url": "https://www.amazon.com/dp/B07D13QGXM"    }  ]}

Fields

FieldTypeWhat it isExample
results[].title string The product title as Amazon shows it. PlayStation DualSense™ Wireless Controller - for PS5, PC, MAC &…
results[].rating number The average star rating. 4.7
results[].reviews_count integer How many ratings the product has. 49
results[].prime boolean Whether the listing shows Prime delivery. false
results[].asin string Amazon's product ID (ASIN). B0FY6X2XXY
results[].position integer The result's position in the list. 1
results[].sponsored boolean Whether the result is a sponsored placement. false
results[].url string The product page on Amazon. https://www.amazon.com/dp/B0FY6X2XXY
has_next boolean Whether another page follows; ask for the next page number. true
results array The seller's products. 5 records

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.