Amazon Markets

Amazon Rating Distribution

Retrieve star-rating distribution for a category.

post/v1/amazon/market/rating

Request

Base URL: https://ecommercedataapi.com
URL: https://ecommercedataapi.com/v1/amazon/market/rating
Auth: one of:
- API key in header X-API-Key
- HTTP bearer

Request body

marketplace'US' | 'UK' | 'DE' | 'FR' | 'IT' | 'ES' | 'MX' | 'CA' | 'AU' | 'JP' | 'IN' | 'AE' | 'BR' required

Amazon marketplace code. Supported values are listed in the schema.

monthstring

Data month. Use the format documented for this endpoint, usually yyyyMM. Available values (Table 1.1): nearly, yyyyMM

newProductinteger

Accepted for compatibility. The data service currently returns the same distribution for any value, so it can be left out.

nodeIdPathstring required

Amazon category node path.

returnFieldsstring

Optional comma-separated response fields. Omit it to receive the standard payload.

topNinteger

Top n.

Example request

{
  "marketplace": "US",
  "month": "202507",
  "newProduct": 6,
  "nodeIdPath": "1064954:1069242:1069784:1069820:1069838:1069828",
  "returnFields": "label,asins,products",
  "topN": 10
}

Response

Amazon Rating Distribution response.

request_idstring uuid required

dataunknown required

Changes

No recorded changes to this operation across all 1 revision of this API.