# Etsy Email Scraper (`api-empire/etsy-email-scraper`) Actor

Scrape publicly available Etsy seller and shop email addresses with shop names, product details, categories, locations, and profile information. Build targeted datasets for seller research, B2B lead generation, prospecting, market analysis, and outreach.

- **URL**: https://apify.com/api-empire/etsy-email-scraper.md
- **Developed by:** [API Empire](https://apify.com/api-empire) (community)
- **Categories:** Lead generation, Automation, E-commerce
- **Stats:** 27 total users, 3 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $4.99 / 1,000 results

This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#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** Email Scraper 📱

Etsy Email Scraper is a powerful tool for extracting emails and contact information from Etsy shop and listing pages. This Etsy contact extractor provides efficient and automated data collection capabilities.

It is designed to collect publicly available contact details while maintaining compliance with platform guidelines. The tool offers user-friendly operation for both beginners and advanced users.

With advanced filtering options, Etsy Email Scraper ensures accurate and relevant data extraction. It supports various output formats for seamless integration with other tools.

### Support and feedback

- **Bug reports**: Open a ticket in the repository Issues section
- **Custom features**: Contact our enterprise support team
  *Email: dev.scraperengine@gmail.com*

### Extractable Data Table 📊

Each result row contains the following fields:

| Data Type | Description |
| --- | --- |
| network | Source platform (e.g. etsy.com). |
| keyword | The keyword that produced this result. |
| title | Title of the result (usually the shop/listing name). |
| description | Snippet text from the result, which may contain contact info. |
| url | Direct URL to the Etsy page. |
| email | Publicly available email address extracted from the result. |

### Key Features of **Etsy** Email Scraper

Here are the standout features that make the Etsy Email Scraper a reliable tool for data extraction:

- ⭐ Efficient email extraction from Etsy
- ⭐ User-friendly interface for easy operation
- ⭐ Automated data collection process
- ⭐ Compliance with Etsy guidelines
- ⭐ Multiple output format support

### How to use **Etsy** Email Scraper 🚀

Follow this simple, step-by-step guide to start extracting Etsy emails today:

1. ✅ Access the Etsy Email Scraper tool
2. ✅ Configure your target keywords and filters
3. ✅ Set extraction parameters and filters
4. ✅ Start the automated scraping process
5. ✅ Review and export the collected data

### Use Cases 🎯

General Use
🎯 Extract contact information from Etsy shops and listings
🎯 Build contact databases for business purposes
🎯 Gather data for market research and analysis

### Why choose us? 💎

Etsy Email Scraper offers reliable and efficient Etsy data extraction. Our tool ensures compliance with platform terms while providing comprehensive contact information collection.

### **Etsy** Email Scraper Scalability 📈

Etsy Email Scraper is designed to handle various data extraction needs efficiently. The tool provides scalable solutions for both small and large-scale contact data collection.

### **Etsy** Email Scraper Legal Guidelines ⚖️

**Yes**—scraping Etsy is legal as long as you follow ethical and compliant practices. The Etsy Email Scraper extracts only publicly available information from public Etsy pages, making it safe and compliant for research, marketing, and analysis.

#### Legal & Ethical Guidelines

⚖️ Follow Etsy terms of service
⚖️ Only collect publicly available information
⚖️ Use extracted data responsibly and ethically
⚖️ Respect user privacy and data protection laws

### Input Parameters 🧩

📦 Example Input (JSON)

```json
{
  "keywords": ["handmade jewelry"],
  "platform": "Etsy",
  "location": "",
  "emailDomains": ["@gmail.com", "@outlook.com"],
  "maxEmails": 10,
  "engine": "legacy",
  "proxyConfiguration": { "useApifyProxy": false }
}
```

### Input Table

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| keywords | array | ✅ Yes | Keywords used to find relevant Etsy pages. One or more. |
| platform | string | No | Platform to scrape. Currently `Etsy`. |
| location | string | No | Optional location filter. Empty = global. |
| emailDomains | array | No | Keep only emails from these domains (e.g. `@gmail.com`). Custom/business domains supported. Empty = all domains. |
| maxEmails | integer | No | Max emails to collect per keyword (default `10`, range 1–100000). |
| engine | string | No | Processing engine. Currently `legacy`. |
| proxyConfiguration | object | No | Proxy settings. Empty = the actor auto-selects the best proxy (recommended). |

> ℹ️ Emails are sourced from publicly available information only. Yield depends on how many pages publicly expose a contact email. Broaden `keywords`/`emailDomains` and raise `maxEmails` for more results.

### Output Format 📤

📝 Example Output (JSON)

```json
[
  {
    "network": "etsy.com",
    "keyword": "handmade jewelry",
    "title": "Handmade Silver Necklace - Custom Jewelry Shop",
    "description": "Handcrafted jewelry made to order. For custom requests, email us at hello@silverleafstudio.com",
    "url": "https://www.etsy.com/shop/SilverLeafStudio",
    "email": "hello@silverleafstudio.com"
  }
]
```

### Output Table

| Data Type | Description |
| --- | --- |
| network | Source platform (etsy.com) |
| keyword | Keyword that triggered the result |
| title | Result title (usually the shop/listing name) |
| description | Public snippet, may contain contact info |
| url | Direct Etsy page link |
| email | Extracted email address |

### FAQ ❓

#### What is Etsy Email Scraper?

Etsy Email Scraper is a tool designed to extract emails and contact information from Etsy shop and listing pages efficiently.

#### Is Etsy Email Scraper legal to use?

Yes, as long as it is used in compliance with Etsy terms and applicable data privacy laws.

#### What data can Etsy Email Scraper extract?

Etsy Email Scraper can extract publicly available email addresses along with the result title, snippet, and page URL for each match.

#### How does Etsy Email Scraper work?

Etsy Email Scraper automates the process of collecting contact information from Etsy pages based on specified parameters.

# Actor input Schema

## `keywords` (type: `array`):

🎯 The words that power your search! Add one or more keywords (e.g. \['handmade jewelry']) and the actor finds public Etsy pages matching them, then 📧 extracts any email addresses it finds. 💡 Tip: more specific keywords = more targeted leads.

## `platform` (type: `string`):

📱 The site to scrape. Currently locked to Etsy — more platforms coming soon! 🚀

## `location` (type: `string`):

🗺️ Optional geo-targeting! Add a city or region (e.g. 'London' 🇬🇧, 'New York' 🗽, 'Dubai' 🏙️) to narrow results to pages mentioning that place. ✨ Leave empty to search the whole globe 🌍.

## `emailDomains` (type: `array`):

🎛️ Keep only emails from the domains you care about — type as many as you like! ✍️ Popular picks: 📮 @gmail.com · 📨 @outlook.com · 💌 @hotmail.com · 💜 @yahoo.com · ☁️ @icloud.com · 📬 @aol.com · 🔒 @protonmail.com · 📥 @live.com · 📧 @gmx.com · 🟡 @yandex.com · 📗 @zoho.com. 🏢 Custom/business domains work too — e.g. @yourcompany.com. 🕳️ Leave empty to collect emails from ALL domains. 💡 Adding a domain also sharpens the search 🎯.

## `maxEmails` (type: `integer`):

🎚️ How many emails to collect per keyword before moving on. ⚡ Higher = more leads but longer runs. Default is 10 ✅ (range 1 – 100,000).

## `engine` (type: `string`):

🔧 The processing engine. Currently 'legacy' 🛡️ — a reliable, battle-tested extraction pipeline. More engines on the roadmap! 🚧

## `proxyConfiguration` (type: `object`):

🌐 Control how the actor connects to the internet. 🆓 Leave it empty and the actor auto-selects the best proxy for reliable results. 🔄 On any failed response it rotates the connection and retries up to 3× automatically. 🧠 Advanced users can plug in custom proxies here.

## Actor input object example

```json
{
  "keywords": [
    "handmade jewelry"
  ],
  "platform": "Etsy",
  "location": "",
  "emailDomains": [
    "@gmail.com"
  ],
  "maxEmails": 10,
  "engine": "legacy",
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}
```

# 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 = {
    "keywords": [
        "handmade jewelry"
    ],
    "emailDomains": [
        "@gmail.com"
    ],
    "proxyConfiguration": {
        "useApifyProxy": false
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("api-empire/etsy-email-scraper").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 = {
    "keywords": ["handmade jewelry"],
    "emailDomains": ["@gmail.com"],
    "proxyConfiguration": { "useApifyProxy": False },
}

# Run the Actor and wait for it to finish
run = client.actor("api-empire/etsy-email-scraper").call(run_input=run_input)

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

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

```

## CLI example

```bash
echo '{
  "keywords": [
    "handmade jewelry"
  ],
  "emailDomains": [
    "@gmail.com"
  ],
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}' |
apify call api-empire/etsy-email-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,api-empire/etsy-email-scraper"
        }
    }
}

```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/2ilCvA85JPmBxYYpq/builds/MkeDOPcV0BFlcIj27/openapi.json