# Tiktok Email Scraper (`solid-scraper/tiktok-email-scraper`) Actor 📧 TikTok Email Scraper extracts verified email addresses from TikTok profiles and links—fast, accurate, and built for prospecting. 🚀 Perfect for agencies, creators, and sales teams to find leads instantly and grow outreach. 🔍 - **URL**: https://apify.com/solid-scraper/tiktok-email-scraper.md - **Developed by:** [SolidScraper](https://apify.com/solid-scraper) (community) - **Categories:** Lead generation, Social media, 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.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.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/platform/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 ### TikTok Email Scraper 📬 **TikTok Email Scraper** is an Apify actor that **scrapes emails from TikTok using specified keywords and filters**. It helps solve the common problem of spending hours hunting for contact details—so you can quickly build outreach lists. Whether you’re using it as a **TikTok email extractor**, **TikTok email scraper tool**, or **TikTok lead generation email tool**, it’s designed for marketers, recruiters, and researchers who need contact emails at scale—saving you time and manual effort. This actor **extracts emails from publicly available sources** where email addresses appear in TikTok bios and in content related to your keywords. For best results, use focused keywords and set the **email-domain filters** you care about. --- ### Why choose TikTok Email Scraper? | Feature | Benefit | | --- | --- | | ✅ **Keyword-based email discovery** | Uses your keywords to find relevant TikTok profiles and extract matching emails. | | ✅ **Custom email domains filtering** | Targets the email addresses you want (for example, `@gmail.com`) instead of collecting everything. | | ✅ **Reliability with retries and resilience** | Includes retries and fallbacks for resilience when pages don’t return results. | | ✅ **Progress persistence** | Saves progress during execution so you can resume/continue without starting from scratch. | | ✅ **Structured JSON output** | Produces consistent rows you can import into spreadsheets, CRMs, or analytics pipelines. | | ✅ **Scale-friendly controls** | Lets you cap collection using `maxEmails` to control runtime and cost. | --- ### Key features - 🔍 **Keyword-led TikTok email harvesting**: Finds relevant results based on the keywords you provide (e.g. **TikTok outreach email finder** workflows). - 📩 **Email-domain targeting with custom domains**: Extracts emails only for the domains you include in `customDomains` (great for **TikTok business email extraction**). - 🧠 **Email extraction from TikTok bios and posts related to keywords**: Specifically searches where email addresses appear in related profile content. - 🛡️ **Resilient execution with retry logic**: Includes built-in retries/fallback behavior when results are missing. - 💾 **Real-time dataset pushing**: Each discovered email is immediately pushed to the dataset as a structured record. - 🔄 **Pagination with stop conditions**: Stops when it reaches your `maxEmails` limit or when it determines results are no longer productive. - 🌐 **Proxy configuration support**: You can configure proxies via `proxyConfiguration` and also select an `engine`. --- ### Input Provide input via an `input.json` file. Example structure: ```json { "keywords": ["founder", "marketing"], "location": "", "platform": "TikTok", "customDomains": ["@gmail.com"], "maxEmails": 20, "engine": "legacy", "proxyConfiguration": {} } ```` #### Input Fields | Field | Required | Description | | --- | --- | --- | | `keywords` | ✅ | A list of keywords to search for. The scraper uses these keywords to find relevant TikTok profile content where emails may appear. | | `location` | ❌ | Location to filter search results. Leave empty (`""`) for no location filtering. | | `platform` | ❌ | Select platform. This actor supports `"TikTok"` (default is `"TikTok"`). | | `customDomains` | ❌ | List of custom email domains to target. This helps you collect only the emails you want (for example, `@gmail.com`). | | `maxEmails` | ❌ | Maximum number of emails to collect. The actor stops once this limit is reached (range: `1` to `10000`, default: `20`). | | `engine` | ❌ | Choose scraping engine. Currently only `"legacy"` is available. | | `proxyConfiguration` | ❌ | Configure proxies for this Actor (Apify proxy or custom proxy configuration, depending on how you set it in Apify). | *** ### Output The actor saves each discovered email as a JSON row in the dataset (each `Actor.push_data(row)` call pushes one record). Example output row: ```json { "network": "TikTok.com", "keyword": "founder", "title": "Example result title", "description": "Example description text that may include an email address", "url": "https://example.com/", "email": "name@gmail.com", "proxyGroups": ["example-proxy-group-or-config"] } ``` #### Output Fields | Field | Type | Description | | --- | --- | --- | | `network` | string | Always set to `"TikTok.com"` for these results. | | `keyword` | string | The keyword currently being searched when the email was found. | | `title` | string | Title associated with the discovered result. | | `description` | string | Description text associated with the discovered result (where the email was extracted from). | | `url` | string | URL associated with the discovered result. | | `email` | string | The extracted email address. | | `proxyGroups` | array | Proxy group configuration used for the request(s), as provided in the run. | | `error_message` | ❌ | No `error_message` field is produced by this actor’s dataset rows (emails are pushed as records; failures are logged). | You can export the dataset from Apify Console to **JSON or CSV** depending on your workflow. *** ### How to use TikTok Email Scraper (via Apify Console) 1. **Open Apify Console**\ Log in at https://console.apify.com. 2. **Find the actor**\ Search for **TikTok Email Scraper** in the Actors marketplace and open its page. 3. **Go to the INPUT tab / section**\ Use the input form to enter your `keywords` and optional filters like `customDomains` and `maxEmails`. 4. **Set email-domain targeting (recommended)**\ In `customDomains`, add the domains you want to capture (for example, `@gmail.com`) to make your **TikTok contact email scraper** results more actionable. 5. **Configure proxies if needed**\ Adjust `proxyConfiguration` and review the `engine` selection (`"legacy"`). This helps keep runs stable on larger searches. 6. **Click Run**\ Start the actor. During execution, you’ll see logs as pages are processed and emails are discovered and pushed. 7. **Review results in the OUTPUT tab**\ Open the dataset output and inspect the records containing `email`, `keyword`, and source context like `title`, `description`, and `url`. 8. **Export for outreach or analysis**\ Export the dataset to your preferred format (commonly JSON or CSV) for CRM import, outreach automation, or research. No coding required—get automated TikTok email extraction results in minutes. 🚀 *** ### Advanced features & SEO optimization - ✅ **Engine selection for scraping runs**: You can set the `engine` (currently `"legacy"`) based on how you want the actor to run. - 🎯 **Engineered for “TikTok profile email scraper” workflows**: Built to support TikTok lead generation email tool patterns where you refine results using both keywords and `customDomains`. - 🔁 **Resilient multi-page scraping behavior**: Includes retries and stops based on progress and productivity, helping avoid wasting time when results dry up. - 💾 **Persistent progress tracking**: Progress is saved during execution, enabling smoother long runs for **automated TikTok email extraction** use cases. *** ### Best use cases - 📈 **Lead generation for outreach campaigns**: Use **TikTok outreach email finder** workflows to build targeted email lists for founders, marketers, and creators. - 🧠 **Research on creator or brand contact channels**: Extract emails from TikTok bios to study how different niches share contact info. - 🏷️ **Influencer marketing list building**: Find contact emails that match your domain filters to support **TikTok influencer email scraper** style sourcing. - 🤝 **Recruiting and talent sourcing**: Quickly gather contact emails for outreach to candidates who publish contact info publicly. - 🧾 **Sales ops and CRM enrichment**: Automate feeding discovered emails into your CRM with structured dataset records. - 🛠️ **Data analysis pipelines**: Combine extracted `keyword`, `title`, `url`, and `email` to quantify which keyword themes correlate with email availability. - 📬 **Email marketing segmentation**: Target specific mail providers/domains by using `customDomains` for more relevant campaigns. *** ### Technical specifications - **Supported Input Formats** - ✅ `keywords` (required): array of keywords used to discover relevant TikTok profile content - ✅ Optional `location`, `platform` (`"TikTok"`), `customDomains`, `maxEmails`, `engine`, `proxyConfiguration` - **Proxy Support** - ✅ Configurable via `proxyConfiguration` - ✅ Actor supports proxy configuration for more reliable scraping runs - **Retry Mechanism** - ✅ Retries and fallback logic are built in when pages fail to return usable results - **Dataset Structure** - ✅ One dataset record per extracted email with: `network`, `keyword`, `title`, `description`, `url`, `email`, `proxyGroups` - **Rate Limits & Performance** - ✅ Controlled by `maxEmails` (a hard stop once the limit is reached) - ✅ Pagination runs may take longer for larger searches or higher email limits (use smaller `maxEmails` for quick iterations) - **Limitations** - ❌ Emails are only extracted when they appear in publicly available content related to your keywords (not from private or hidden data). *** ### FAQ #### What does the TikTok Email Scraper extract emails from? ✅ It extracts emails from **publicly available sources** where email addresses appear in **TikTok bios and posts related to your keywords**. If a profile doesn’t show an email in those areas, you may get fewer results. #### How do `customDomains` affect results? ✅ `customDomains` acts like an email-domain filter. The actor extracts emails only that match the domains you provide (for example, `@gmail.com`), helping you focus on contacts that fit your outreach requirements. #### Why am I getting low results? ❌ Low results can happen when emails aren’t present in the publicly available content tied to your keywords, or when the domain filters are too narrow. Try broader keywords and add more relevant domains in `customDomains`. #### Can I limit how many emails are collected? ✅ Yes. Use `maxEmails` to stop the run once the actor reaches your desired email count. This helps manage runtime and cost, though it doesn’t guarantee the exact number will always be reached. #### Does this actor save progress during long runs? ✅ Yes. The actor persists progress while it runs, so you don’t lose everything if your job stops or you need to rerun. #### Do I need to set a proxy configuration? ❌ Not always. But if you’re running larger searches or you need improved reliability, configuring `proxyConfiguration` is recommended. The actor also supports `engine` selection. #### Can I use this with the Apify Console and export results? ✅ Yes. Run it in Apify Console, then use the OUTPUT dataset to export your extracted rows (commonly JSON or CSV). #### Is it legal to use this for outreach? ✅ The tool collects data from **publicly accessible sources**, but it’s still your responsibility to comply with applicable laws and platform policies. Use it responsibly for legitimate outreach purposes. *** ### Support & feature requests Want to improve this **TikTok Email Scraper** or request a specific enhancement for your **TikTok email extractor** workflow? 💡 - 💡 **Feature Requests**: Examples include adding more export options, expanding filtering controls, or improving dataset fields for CRM ingestion. - 📧 **Contact**: Email us at . We review feedback and use it to shape upcoming improvements to the TikTok email harvesting software experience. ✅ *** ### Closing CTA / Final thoughts *If you need a reliable, SEO-friendly TikTok Email Scraper for automated TikTok lead generation email tool workflows, this actor is built to help you collect and structure results fast.* Run **TikTok Email Scraper** today and streamline your contact-finding pipeline with less manual work. 🚀 *** ### Disclaimer **This tool only accesses publicly accessible sources**. It does not access private profiles, authenticated data, password-protected pages, or any restricted content. You are responsible for complying with applicable laws (for example, GDPR/CCPA), spam regulations, and the platforms’ terms of service. For data removal requests, contact . Use **TikTok 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": "TikTok", "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/tiktok-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/tiktok-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/tiktok-email-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=solid-scraper/tiktok-email-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Tiktok Email Scraper", "description": "📧 TikTok Email Scraper extracts verified email addresses from TikTok profiles and links—fast, accurate, and built for prospecting. 🚀 Perfect for agencies, creators, and sales teams to find leads instantly and grow outreach. 🔍", "version": "0.0", "x-build-id": "7UpSUa0iAcWTErbZY" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/solid-scraper~tiktok-email-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-solid-scraper-tiktok-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~tiktok-email-scraper/runs": { "post": { "operationId": "runs-sync-solid-scraper-tiktok-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~tiktok-email-scraper/run-sync": { "post": { "operationId": "run-sync-solid-scraper-tiktok-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": [ "TikTok" ], "type": "string", "description": "Select platform.", "default": "TikTok" }, "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": [ "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 } } } } } } } } } } ```