# TikTok Email Scraper - Creator Contact Finder (`ritaya/tiktok-email-scraper`) Actor

Enrich TikTok profiles (followers, likes, bio, region) and extract a contact email from the bio and linked site. No login.

- **URL**: https://apify.com/ritaya/tiktok-email-scraper.md
- **Developed by:** [Zane](https://apify.com/ritaya) (community)
- **Categories:** Lead generation, Social media
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $8.00 / 1,000 profile scrapeds

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

## TikTok Email Scraper - Creator & Profile Contact Finder

**TikTok email scraper** and **creator contact finder**: feed a list of TikTok @handles or
profile URLs, enrich each with **no-login** data (followers, likes, video count, bio,
bioLink, region, verified), and recover a **contact email** from the bio text and the
creator's linked website / Linktree.

Built for **lead generation**, influencer-marketing outreach, sponsorship prospecting and
B2B-to-creator sales. Keywords: tiktok email scraper, tiktok creator email, tiktok profile
scraper, influencer email finder, tiktok lead generation, bulk tiktok contact scraper.

### Why this works without a logged-in account

A public TikTok profile page (`tiktok.com/@handle`) embeds a JSON blob
(`__UNIVERSAL_DATA_FOR_REHYDRATION__`) with the bio, bioLink, follower/like/video counts,
verified flag and region — all readable without an account or the a\_bogus-signed API.
Emails come from the bio text and the bioLink (no login).

Validated live from a US residential IP: profile enrichment is reliable; bio/linked-site
email recovery lands a real creator email for a meaningful share of profiles (the rest
expose only social links or no public email).

> **Scope:** this is the URL/handle-list build. Discovery-by-niche on TikTok requires the
> a\_bogus-signed search/hashtag API (out of scope here); bring your handle list, or resolve
> handles from the YouTube/cross-platform actors in the family.

### Input

| field | meaning |
|---|---|
| `profileUrls` | TikTok profile URLs (`https://www.tiktok.com/@handle`) |
| `usernames` | bare `@handles` / usernames (merged with the URL list) |
| `minFollowers` | drop profiles below this follower count (lead quality filter) |
| `scrapeEmails` | recover an email from bio + linked site (default true) |
| `concurrency` | profiles processed in parallel (default 5) |
| `proxyConfiguration` | residential proxy recommended; TikTok rate-limits datacenter IPs |

### Output (one item per profile)

```json
{
  "handle": "garyvee", "nickname": "GaryVee",
  "profileUrl": "https://www.tiktok.com/@garyvee",
  "followers": 15400000, "following": 284, "likes": 368800000, "videoCount": 6325,
  "verified": true, "region": "US",
  "bio": "Creator and CEO of @veefriends ...",
  "bioLink": "http://veefriends.com/comics",
  "emails": ["team@veefriends.com"]
}
```

### Pricing (PAY\_PER\_EVENT)

Register in the Apify console (names must match `Actor.charge`). Calibrated against measured
platform cost (~$0.004/profile with residential proxy) and competitor prices:

| event | suggested price | when |
|---|---|---|
| `profile-scraped` | $0.008 | every profile returned |
| `email-found` | $0.03 | only when an email is recovered |

Effective ~$0.017/profile at a ~30% email hit rate — mid-market (below jurassic\_jove /
exporter24 at ~$0.02, above the bargain scraper-mind at $0.0025). Even a no-email profile
nets positive at $0.008.

### Run locally

```bash
mkdir -p storage/key_value_stores/default
cp .actor/input.example.json storage/key_value_stores/default/INPUT.json
APIFY_LOCAL_STORAGE_DIR="$PWD/storage" \
  uv run --with apify --with "httpx[http2]" python -m src.main
```

Pass `"proxyConfiguration": {"useApifyProxy": false}` to go direct from a residential machine.

### Deploy

```bash
apify push
```

### Roadmap

- **Discovery** (Path B): a\_bogus-signed search/hashtag to find creators by niche.
- Family: shares the enrich→email engine with the YouTube creator-email actor; an Instagram
  build needs a logged-in session (Instagram gates profile data) and is a separate effort.

# Actor input Schema

## `profileUrls` (type: `array`):

TikTok profile URLs (https://www.tiktok.com/@handle). One per item.

## `usernames` (type: `array`):

Alternatively, bare @handles or usernames (e.g. garyvee). Merged with the URL list.

## `minFollowers` (type: `integer`):

Drop profiles below this follower count (0 = no filter). Quality filter for lead lists.

## `scrapeEmails` (type: `boolean`):

Recover a contact email from the bio text and the creator's bioLink / Linktree (best-effort, no login).

## `concurrency` (type: `integer`):

Number of profiles processed in parallel (1-20).

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

Residential proxy strongly recommended; TikTok rate-limits datacenter IPs.

## Actor input object example

```json
{
  "profileUrls": [
    "https://www.tiktok.com/@garyvee"
  ],
  "minFollowers": 0,
  "scrapeEmails": true,
  "concurrency": 5,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ],
    "apifyProxyCountry": "US"
  }
}
```

# 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 = {
    "profileUrls": [
        "https://www.tiktok.com/@garyvee"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("ritaya/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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = { "profileUrls": ["https://www.tiktok.com/@garyvee"] }

# Run the Actor and wait for it to finish
run = client.actor("ritaya/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 '{
  "profileUrls": [
    "https://www.tiktok.com/@garyvee"
  ]
}' |
apify call ritaya/tiktok-email-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=ritaya/tiktok-email-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/Jg5drSA7HZETIjYd4/builds/qJJAcNcBnwijjUAlf/openapi.json