---
title: "Get Etsy listing reviews"
method: GET
path: "/v1/etsy/listing/reviews"
tags: ["Etsy"]
---

# Get Etsy listing reviews

`GET /v1/etsy/listing/reviews`

## Request

- Base URL: `https://api.scrapeatlas.com`
- URL: `https://api.scrapeatlas.com/v1/etsy/listing/reviews`
- Auth: API key in header `x-api-key`

Read one page of a listing's buyer reviews (eight per page) with its average rating, review count, count per star, summarised review tags and total pages. Sort by suggested, most recent, highest or lowest rating, or filter to one star rating. Each successful request costs 1 account credit, including partial results. Failed requests cost 0 credits.

## Query parameters

- `id` string
- `url` string
- `page` integer
- `sort` 'suggested' | 'most_recent' | 'highest_rating' | 'lowest_rating'
- `rating` integer

## Response `200`

Inspect the response status and failure or coverage fields.

- union
  - object
    - `requestId` string, uuid, required
    - `accounting` object, required
      - `upstreamRequests` integer, required
      - `responseBytes` integer, required
      - `durationMs` number, required
    - `success` true, required
    - `status` 'success' | 'partial', required
    - `sourceUrl` string, uri, required
    - `fetchedAt` string, date-time, required
    - `coverage` object, required
      - `source` 'public_page' | 'public_api', required
      - `complete` boolean, required
      - `warnings` string[], required
    - `listing` object, required
      - `id` string, required
      - `url` string, uri, required
    - `shopId` string, required
    - `rating` object, required
      - `average` number, nullable, required
      - `count` integer, nullable, required
    - `ratingCounts` object, nullable, required
      - `1` integer, required
      - `2` integer, required
      - `3` integer, required
      - `4` integer, required
      - `5` integer, required
    - `tags` object[], required
      - `name` string, required
      - `count` integer, required
    - `sort` 'suggested' | 'most_recent' | 'highest_rating' | 'lowest_rating'
    - `ratingFilter` integer, nullable, required
    - `page` integer, required
    - `totalPages` integer, nullable, required
    - `nextPage` integer, nullable, required
    - `reviews` object[], required
      - `id` string, required
      - `reviewer` object, required
        - `name` string, required
        - `url` string, uri, nullable, required
        - `avatar` string, uri, nullable, required
      - `date` string, nullable, required
      - `rating` integer, nullable, required
      - `text` string, required
      - `listing` object, nullable, required
        - `id` string, required
        - `title` string, required
        - `url` string, uri, required
        - `image` string, uri, nullable, required
      - `response` string, nullable, required
      - `photo` string, uri, nullable, required
  - object
    - `requestId` string, uuid, required
    - `accounting` object, required
      - `upstreamRequests` integer, required
      - `responseBytes` integer, required
      - `durationMs` number, required
    - `success` false, required
    - `status` 'failed' | 'challenged', required
    - `failure` object, required
      - `code` 'invalid_request' | 'unauthorized' | 'not_found' | 'upstream_challenged' | 'upstream_rate_limited' | 'upstream_error' | 'unsupported_page' | 'response_too_large' | 'unsafe_redirect' | 'request_limit' | 'timeout' | 'busy' | 'payload_too_complex', required
      - `message` string, required

## Other responses

- `400`: Request could not complete; inspect error or failure.code.
- `401`: Request could not complete; inspect error or failure.code.
- `402`: Request could not complete; inspect error or failure.code.
- `403`: Request could not complete; inspect error or failure.code.
- `404`: Request could not complete; inspect error or failure.code.
- `408`: Request could not complete; inspect error or failure.code.
- `413`: Request could not complete; inspect error or failure.code.
- `429`: Request could not complete; inspect error or failure.code.
- `500`: Request could not complete; inspect error or failure.code.
- `502`: Request could not complete; inspect error or failure.code.
- `503`: Request could not complete; inspect error or failure.code.
- `504`: Request could not complete; inspect error or failure.code.

---

[API](https://skmtc.dev/scrapeatlas/apis/scrapeatlas-api.md) · [All operations](https://skmtc.dev/scrapeatlas/apis/scrapeatlas-api/llms.txt) · [OpenAPI document](https://skmtc.dev/scrapeatlas/apis/scrapeatlas-api/revisions/9ba049316894?raw)