Etsy Reviews API

Overview

This API endpoint allows you to retrieve reviews from Etsy. Here are some important things to know:

  • The Etsy API returns 4 reviews per request.
  • The order in which reviews are returned is by descending date(from newest to oldest).
  • You can get all reviews from a single product by using the offset parameter.

Endpoint

GET https://wextractor.com/api/v1/reviews/etsy

Parameters

Parameter Required Description Example
auth_token Required Your API token for authentication. Once you register to Wextractor you can extract this key from your account's setting page. -
id Required The full url. https://www.etsy.com/listing/1269390405/baby-comforter-mr-goose-duck-plushplush
offset Optional This parameter defines the result offset. It skips the given number of reviews. It's used for pagination. (e.g., 0 (default) is the first page of results, 4 is the 2nd page of results, 8 is the 3rd page of results, etc.). 4

Example Request

https://wextractor.com/api/v1/reviews/etsy?id=https%3A%2F%2Fwww.etsy.com%2Flisting%2F1269390405%2Fbaby-comforter-mr-goose-duck-plushplush&auth_token=your_auth_token&offset=0

Example Response


{
  "product": {
      "name": "Baby comforter Mr. Goose | duck plush,plush toy,goose plush,duck plushie,duck lovey,goose stuff animal,baby comforter,lovey,baby lovey",
      "description": "Our Latest idea for our smallest people, Plush Toy baby comforter Mr. Goose! Mr. Goose is perfect as sleeping toy for babies, Mr. Goose is made of  very soft boucle type material which is safe for babies to cuddle. We love, our daugther loves it and we hope that You will too!\n\nChristmas edition plush duck is with removable Chirstmas hat and woolen scarf!\n\nRegular option - polyester toy filling + buckwheat shells for squishy noise.\nNatural option - renewable cotton filling + buckwheat shells for squishy noise.\n\n! Only SOFT Hand wash at 86F / 30C. \n! DO NOT USE COLORED WASHING LIQUID!\n! Do not tumble wash or dry!!!\n! After washing softly squeeze out the water from the toy and dry it naturally or on warm heat source.\n\nWhen a package is shipped internationally, it may be subject to import taxes, customs duties, and/or fees imposed by the destination country. These charges will typically be due once the shipped goods arrive at the country of destination. Buyers are responsible for any customs and import taxes that may apply.\n\nManufacturer contact information: [email protected]\nProduct safety warnings: NONE\n\n\nsoft sleeping toy,\tplush toy duck,baby sleep toy,plushie comforter,plush comforter,baby comforter,comforter,duck toy,duck plush,goose plush,baby stuff,goose lovey,duck lovey\n\ncomforter,duck plush,plush toy,duck,goose,goose plush,duck plushie,duck stuff animal,duck lovey,goose stuff animal,baby comforter,goose lovey,baby lovey",
      "image_urls": [
          "https://i.etsystatic.com/36611196/r/il/e43a17/4292558034/il_fullxfull.4292558034_n4xc.jpg",
          "https://i.etsystatic.com/36611196/r/il/0473d1/4919250841/il_fullxfull.4919250841_rkwo.jpg",
          "https://i.etsystatic.com/36611196/r/il/c5a753/4191384819/il_fullxfull.4191384819_qn65.jpg",
          "https://i.etsystatic.com/36611196/r/il/bfe117/4191384973/il_fullxfull.4191384973_bs91.jpg",
          "https://i.etsystatic.com/36611196/r/il/8f7c8b/4919248849/il_fullxfull.4919248849_ksds.jpg",
          "https://i.etsystatic.com/36611196/r/il/589b35/4845668705/il_fullxfull.4845668705_3aiz.jpg",
          "https://i.etsystatic.com/36611196/r/il/236d06/4845669787/il_fullxfull.4845669787_tjhp.jpg",
          "https://i.etsystatic.com/36611196/r/il/664ce7/5511433661/il_fullxfull.5511433661_sgpu.jpg",
          "https://i.etsystatic.com/36611196/r/il/b93ab2/5559500585/il_fullxfull.5559500585_298g.jpg",
          "https://i.etsystatic.com/36611196/r/il/af4682/5920142355/il_fullxfull.5920142355_61sp.jpg"
      ],
      "category": "Toys & Games < Toys < Stuffed Animals & Plushies",
      "brand": "WildJulyStore"
  },
  "totals": {
      "review_count": 193
  },
  "reviews": [
      {
          "id": "4426308705",
          "datetime": "2025-02-19T00:00:00",
          "text": "Love this, great for photos",
          "url": null,
          "rating": "5",
          "reviewer": "Katherin Palski",
          "reviewer_avatar": null,
          "reviewer_url": "https://etsy.com/people/rvevlblq?ref=l_review",
          "recommends": "Recommends this item",
          "item_quality_rating": "5",
          "delivery_rating": "5",
          "customer_service_rating": "5",
          "image_urls": [
              "https://i.etsystatic.com/iap/8711a8/6705542577/iap_300x300.6705542577_krf6woev.jpg?version=0"
          ]
      },
      {
          "id": "4439830274",
          "datetime": "2025-02-18T00:00:00",
          "text": "Bought two for my new twin nieces! They arrived before delivery date, and the packaging was beautiful.",
          "url": null,
          "rating": "5",
          "reviewer": "Megan Roy",
          "reviewer_avatar": null,
          "reviewer_url": "https://etsy.com/people/y4ic54r4wzgi2vlw?ref=l_review",
          "recommends": "Recommends this item",
          "item_quality_rating": "5",
          "delivery_rating": "5",
          "image_urls": []
      },
      {
          "id": "4452870490",
          "datetime": "2025-02-18T00:00:00",
          "text": "As I have said before, this is the BEST baby gift...I have purchased many",
          "url": null,
          "rating": "5",
          "reviewer": "bettemccarthy1",
          "reviewer_avatar": null,
          "reviewer_url": "https://etsy.com/people/bettemccarthy1?ref=l_review",
          "recommends": "Recommends this item",
          "item_quality_rating": "5",
          "delivery_rating": "5",
          "customer_service_rating": "5",
          "image_urls": []
      },
      {
          "id": "4465123157",
          "datetime": null,
          "text": "Reçus rapidement, commande de 2 doudous oie. Très satisfaite, ils sont conformes aux photos et de qualité. \nMaintenant il n'y a plus qu'à attendre bébé !",
          "url": null,
          "rating": "5",
          "reviewer": "Adeline Kaiser",
          "reviewer_avatar": null,
          "reviewer_url": "https://etsy.com/people/isuq8iw1jurmx831?ref=l_review",
          "recommends": "",
          "item_quality_rating": "5",
          "delivery_rating": "5",
          "customer_service_rating": "5",
          "image_urls": []
      }
  ]
}

Error Codes

Status Code Error Type Description
400 InvalidRequest The request parameters are invalid or missing
401 Unauthorized Invalid or missing API key
403 Forbidden Your account is out of credits
429 RateLimitExceeded You've exceeded the API rate limit(10 requests per second)
500 ServerError An unexpected error occurred on our servers. In these cases we recommend to retry the request for a couple of times. If the error subsists you can reach us to open a ticket.