Get Etsy Listing Buyer Reviews
GET/v1/etsy/reviews· Updated 2026-11-14
Direct Answer · Commerce Engineering Summary
GET /v1/etsy/reviews retrieves verified buyer reviews, star ratings, purchased variation notes, and customer photo URLs for any Etsy listing_id. Priced at 2 Credits per returned review ($0.08–$0.20 per 1,000 reviews, 0 Credits if a listing has no reviews).
Honest Trade-Offs & Scope Boundaries
- →Requires a numeric Etsy listing_id (discoverable via GET /v1/etsy/search or any etsy.com/listing/{id} URL).
- →Extracts public buyer feedback only; private Etsy Messages between buyers and makers are never accessed.
- →Zero credits charged when a brand-new listing has 0 reviews.
Extract verified buyer reviews for an Etsy listing_id. Cost: 2 Credits / review returned.
Parameters
listing_idstringrequired
Example Request (cURL / Python / JavaScript)
curl "https://api.shopdataapi.com/v1/etsy/reviews?listing_id=1510223855" \
-H "x-api-key: sd_live_your_api_key"import requests
res = requests.get(
"https://api.shopdataapi.com/v1/etsy/reviews?listing_id=1510223855",
headers={"x-api-key": "sd_live_your_api_key"},
timeout=30,
)
print(res.json())const res = await fetch("https://api.shopdataapi.com/v1/etsy/reviews?listing_id=1510223855", {
headers: { "x-api-key": "sd_live_your_api_key" },
});
const data = await res.json();
console.log(data);Response Fields
Normalized Etsy review list.
| Field | Type | Sample / Notes |
|---|---|---|
code | integer | Example: 0 |
status | string | Example: ok |
msg | string | Example: success |
data | array of object | |
review_id | string | |
rating | number | Example: 5 |
title | stringnull | |
body | string | |
author | string | |
verified_purchase | boolean | |
reviewed_at | stringnull | |
variant | stringnull |
Status Codes
- 200
- Normalized Etsy review list.