Skip to content

Structured Etsy data: send urls. Cursor-paginated, 1 credit per successful call.

GET · POST1 credit / successful callCursor-paginated
GEThttps://api.scrapier.io/api/v2/etsy-product-reviews/Open in Playground

Call GET /api/v2/etsy-product-reviews/ with urls. The results are in data.reviews; send data.next_cursor back as cursor to get the next page. 4 optional parameters refine the call (see Parameters).

Terminal window
curl -G "https://api.scrapier.io/api/v2/etsy-product-reviews/" \
-H "X-API-Key: YOUR_API_KEY" \
--data-urlencode "urls=RosysPatterns" \
--max-time 210
NameTypeRequiredDefaultDescription
X-API-Key headerstringyes—Your API key from the dashboard.
urlsstringyese.g. RosysPatternsEtsy listing URL / listing id (product reviews) or shop URL / shop name (shop reviews). Required on the first call (list -> first only). 24 reviews per page.
cursorstringno—Pagination cursor returned in the previous response's next_cursor. Pass it back unchanged to fetch the next page. When next_cursor is null, you have reached the last page.
sort_optionstringnoRecency
RecencyRelevancyHighestLowest
locked in cursor
enrich_buyer_profilesbooleannofalse
locked in cursor
include_subratingsbooleannofalseBest-effort (DataDome-gated).
locked in cursor
Advanced
NameTypeDefaultDescription
use_proxybooleantrueRoute the request through Scrapier's residential proxy pool. Default: true. Leave as is unless support tells you otherwise.
raw_databooleanfalseWhen true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under raw_responses, in place of the formatted items. When false (default) you get the formatted output. Pagination (cursor / next_cursor) works the same in both modes.
{
"success": true,
"data": {
"urls": "RosysPatterns",
"review_type": "shop",
"shop_name": "RosysPatterns",
"shop_id": 42510206,
"listing_id": null,
"total_reviews": 2074,
"page": 1,
"page_size": 24,
"reviews": [
{
"input_url": "RosysPatterns",
"review_type": "shop",
"receipt_id": 5218626147,
"buyer_user_id": 66570233,
"buyer_real_name": "Flop",
"buyer_login_name": "dorisgt",
"buyer_image": "https://i.etsystatic.com/iusa/c4ae13/31745354/iusa_75x75.31745354_97zs.jpg?version=0",
"listing_title": "Whole Shop 113 Rosys Patterns Sewing Patterns, Beginner Sewing Patterns, XXS-XXL, Bundle Set, Sewing Instructions, US Letter-A4-A0 Format",
"review": "The seller is really lovely and talented. I haven't had a chance to sew any patterns yet, but I have no doubt they'll be beautiful. I'm so happy that the photos aren't ai generated. Love supporting creative and hardworking creators 💙",
"appreciation_image": null,
"product_rating": 5,
"response": null,
"reviews_count": 30,
"date": "2026-09-26 06:36:27",
"recommends": false,
"subratings": {},
"product_details": {
"shop_average_rating": 4.56,
"shop_total_rating_count": 2074,
"product_url": "https://www.etsy.com/listing/1791096370/whole-shop-113-rosys-patterns-sewing",
"seller_name": "RosysPatterns",
"seller_url": "https://www.etsy.com/shop/RosysPatterns",
"reviewer_image": "https://i.etsystatic.com/42510206/r/il/55843f/8248553529/il_fullxfull.8248553529_agtm.jpg",
"image": [
"https://i.etsystatic.com/42510206/r/il/55843f/8248553529/il_fullxfull.8248553529_agtm.jpg",
"https://i.etsystatic.com/42510206/r/il/55843f/8248553529/il_75x75.8248553529_agtm.jpg",
"https://i.etsystatic.com/42510206/r/il/55843f/8248553529/il_170x135.8248553529_agtm.jpg"
]
},
"listing_id": 1791096370,
"shop_id": 42510206,
"position": 1,
"page": 1,
"sort_option": "Recency",
"scraped_at": "2026-09-26T11:02:37.564Z"
}
],
"next_cursor": "eyJpIjoiUm9zeXNQYXR0ZXJucyIsImxpZCI6MTkwNjA4NjY1OSwibGsiOnsiZW5yaWNoX2J1eWVyX3Byb2ZpbGVzIjp0cnVlLCJpbmNsdWRlX3N1YnJhdGluZ3MiOmZhbHNlLCJzb3J0X29wdGlvbiI6IlJlY2VuY3kifSwibHIiOm51bGwsIm0iOiJzaG9wIiwibiI6MjQsIm5wIjo0LCJwIjoyLCJzIjpbNTIxODYyNjE0Nyw1MjE4ODg0MDgxLDUxNjc1ODY4NDAsNTIyMzQ0MTkzNiw1MjIxMDQwNjQ1LDUyMDYxMjY0NzYsNTEyOTYwMzUwMCw1MTc5NjA4MzA0LDUyMTc1MDEzMzcsNTIxMjE0MjY2NCw1MjEwMTE5NjQ3LDUxMjEyNjYxMjgsNTExNjY4MTA5OSw1MTI2NDk0MjU1LDUxODUwOTcyNzksNTEyMDk3ODE5NSw1MTM2OTc2ODA4LDUyMDcwODI0ODEsNTEzMjQyNzczNiw1MjAxMjkyMjQ1LDUxNjQyODgzNTcsNTE2NTMzOTE4Miw1MTMwOTQ5Mjc0LDUwODI0NjM1OTFdLCJzYSI6NC41Niwic2QiOlsxOTA2MDg2NjU5LDE4NjIzMzAyNTcsNDQwNTg0MzIyMl0sInNpZCI6NDI1MTAyMDYsInNuIjoiUm9zeXNQYXR0ZXJucyIsInN0IjoyMDc0fQ"
}
}

Sample from the live catalog; arrays trimmed to 3 items. Results are in data.reviews.

FieldTypeExampleDescription
urlsstringRosysPatterns—
review_typestringshop—
shop_namestringRosysPatterns—
shop_idinteger42510206—
listing_idnullnull—
total_reviewsinteger2074—
pageinteger1—
page_sizeinteger24—
reviewsarray[1 item]The results.
next_cursorstringeyJpIjoiUm9zeXNQYXR0ZXJucyIsImxpZCI6MTkwNjA4N…Pass back as cursor for the next page. null on the last page.
reviews[].input_urlstringRosysPatterns—
reviews[].review_typestringshop—
reviews[].receipt_idinteger5218626147—
reviews[].buyer_user_idinteger66570233—
reviews[].buyer_real_namestringFlop—
reviews[].buyer_login_namestringdorisgt—
reviews[].buyer_imagestringhttps://i.etsystatic.com/iusa/c4ae13/31745354…—
reviews[].listing_titlestringWhole Shop 113 Rosys Patterns Sewing Patterns…—
reviews[].reviewstringThe seller is really lovely and talented. I h…—
reviews[].appreciation_imagenullnull—
reviews[].product_ratinginteger5—
reviews[].responsenullnull—
reviews[].reviews_countinteger30—
reviews[].datestring2026-09-26 06:36:27—
reviews[].recommendsbooleanfalse—
reviews[].subratingsobject{…}—
reviews[].product_detailsobject{…}—
reviews[].listing_idinteger1791096370—
reviews[].shop_idinteger42510206—
reviews[].positioninteger1—
reviews[].pageinteger1—
reviews[].sort_optionstringRecency—
reviews[].scraped_atstring2026-09-26T11:02:37.564Z—

Pass data.next_cursor back as cursor until it is null. Required inputs are ignored once a cursor is sent. Each page is one billed call. More in Pagination.

const url = "https://api.scrapier.io/api/v2/etsy-product-reviews/";
let params = { urls: "RosysPatterns" };
const items = [];
for (let page = 0; page < 10; page++) { // each page is one billed call
const res = await fetch(`${url}?${new URLSearchParams(params)}`, {
headers: { "X-API-Key": "YOUR_API_KEY" },
signal: AbortSignal.timeout(210_000),
});
const body = await res.json();
if (!res.ok) throw new Error(body.error ?? body.detail ?? `HTTP ${res.status}`);
const data = body.data;
items.push(...(data.reviews ?? []));
if (!data.next_cursor) break; // null = last page
params = { cursor: data.next_cursor };
}

Failed calls are free. Branch on the HTTP status and read the message from error (or detail). Full details in Errors.

StatusMeaningRetry?Charged?
400Bad or missing input.No — fix the paramsNo
401 / 403Missing, invalid or revoked API key.No — fix the keyNo
402Out of credits (body has balance).No — top upNo
404Unknown endpoint slug.No — check the slugNo
429 / 503Busy or throttled.Yes — after Retry-AfterNo
5xxTarget site or upstream failure, or timeout.Yes — with backoffNo
  • Locked into the cursor: sort_option, enrich_buyer_profiles, include_subratings. Set them on the first call; later pages reuse them.
  • Etsy Product Info by Url — Structured Etsy data: send urls. Single lookup, 1 credit per successful call.
  • Etsy Search by Keyword — Structured Etsy data: send queries. Cursor-paginated, 1 credit per successful call.
  • Etsy Search Suggestions — Structured Etsy data: send queries. Cursor-paginated, 1 credit per successful call.
  • Etsy Shop Products — Structured Etsy data: send urls. Cursor-paginated, 1 credit per successful call.