Etsy Reviews Scraper: Product Feedback, Ratings, Review Text

Scrape Etsy customer reviews from product listing URLs and shop pages for sentiment analysis, competitor research, product-market research, and AI-agent workflows.

What It Extracts

Field	Description
rating	Customer star rating from 1 to 5 when Etsy exposes it
reviewText	Full review body text
reviewDate	Review date from the Etsy page
reviewerName	Public reviewer display name
reviewerProfileUrl	Public Etsy reviewer profile URL when visible
reviewImages	URLs for review photos when available
listingId	Etsy listing ID
listingTitle	Product title from the listing page
listingUrl	Canonical Etsy product URL
listingRating	Listing or shop rating context
listingReviewCount	Visible review count context
shopName	Etsy shop name
shopUrl	Etsy shop URL
diagnosticStatus	blocked or empty when no review rows could be extracted

When To Use This Actor

Use Etsy Reviews Scraper when you need structured customer feedback from specific Etsy products. It is useful for tracking competitor reviews, finding recurring complaints, collecting user-generated product language, training sentiment classifiers, monitoring quality changes, and building buyer-research datasets for handmade, vintage, craft supply, and digital product niches.

This actor is also designed for Apify MCP and AI agents. A model can pass one or more Etsy product URLs, receive a flat dataset of review rows, and chain the result into a sentiment analyzer, spreadsheet export, or product research report.

When Not To Use It

Do not use this actor for broad Etsy keyword search, price monitoring, or catalog scraping. Use etsy-all-in-one-scraper when you need product listings, shop catalogs, prices, badges, and reviews in one run. Use this narrower actor when the job is specifically review extraction from known listings or shop pages.

Do not use this actor for private account data, buyer messages, seller dashboards, or logged-in-only Etsy data. It extracts public review content visible from Etsy listing and shop pages.

Input

Product URLs

Pass one or more direct Etsy listing URLs:

{
  "productUrls": [
    "https://www.etsy.com/listing/1071878058/charger-plate-pumpkin-set-pumpkin"
  ],
  "maxReviewsPerListing": 25,
  "maxResults": 25
}

Direct listing URLs are the most reliable path because the actor can go straight to the review section and avoid unnecessary discovery pages.

Shop URLs

You can also pass Etsy shop URLs. The actor opens the shop, discovers visible listing URLs, and then scrapes reviews from those listings:

{
  "shopUrls": [
    "https://www.etsy.com/shop/GlassMystique"
  ],
  "maxReviewsPerListing": 10,
  "maxResults": 50
}

Shop crawling is slower and more sensitive to Etsy layout changes than direct product URLs. For production pipelines, feed product URLs whenever possible.

Limits

maxReviewsPerListing caps review rows per product. maxResults caps the total review rows saved across the full run. The actor stops before charging beyond the total cap.

Output Example

{
  "recordType": "review",
  "reviewId": "1234567890",
  "reviewUrl": "https://www.etsy.com/listing/1071878058/charger-plate-pumpkin-set-pumpkin#review-1234567890",
  "rating": 5,
  "reviewText": "Beautiful quality and shipped quickly.",
  "reviewDate": "2026-05-21",
  "reviewerName": "Avery",
  "reviewerProfileUrl": "https://www.etsy.com/people/example",
  "reviewImages": ["https://i.etsystatic.com/example.jpg"],
  "listingId": "1071878058",
  "listingTitle": "Charger Plate Pumpkin Set",
  "listingUrl": "https://www.etsy.com/listing/1071878058/charger-plate-pumpkin-set-pumpkin",
  "listingRating": 4.8,
  "listingReviewCount": 327,
  "shopName": "GlassMystique",
  "shopUrl": "https://www.etsy.com/shop/GlassMystique",
  "sourceUrl": "https://www.etsy.com/listing/1071878058/charger-plate-pumpkin-set-pumpkin",
  "scrapedAt": "2026-06-12T12:00:00.000Z",
  "diagnosticStatus": null,
  "diagnosticMessage": null
}

Pricing

This actor uses pay per event pricing.

Event	Price	When it is charged
Actor start	$0.00005	Once when the actor starts, scaled by memory
Etsy review scraped	$0.005	Each review row successfully saved to the dataset

Typical run cost examples:

Run	Approximate PPE cost
10 reviews	$0.05005
25 reviews	$0.12505
100 reviews	$0.50005

The actor logs the estimated maximum charge before scraping starts. Diagnostic rows are not charged as review rows.

Reliability Notes

Etsy uses DataDome anti-bot protection. The actor defaults to Apify Residential proxies and uses a real Chrome Playwright browser with a warmup step before visiting product pages. If Etsy returns a DataDome challenge that cannot be resolved, the actor saves a diagnostic row and writes RUN_SUMMARY and OUTPUT records to the key-value store. This avoids silent empty datasets and gives agents a clear explanation of what happened.

For stronger DataDome bypass on protected runs, configure TWO_CAPTCHA_API_KEY as an actor environment variable or provide a high-quality rotating residential proxy through CUSTOM_PROXY_URL. The actor never requires Etsy login credentials.

API Example

import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: process.env.APIFY_TOKEN });

const run = await client.actor('khadinakbar/etsy-reviews-scraper').call({
  productUrls: ['https://www.etsy.com/listing/1071878058/charger-plate-pumpkin-set-pumpkin'],
  maxReviewsPerListing: 10,
  maxResults: 10
});

const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);

MCP And AI Agent Use

Tool description: Scrape Etsy product reviews for sentiment and competitor research. Use for listing URLs or shop URLs, not broad Etsy product search. Returns one review per row with rating, text, reviewer, date, listing, shop, and diagnostic fields. Charged $0.005 per review plus a tiny start fee.

Agents should call this actor when the user asks for Etsy review text, customer sentiment, complaint themes, review exports, or competitor product feedback. Agents should not call it for price search, product discovery, private seller analytics, or logged-in data.

Legal And Compliance

This actor extracts public web data from Etsy pages. Review Etsy's terms and applicable laws before using the data in production. Do not use the output to spam, harass, deanonymize buyers, or make automated decisions that violate privacy or marketplace rules.