# Taobao Email Scraper (`email_scraper/taobao-email-scraper`) Actor

Taobao Email Scraper extracts publicly available email addresses from Taobao-related search results using targeted keywords, locations, and custom email domains. Build structured lead lists with emails, titles, descriptions, and URLs for prospecting, market research, and business intelligence.

- **URL**: https://apify.com/email\_scraper/taobao-email-scraper.md
- **Developed by:** [Email Scraper](https://apify.com/email_scraper) (community)
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.49 / 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.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

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

### Taobao Email Scraper – Overview

**Taobao Email Scraper** is an Apify Actor designed to discover publicly listed email addresses associated with Taobao search results using targeted keywords and optional location filters. It is useful for lead generation, market research, business prospecting, contact discovery, and building structured Taobao contact datasets.

Instead of searching for a single email manually, **Taobao Email Scraper** lets you provide multiple search terms and email domain suffixes. The Actor processes each keyword and domain combination separately and extracts matching email addresses together with useful contextual information such as the result title, description, and source URL.

> 📌 **Taobao Email Scraper at a glance**
>
> - Search Taobao-related results using custom keywords
> - Extract publicly displayed email addresses
> - Filter by country, state, or city
> - Search specific email domains such as `@gmail.com`
> - Exclude unwanted words or phrases
> - Set a maximum email target
> - Remove duplicate email addresses
> - Receive structured lead records in an Apify dataset

The easiest workflow is simple: enter your keywords, optionally add a location, choose the email domains you want to find, set your target, and start the Actor.

***

### 🔍 Taobao Email Scraper – Key Features

**Taobao Email Scraper** combines keyword discovery with email-domain targeting so you can build focused contact lists rather than collecting unrelated search results.

#### 🎯 Keyword-Based Discovery

Use one or many keywords to describe the businesses, professionals, products, or audiences you want to research.

Examples include:

- Shop Owner
- Fashion Store
- Electronics Seller
- Beauty Products
- Fitness Equipment
- Clothing Supplier
- Taobao Seller
- Online Store
- Wholesale Supplier

Using several related search phrases can expand coverage and discover different types of publicly available Taobao contacts.

#### 🌎 Location Filtering

The optional location field lets you narrow searches geographically.

You can enter a country, state, region, or city manually, depending on the type of research you are performing.

Examples:

- China
- Shanghai
- Beijing
- Guangzhou
- United States
- New York
- London

Leaving the location empty creates a broader search without a geographic term.

#### 📧 Custom Email Domain Filtering

**Taobao Email Scraper** does not restrict you to one email provider. You can provide the domain suffixes you want to search for.

Examples:

- `@gmail.com`
- `@yahoo.com`
- `@outlook.com`
- `@hotmail.com`
- `@icloud.com`
- `@company.com`

This is especially useful when a campaign requires a particular provider or when researching business-domain contacts.

#### 🚫 Exclude Words and Phrases

The exclude-word filter helps remove unwanted results before an email is collected.

For example, you can exclude:

- crypto
- onlyfans
- gambling
- unrelated business terms

Single words are matched as whole words, while phrases can be matched as phrases. Matching is case-insensitive.

> ✅ **Why this matters**
>
> - More focused search results
> - Better control over lead relevance
> - Less unwanted data in the final dataset
> - Useful filtering without changing your original keywords

***

### 📊 Taobao Email Scraper – What Data You Can Extract

Each collected result is stored as a structured dataset record. This allows the extracted information to be viewed inside Apify and processed by downstream workflows.

> 📦 **Primary output fields**
>
> - **keyword** — The keyword associated with the discovered result.
> - **title** — The title of the source search result.
> - **description** — The available result description or snippet containing contextual information.
> - **url** — The source URL associated with the result.
> - **email** — The discovered email address matching the selected domain.
> - **network** — Identifies the source network as Taobao.com in the generated record.

The most important field is `email`, but the surrounding title, description, keyword, and URL provide useful context for evaluating and organizing leads.

#### 🧾 Example Output

```json
{
  "network": "Taobao.com",
  "keyword": "Shop Owner",
  "title": "Example Taobao Shop",
  "description": "Example business information and contact email: seller@example.com",
  "url": "https://example.taobao.com/",
  "email": "seller@example.com"
}
```

The exact values depend on what information is publicly available in the search results discovered during your run.

> 💡 **Structured data benefit**
>
> The output is organized into fields rather than a block of unstructured text, making it easier to review, filter, export, analyze, or use in another data workflow.

***

### ⚙️ Taobao Email Scraper – How to Use It

Using **Taobao Email Scraper** requires only a few input settings.

#### 1. Add Keywords

Enter one or more search keywords.

For broader coverage, use related variations instead of relying on a single generic phrase.

For example, instead of:

```text
Fitness
```

consider:

```text
Fitness Coach
Fitness Trainer
Fitness Influencer
Online Fitness Coach
Fitness Equipment Seller
```

This gives the Actor several search intents to work with.

#### 2. Add an Optional Location

Enter a country, city, state, or other geographic term when location-specific research is needed.

Leave it empty when you want broader discovery.

#### 3. Choose Email Domains

Add the email suffixes you want to target.

For example:

```text
@gmail.com
@yahoo.com
@outlook.com
```

The Actor uses these domain filters when searching for matching email addresses.

#### 4. Set the Maximum Email Target

The `maxEmails` input controls the collection target for each keyword + domain combination.

For example, with:

```text
3 keywords
2 domains
20 max emails
```

the Actor works through six keyword/domain combinations, with a target of up to 20 addresses for each combination, subject to the availability of qualifying public results.

#### 5. Add Exclude Words

Use `excludeWords` when you want to skip results whose descriptions contain specified unwanted terms or phrases.

#### 6. Start the Actor

After entering the inputs, start the run in Apify. Results are added incrementally to the dataset as they are discovered.

***

### 🔎 How to Scrape Taobao Emails Using Keywords and Domains

The most practical way to use **Taobao Email Scraper** is to combine precise keywords with multiple relevant email domains.

Suppose you want contacts related to fashion businesses. A broader configuration could be:

```json
{
  "keywords": [
    "Fashion Shop Owner",
    "Clothing Seller",
    "Fashion Supplier",
    "Online Clothing Store"
  ],
  "location": "China",
  "customDomains": [
    "@gmail.com",
    "@yahoo.com",
    "@outlook.com"
  ],
  "maxEmails": 20,
  "excludeWords": [
    "crypto"
  ]
}
```

This configuration creates multiple search combinations instead of depending on one query.

> 🚀 **Coverage strategy**
>
> - Use specific business-related keywords.
> - Add several closely related search phrases.
> - Combine multiple email domains when appropriate.
> - Use location only when geographic targeting is important.
> - Remove irrelevant categories with exclude words.
> - Increase the target when deeper discovery is required.

A broader configuration may discover more potential addresses, while a narrower configuration can produce a more focused dataset.

***

### 🧩 Can You Search Specific Cities or Countries?

Yes. **Taobao Email Scraper** supports an optional `location` field.

The location value is inserted into the search criteria, allowing you to focus discovery around a geographic term.

This can be helpful for:

- Local business research
- Regional market analysis
- Supplier discovery
- City-specific prospecting
- Country-specific contact research

For example:

```json
{
  "keywords": ["Shop Owner", "Fashion Seller"],
  "location": "Shanghai"
}
```

For broader discovery, simply leave `location` empty.

***

### 📥 Input

The Actor's input configuration provides five user-facing fields.

| Input           | Type    | Required | Description                                          |
| --------------- | ------- | -------- | ---------------------------------------------------- |
| `keywords`      | Array   | Yes      | Keywords or queries used for discovery               |
| `location`      | String  | No       | Country, state, city, or region filter               |
| `customDomains` | Array   | No       | Email domain suffixes to target                      |
| `maxEmails`     | Integer | No       | Maximum target for each keyword + domain combination |
| `excludeWords`  | Array   | No       | Words or phrases used to skip unwanted descriptions  |

#### `keywords`

Enter the topics, business types, roles, or search phrases you want to investigate.

Example:

```json
"keywords": [
  "Shop Owner",
  "Beauty Store",
  "Clothing Seller"
]
```

This is the only required input.

#### `location`

Optional geographic filtering.

Example:

```json
"location": "Beijing"
```

Use an empty string when no location restriction is required.

#### `customDomains`

Defines the email suffixes to search for.

Example:

```json
"customDomains": [
  "@gmail.com",
  "@yahoo.com",
  "@outlook.com"
]
```

#### `maxEmails`

Accepts an integer from **1 to 10,000** in the Actor input configuration.

Example:

```json
"maxEmails": 50
```

The target is applied to individual keyword + domain combinations rather than functioning as one shared target across the entire keyword/domain matrix.

> ⚠️ **Important**
>
> A requested target is not a guarantee that the Actor will find that many addresses. Results depend on the amount of publicly discoverable, qualifying information available for your selected keywords, domains, and location.

#### `excludeWords`

Provide words or phrases that should cause a result description to be skipped.

Example:

```json
"excludeWords": [
  "crypto",
  "onlyfans"
]
```

Leave the array empty to avoid exclusion filtering.

***

### 📤 Output

The results are stored in an Apify dataset and presented in a table-oriented format.

A typical record contains:

```json
{
  "keyword": "Shop Owner",
  "title": "Example Shop",
  "description": "Business description with seller@example.com",
  "url": "https://example.taobao.com/",
  "email": "seller@example.com"
}
```

The generated record also contains the source network identifier.

> 📋 **Dataset view**
>
> - Keyword
> - Title
> - Description
> - URL
> - Email
>
> This structure makes the dataset suitable for inspection, filtering, lead organization, and further processing within Apify workflows.

***

### 💼 Taobao Email Scraper – Use Cases

**Taobao Email Scraper** can support several types of research and contact-discovery workflows where publicly available business email information is relevant.

#### 📈 Lead Generation

Discover publicly listed email addresses associated with targeted Taobao-related search terms.

Useful for creating research-oriented prospect lists based on:

- Business category
- Seller type
- Product niche
- Professional role
- Location

#### 🏪 Supplier and Seller Research

Search for categories such as wholesale suppliers, shop owners, product sellers, manufacturers, or online stores.

The resulting records include source context so you can review the discovered leads.

#### 🔬 Market Research

Researchers can search different business categories and locations to understand publicly discoverable market participants.

For example:

```text
Electronics Seller
Fashion Supplier
Beauty Store
Home Decor Shop
```

#### 🎯 Niche Prospecting

Use specialized keywords to identify contacts in narrowly defined industries.

Instead of using broad terms, combine several highly relevant search phrases to improve targeting.

#### 📊 Contact Dataset Building

Because the Actor produces structured records, collected information can serve as the starting point for a larger research dataset.

You can organize results by keyword, domain, URL, or email address.

> 🔐 **Responsible use**
>
> Only use publicly available information for legitimate purposes. Respect applicable privacy, data-protection, anti-spam, and platform rules when processing or contacting discovered addresses.

***

### 💰 Pricing and Result Limits

The provided Actor configuration does **not** specify a fixed monetary price for a run or a fixed per-email price.

The Actor does contain a free-user result limitation:

- Free users are limited to **100 emails maximum**.
- Paid users do not have the Actor's free-tier result restriction.
- The requested `maxEmails` value can be capped by the free-user limit.
- A larger target does not guarantee additional results if qualifying public data is unavailable.

> 💡 **Cost-control tip**
>
> Smaller targets generally finish sooner and can reduce unnecessary run usage. Start with a focused set of keywords and domains, evaluate the results, then expand the configuration when additional coverage is needed.

Actual Apify platform charges may depend on your account, current platform pricing, and resource consumption rather than a fixed price stated in this Actor configuration.

***

### 🛠️ Tips and Best Practices

For stronger results with **Taobao Email Scraper**, focus on search quality rather than simply increasing the maximum target.

- Use specific keywords instead of extremely broad terms.
- Create keyword variations that describe the same niche from different angles.
- Combine several relevant email domains.
- Use a location when geographic targeting matters.
- Remove irrelevant categories with `excludeWords`.
- Start with a moderate `maxEmails` value and expand after reviewing results.
- Broaden the location when a highly specific region produces sparse results.
- Remove unnecessary geographic filtering when maximum coverage is the priority.

#### ⏱️ Large Searches

Wide configurations can take longer because the Actor may need to process many keyword and domain combinations.

When running a large search, allow an appropriate run timeout in Apify's run options.

#### 📉 When Results Are Below Your Target

A lower-than-requested result count does not necessarily indicate an error.

Possible reasons include:

- Few matching public results
- Limited availability of the selected email domain
- Keywords that are too narrow
- An overly specific location
- Exclude words removing relevant snippets
- Search results no longer containing qualifying contact information

Try related keywords, additional domains, or a broader location when appropriate.

***

### ❓ Frequently Asked Questions

#### What is Taobao Email Scraper?

**Taobao Email Scraper** is an Apify Actor that searches for publicly available email addresses associated with Taobao-related search results using custom keywords, email-domain filters, optional locations, and exclusion terms.

#### How many emails can Taobao Email Scraper collect?

The input supports a `maxEmails` value from 1 to 10,000. The target is applied independently to each keyword + domain combination. Actual results depend on qualifying public information available for the search.

#### Can I search for Gmail emails on Taobao?

Yes. Add `@gmail.com` to the `customDomains` input. You can also specify other domain suffixes such as `@yahoo.com` and `@outlook.com`.

#### Can I use my own company email domain?

Yes. You can provide a custom domain suffix such as:

```text
@company.com
```

This allows searches to target that email domain.

#### Can I search Taobao contacts by city?

Yes. Enter a city, country, state, or region in the `location` field.

#### Can I use multiple keywords?

Yes. The `keywords` input is an array, so you can provide multiple search terms in one Actor run.

#### What data does Taobao Email Scraper return?

The dataset primarily contains `keyword`, `title`, `description`, `url`, and `email`, with the generated record also identifying the source network.

#### Why did my run return fewer emails than requested?

A target is a maximum rather than a guarantee. The Actor can only collect qualifying email addresses that are publicly discoverable for the selected search combinations.

#### Does Taobao Email Scraper remove duplicates?

Yes. The Actor tracks previously discovered email addresses so the same email is not repeatedly added as a new result during the collection process.

#### What can I do when results are sparse?

Try adding related keywords, adding additional email domains, removing an overly restrictive location, or reducing the number of excluded terms.

#### Is there a free-user limit?

Yes. The Actor applies a **100-email maximum for free users**. Paid users are not subject to that specific Actor-level free result restriction.

***

### ✅ Final Notes

**Taobao Email Scraper** is built for structured discovery of publicly available Taobao-related email contacts from targeted searches. Its combination of keyword targeting, location filtering, domain selection, exclusion rules, deduplication, and structured datasets makes it suitable for repeatable contact research and lead-discovery workflows.

For best results, begin with focused keywords and several closely related search variations. Review the initial dataset, then refine your keywords, domains, location, and exclusion terms based on the quality of the returned results.

> 📌 **Remember**
>
> - More targeted keywords can improve relevance.
> - More domain variations can increase coverage.
> - Broader locations can help when results are sparse.
> - Exclusion terms can remove unwanted categories.
> - `maxEmails` controls the collection target but cannot guarantee availability.

- contact me by email : <alphascraper69@gmail.com>

# Actor input Schema

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

A list of keywords or queries to search for.

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

Optional country, state or city used to narrow the search. Leave it empty to search without a geographic filter.

## `customDomains` (type: `array`):

List of custom email domains

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

How many addresses each search keyword + domain suffix combination may collect before the finder moves on to the next one. This is a per-combination target, not a run-wide total: with 3 keyword and 2 Domains and a limit of 20, the run works through all 6 combinations and aims for up to 20 addresses in each, so up to 120 overall. Lower values finish sooner and cost less; higher values dig deeper but never guarantee a fuller result, since the run can only find what is publicly listed.

## `excludeWords` (type: `array`):

Words or phrases you do not want to see.

## Actor input object example

```json
{
  "keywords": [
    "Shop Owner"
  ],
  "location": "",
  "customDomains": [
    "@gmail.com"
  ],
  "maxEmails": 10,
  "excludeWords": []
}
```

# Actor output Schema

## `dataset` (type: `string`):

No description

# 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": [
        "Shop Owner"
    ],
    "location": "",
    "customDomains": [
        "@gmail.com"
    ],
    "excludeWords": []
};

// Run the Actor and wait for it to finish
const run = await client.actor("email_scraper/taobao-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": ["Shop Owner"],
    "location": "",
    "customDomains": ["@gmail.com"],
    "excludeWords": [],
}

# Run the Actor and wait for it to finish
run = client.actor("email_scraper/taobao-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": [
    "Shop Owner"
  ],
  "location": "",
  "customDomains": [
    "@gmail.com"
  ],
  "excludeWords": []
}' |
apify call email_scraper/taobao-email-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,email_scraper/taobao-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/mRSAo30Xo25cstqtJ/builds/r0VgHQOAI399w1uui/openapi.json