Seller Reviews API

The Seller Reviews API returns your seller reviews, similar to the public API, but also including non-published reviews and data.

Note: It is currently not possible to create or modify a Seller Review through the API.

GET /v1/seller_reviews (List seller reviews)

Request parameters

limit, how many reviews per page, default 100, maximum 1000

client_id, the unique identifier for your client configuration.

updated_after (optional) set to YYYY-MM-DD or YYYY-MM-DDTHH:MM:SSZ (ISO 8601) to filter reviews on updated timestamp. For example, 2021-10-01T13:00:00Z

created_after (optional) set to YYYY-MM-DD or YYYY-MM-DDTHH:MM:SSZ (ISO-8601) to filter reviews on created timestamp. For example, 2021-10-01T13:00:00Z

after, used for pagination

Response body

See below, and see the separate description of fields.

If is set, additional pages are available by following the link.

If .errors is set, it’s a list of errors.


$ curl -u sk_token:
  "data": [
      "id": "e63b2ad38dd9ada0",
      "author": "John D",
      "score": 4,
      "score_max": 5,
      "date": "2021-11-22",
      "extract": "Fantastic company",
      "lang": "en",
      "verified_buyer": true,
      "votes_up": 0,
      "votes_down": 0,
      "responses": [],
      "images": [],
      "properties": {},
      "order_id": "O123",
      "customer_id": "C001",
      "updated_at": "2021-11-22T06:38:04Z",
      "accepted": true,
      "accepted_at": "2021-11-22T08:31:46Z",
      "author_email": "",
      "portal_url": ""
  "links": {
    "next": ""