# Etsy Email Scraper (`solid-scraper/etsy-email-scraper`) Actor 📧 Etsy Email Scraper extracts business contact emails from Etsy listings fast—by keyword and location—so you can grow your leads, outreach, and sales pipelines with targeted prospects. 🚀 Perfect for marketers & agencies. - **URL**: https://apify.com/solid-scraper/etsy-email-scraper.md - **Developed by:** [SolidScraper](https://apify.com/solid-scraper) (community) - **Categories:** Lead generation, E-commerce, Automation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $2.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/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. 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. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/integrations/mcp.md). If your project is in a different language, use 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 an Apify actor that helps you scrape emails from Etsy using your chosen keywords and filters. If you’re looking for an **Etsy email scraper**, an **Etsy seller email extractor**, or an **Etsy seller outreach email list**, this tool is built to find contact emails mentioned in publicly available Etsy bios and posts related to your keywords. ✅ Whether you’re a marketer, data analyst, or researcher, it supports lead generation and research workflows by saving you hours of manual email hunting—especially when you need an **Etsy bulk email scraper** style workflow at scale. --- ### 🚀 Why choose Etsy Email Scraper? | Feature | Benefit | | --- | --- | | ✅ **Keyword-driven email discovery** | Uses your `keywords` to find relevant contact emails in Etsy bios and posts | | ✅ **Custom email-domain targeting** | Helps you focus results using `customDomains` (e.g. `@gmail.com`) | | ✅ **Proxy configuration support** | Works with `proxyConfiguration` to improve reliability for bulk scraping | | ✅ **Engine choices** | Choose between `engine: cost-effective` and `engine: legacy` based on your reliability/cost preference | | ✅ **Structured JSON output per email** | Each found email is pushed with consistent fields for easy importing | | ✅ **Scale controls** | Use `maxEmails` to cap collection and control runtime/cost | --- ### 🔍 Key features - 🧠 **Keyword + domain email targeting**: Finds emails from Etsy bios and posts that match your `keywords`, then filters by `customDomains`. - 🌐 **Platform-scoped scraping**: Uses `platform` set to **Etsy** for focused extraction. - 🎯 **Hard stop with `maxEmails`**: Stops once the requested number of emails is reached to help control scraping time and cost. - 🛡️ **Resilient collection with retries/fallbacks**: Includes retry and fallback behavior for better continuity when results are limited. - 📦 **Consistent dataset rows**: Pushes a structured record for every found email (including context like title/description and the page URL). - 💾 **Progress persistence**: Saves progress continuously so you can resume without losing collected results. - ⚙️ **Engine selection for different needs**: Switch between `cost-effective` and `legacy` engines based on your balance of speed vs reliability. --- ### 📝 Input Provide input via an `input.json` file. Example structure: ```json { "keywords": ["founder", "marketing"], "location": "", "platform": "Etsy", "customDomains": ["@gmail.com"], "maxEmails": 20, "engine": "legacy", "proxyConfiguration": {} } ```` #### Input Fields | Field | Required | Description | | --- | --- | --- | | `keywords` | ✅ Yes | A list of keywords to search for (used to find emails from Etsy bios and posts related to your keywords). | | `location` | ❌ No | Location to filter search results. Leave it empty to not apply a location filter. | | `platform` | ❌ No | Select platform. This actor supports `Etsy`. | | `customDomains` | ❌ No | List of custom email domains to target (for example `@gmail.com`). | | `maxEmails` | ❌ No | Maximum number of emails to collect. The actor stops once this limit is reached. Higher values can take longer and still don’t guarantee reaching the exact number. | | `engine` | ❌ No | Choose scraping engine. Use `cost-effective` for faster, cheaper scraping with residential proxies; use `legacy` for a more traditional approach that can be more reliable but slower/expensive. | | `proxyConfiguration` | ❌ No | Configure proxies for this Actor (Apify Proxy / custom proxy settings depending on your workspace setup). | *** ### 📦 Output The actor saves each found email as a JSON row in the dataset (via `Actor.push_data`). Each row includes context about why/how the email was found. Example output row: ```json [ { "network": "Etsy.com", "keyword": "founder", "title": "Example Etsy result title", "description": "Example description text that contains an email like name@gmail.com", "url": "https://example.com/etsy-result-url", "email": "name@gmail.com", "proxyGroups": [ "your-proxy-groups" ] } ] ``` #### Output Fields | Field | Type | Description | | --- | --- | --- | | `network` | string | Source network label. For this actor it’s always `Etsy.com`. | | `keyword` | string | The keyword currently being used when the email was discovered. | | `title` | string | Title text associated with the scraped result. | | `description` | string | Description text where the actor extracts emails (as found in the scraped content). | | `url` | string | URL of the scraped result page where the email context came from. | | `email` | string | The extracted email address. | | `proxyGroups` | array | Proxy groups used for the run (as provided/selected in proxy configuration). | *** ### How to use Etsy Email Scraper (via Apify Console) 1. **Open Apify Console**\ Go to [console.apify.com](https://console.apify.com) and sign in. 2. **Find the actor**\ Search for **Etsy Email Scraper** in the Actors marketplace. 3. **Go to the INPUT section**\ Use the built-in form to enter your `keywords`, and (optionally) `customDomains` and `location`. 4. **Set targeting & limits**\ Enter your `keywords` (required) and choose a `maxEmails` cap to control runtime and dataset size. 5. **Choose an engine (optional but recommended)**\ Pick `engine: legacy` for a more traditional approach or `engine: cost-effective` for faster, residential-proxy-based scraping. 6. **Configure proxies (optional)**\ If you need proxy support, fill in `proxyConfiguration`. 7. **Run the actor**\ Click **Run**. During execution, you’ll see logs as pages are fetched and emails are found/pushed to the dataset. 8. **Open results & export**\ After completion, go to the **OUTPUT** tab, download the dataset, and export to JSON/CSV as supported by Apify. No coding required—get an **Etsy email scraper** workflow running in minutes with reliable, structured email extraction from publicly available sources. *** ### 🧰 Advanced features & SEO optimization - 🔎 **Engineered for Etsy lead generation**: Built specifically around “Etsy email scraper” workflows like extracting emails relevant to your keywords and domains. - 🧭 **Result-quality steering with `customDomains`**: Helps your **Etsy seller email extractor** output match the inbox providers you care about (e.g. `@gmail.com`). - 🧱 **Reliability-oriented scraping options**: Engine selection and proxy configuration are designed to improve consistency when scraping at scale (including retries/fallbacks). - 🧾 **Clear, structured dataset rows**: Each email is stored with `keyword`, `title`, `description`, and `url`, making “email extraction from Etsy listings” easier to analyze. *** ### 🎯 Best use cases - 📈 **B2B marketing teams**: Build an **Etsy seller outreach email list** faster by harvesting emails connected to your niche keywords. - 🧑‍💼 **Sales & lead gen**: Turn research into action by collecting contact emails from Etsy bios/posts for targeted prospecting. - 🔍 **Market researchers**: Compare who is reachable in a niche by analyzing email coverage across keywords and domains. - 🎓 **Agency and consultants**: Produce an **Etsy lead generation email scraper** dataset for client campaigns without manual copy-paste work. - 🗂️ **Data analysts**: Clean and enrich datasets using consistent fields like `keyword`, `email`, and source `url`. - 💻 **Developers and automation pipelines**: Integrate the dataset output into CRM imports or downstream processing for **Etsy bulk email scraper** style jobs. - ✉️ **Email marketing operations**: Start segmentation earlier by filtering by email domains using `customDomains`. *** ### 🔧 Technical specifications - **Supported Input Formats** - ✅ JSON input with fields: `keywords`, `location`, `platform`, `customDomains`, `maxEmails`, `engine`, `proxyConfiguration` - ✅ `keywords` is required - **Proxy Support** - ✅ `proxyConfiguration` supported - ✅ Engine supports `cost-effective` (residential proxies) and `legacy` (more traditional approach) - **Retry Mechanism** - ✅ Includes retries and fallback behavior for more resilience when results are limited - **Dataset Structure** - ✅ Each found email is pushed as a JSON row with: `network`, `keyword`, `title`, `description`, `url`, `email`, `proxyGroups` - **Rate Limits & Performance** - ✅ Performance depends on search size and `maxEmails` - ✅ Large searches/high email limits may take longer - **Limitations** - ❌ Emails are only extracted when they appear in the publicly available places the actor is designed to read (Etsy bios/posts related to your keywords). - ❌ Reaching `maxEmails` is not guaranteed—availability depends on what’s publicly present. *** ### ❓ FAQ #### Can I scrape emails from Etsy using keywords? ✅ Yes. Etsy Email Scraper uses your `keywords` to discover emails from Etsy bios and posts related to those keywords. #### How do I target specific inbox providers (like Gmail)? You can use `customDomains` to filter emails by domain (for example `@gmail.com`). This is helpful for tighter outbound targeting. #### What does `maxEmails` do? `maxEmails` sets a cap on how many emails the actor will collect. The actor stops once the limit is reached, which helps control scraping time and costs. #### Which engine should I choose: cost-effective or legacy? Choose `engine: cost-effective` for faster, cheaper scraping with residential proxies, and choose `engine: legacy` for a more traditional approach that may be more reliable but slower/expensive. #### Does it support proxies? Yes. You can configure proxies using `proxyConfiguration`, and the actor also supports selecting an `engine` mode that aligns with different proxy approaches. #### Is the output saved automatically while it runs? Yes. Each extracted email row is pushed into the dataset as it’s found, and progress is persisted continuously. #### Can I resume after an interrupted run? The actor saves progress (including a stored list of seen emails and a cursor), which helps you avoid starting from zero. #### Is this actor legal-compliance friendly? ✅ The tool is designed to collect data only from **publicly accessible sources**. However, compliance (GDPR/CCPA, spam regulations, and Etsy/platform policies) is your responsibility. *** ### 🤝 Support & feature requests If you’re using **Etsy Email Scraper** (including as an **Etsy seller email extractor** or **Etsy email finder**) and want help or improvements, we’d love to hear from you. - 💡 **Feature Requests**: Examples include CSV export enhancements, additional filtering options, or CRM-focused output formats for easier automation. - 📧 **Contact**: Email us at Your feedback helps shape the roadmap for Etsy Email Scraper, including future improvements for **Etsy bulk email scraper** workflows. *** ### *Etsy Email Scraper* — final thoughts *With this SEO-optimized Etsy email scraper workflow, you can collect structured contact emails from Etsy bios/posts at scale without manual scraping.*\ *Start your next outreach dataset with Etsy Email Scraper and move from research to results faster.* *** ### Disclaimer This tool only accesses **publicly accessible sources**. It does not access private profiles, authenticated data, or password-protected pages. Legal compliance (including GDPR, CCPA, spam regulations, and platform terms) is your responsibility. For data removal requests, contact . Please use Etsy Email Scraper responsibly, ethically, and for legitimate purposes only. # Actor input Schema ## `keywords` (type: `array`): A list of keywords to search for. ## `location` (type: `string`): Location to filter search results. ## `platform` (type: `string`): Select platform. ## `customDomains` (type: `array`): List of custom email domains ## `maxEmails` (type: `integer`): Maximum number of emails to collect. The scraper will stop once this limit is reached. Setting a higher limit allows for more potential results but doesn't guarantee reaching that number. This helps save costs by controlling scraping time. ## `engine` (type: `string`): Choose scraping engine. 🚀 Cost Effective (New): Uses residential proxies with async requests for faster, cheaper scraping. 🔧 Legacy: Uses GOOGLE\_SERP proxy with traditional selectors - more reliable but slower and more expensive. ## `proxyConfiguration` (type: `object`): Configure proxies for this Actor. ## Actor input object example ```json { "keywords": [ "founder", "marketing" ], "location": "", "platform": "Etsy", "customDomains": [ "@gmail.com" ], "maxEmails": 20, "engine": "legacy" } ``` # 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 '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "keywords": [ "founder", "marketing" ], "location": "", "customDomains": [ "@gmail.com" ] }; // Run the Actor and wait for it to finish const run = await client.actor("solid-scraper/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 '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "keywords": [ "founder", "marketing", ], "location": "", "customDomains": ["@gmail.com"], } # Run the Actor and wait for it to finish run = client.actor("solid-scraper/etsy-email-scraper").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 '{ "keywords": [ "founder", "marketing" ], "location": "", "customDomains": [ "@gmail.com" ] }' | apify call solid-scraper/etsy-email-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=solid-scraper/etsy-email-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Etsy Email Scraper", "description": "📧 Etsy Email Scraper extracts business contact emails from Etsy listings fast—by keyword and location—so you can grow your leads, outreach, and sales pipelines with targeted prospects. 🚀 Perfect for marketers & agencies.", "version": "0.0", "x-build-id": "BMfEwLxXZevmNsiTm" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/solid-scraper~etsy-email-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-solid-scraper-etsy-email-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/solid-scraper~etsy-email-scraper/runs": { "post": { "operationId": "runs-sync-solid-scraper-etsy-email-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/solid-scraper~etsy-email-scraper/run-sync": { "post": { "operationId": "run-sync-solid-scraper-etsy-email-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "keywords" ], "properties": { "keywords": { "title": "Keywords", "type": "array", "description": "A list of keywords to search for.", "default": [ "founder", "marketing" ], "items": { "type": "string" } }, "location": { "title": "Location", "type": "string", "description": "Location to filter search results.", "default": "" }, "platform": { "title": "Platform", "enum": [ "Etsy" ], "type": "string", "description": "Select platform.", "default": "Etsy" }, "customDomains": { "title": "Custom Email Domains", "type": "array", "description": "List of custom email domains", "default": [ "@gmail.com" ], "items": { "type": "string" } }, "maxEmails": { "title": "Max Emails", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Maximum number of emails to collect. The scraper will stop once this limit is reached. Setting a higher limit allows for more potential results but doesn't guarantee reaching that number. This helps save costs by controlling scraping time.", "default": 20 }, "engine": { "title": "Engine", "enum": [ "cost-effective", "legacy" ], "type": "string", "description": "Choose scraping engine. 🚀 Cost Effective (New): Uses residential proxies with async requests for faster, cheaper scraping. 🔧 Legacy: Uses GOOGLE_SERP proxy with traditional selectors - more reliable but slower and more expensive.", "default": "legacy" }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Configure proxies for this Actor." } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```