# Etsy Reviews (`hello.datawizards/etsy-reviews`) Actor

Quickly extract detailed customer reviews from Etsy product listings. Perfect for Etsy sellers and analysts!

- **URL**: https://apify.com/hello.datawizards/etsy-reviews.md
- **Developed by:** [datawizards](https://apify.com/hello.datawizards) (community)
- **Categories:** Automation, Lead generation, E-commerce
- **Stats:** 346 total users, 63 monthly users, 98.3% runs succeeded, 4 bookmarks
- **User rating**: 5.00 out of 5 stars

## Pricing

from $5.00 / 1,000 results

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

## Etsy Reviews Actor Readme

### About Etsy

**Website Link:** <https://www.etsy.com/>

Etsy is an online marketplace that specializes in handmade, vintage, and unique goods. It connects independent sellers with buyers looking for custom, artistic, or one-of-a-kind items, including crafts, jewelry, home decor, clothing, and art. It also supports small businesses and promotes sustainable, creative entrepreneurship.

***

### Etsy Reviews

Effortlessly extract customer reviews from Etsy product listings with this reliable and efficient tool. Whether you're conducting market research, analyzing customer sentiment, or monitoring competitors, this actor automates the process and provides rich, structured data in JSON format. Perfect for Etsy sellers, marketers, and data enthusiasts, the scraper handles pagination, retrieves detailed review fields like ratings, reviewer names, and dates, and offers customization for language and review limits. Start optimizing your Etsy strategy today!

This tool is designed to extract vital data such as:

- **Buyer login Name**
- **Buyer Real Name**
- **Buyer User Id**
- **Product Title**
- **Product Url**
- **Product Image**
- **Reviews Date**
- **Rating**
- **Seller Name**
- **Seller Url**
- **Shop Average Rating**
- **Receipt Id**
- **Response**
- **Review**

***

#### Features:

- **Search by Shop Name**
- **Scrape Product Reviews:**
- **In-Depth Scraping:** Obtain detailed reviews from Shop Name.
- **Scalability**
- **Fast Load**
- **Low Cost**

***

### Example Usage

#### Sample Input:

```json
{
  "itemLimit": 10,
  "shop_name": [
    "HereafterLA"
  ]
}

```

#### Output Format:

```json
{
"receipt_id": 3531301612,
"buyer_user_id": 576032796,
"buyer_real_name": "Troy Heart",
"buyer_login_name": "9lxfg3yy80ie9mt8",
"listing_title": "Otters Pair Ornament (Comes with 2) [Valentine&#39;s Day Gift, Sea Otters Ornament, Otter Gift, Love Ornament, Wood Ornament, Couple Ornament]",
"review": "I love this ornament so much!",
"product_rating": 5,
"response": null,
"reviews_count": 1,
"date": "2024-12-21 23:41:45",
"product_details": {
"shop_average_rating": "4.926",
"product_url": "https://www.etsy.com/listing/713223295/otters-pair-ornament-comes-with-2",
"seller_name": "HereafterLA",
"seller_url": "https://www.etsy.com/shop/HereafterLA",
"image": "https://i.etsystatic.com/6748817/r/il/ed715a/2863707288/il_fullxfull.2863707288_nrw4.jpg"
}
}
```

***

### Use Cases

- **Customer Sentiment Analysis**: Analyze customer feedback to identify trends and areas for improvement.
- **Competitor Analysis**: Monitor reviews for competing products to understand their strengths and weaknesses.
- **Market Research**: Aggregate reviews to identify common themes, popular product features, or pain points.
- **Etsy Shop Management**: Use insights from reviews to optimize product offerings and improve customer satisfaction.

***

### Related Actors

#### [Etsy Search](https://apify.com/hello.datawizard-owner/etsy-shop-scraper)

Extract product listings and relevant search results from Etsy based on keywords. Perfect for market research, competitor analysis, and identifying trending products.

#### [Etsy Shop](https://apify.com/hello.datawizard-owner/etsy-search)

Scrape detailed data about Etsy shops, including shop information, listings, and categories. Ideal for gaining insights into competitor shops or researching potential collaboration opportunities.

***

### Notes:

- For empty results, please run once again. You can freely contact us or create an issue in the Apify Console.

***

### Your Feedback:

Our scrapers are always working to improve performance. If you’ve got any technical feedback, suggestions, or improvements for Etsy Reviews, or if you have found any issues or bugs, please create an issue in the Actor’s Issues tab in the Apify Console.

***

#### Thank You for Using Etsy Reviews! 🚀

# Actor input Schema

## `shop_name` (type: `array`):

One or more locations where the crawler will start.

## `itemLimit` (type: `integer`):

Specifies the maximum number of items to process.

## Actor input object example

```json
{
  "shop_name": [
    "GlassMystique"
  ],
  "itemLimit": 10
}
```

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "shop_name": [
        "GlassMystique"
    ],
    "itemLimit": 10
};

// Run the Actor and wait for it to finish
const run = await client.actor("hello.datawizards/etsy-reviews").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "shop_name": ["GlassMystique"],
    "itemLimit": 10,
}

# Run the Actor and wait for it to finish
run = client.actor("hello.datawizards/etsy-reviews").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "shop_name": [
    "GlassMystique"
  ],
  "itemLimit": 10
}' |
apify call hello.datawizards/etsy-reviews --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=hello.datawizards/etsy-reviews",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/acts/uWHEg6rc66GA17Xah/builds/Y6OoyO90cHnV9s7GB/openapi.json