Seller Reviews API

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

GET /v1/seller_reviews (List seller reviews)

Request parameters

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

client_id, if you have access to multiple clients with your api key

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": ""