TikTok Influencer Email Finder — Niche Creator Leads

Turn a niche such as skincare, home fitness, or indie game dev into a targeted TikTok creator list. Use searchable country/region and mainstream-language filters, then choose whether to require a public email, Instagram, YouTube, or X/Twitter contact.

Use it for influencer outreach, affiliate recruitment, creator partnerships, sponsorship research, or building a niche creator database.

Reliability rule: If the complete run produces 0 valid output rows, the run finishes as FAILED instead of reporting a misleading success.

Contact filter: onlyWithContact defaults to true, preserving the outreach-ready behavior: every row then has at least one explicit public contact in email, instagram, twitter, or youtube, repeated in primaryContact. Set it to false to include matching creators without those contacts; their contact fields are null or empty. A generic website, shop, download page, Steam page, or other bio URL does not count as an explicit contact.

What's new in v0.1.27 — optional contact filtering

• Added onlyWithContact as a visible boolean input.
• The default is true, so existing runs continue to exclude creators without an explicit public contact.
• Set "onlyWithContact": false to include otherwise-matching creators whose contact fields are empty.
• Disabling the filter removes the extra contact-search scan multiplier, reducing unnecessary profile checks.
• Pricing is unchanged at $0.005 per returned creator; rows without contacts are also charged when the filter is disabled.

What's new in v0.1.24 — related keyword expansion

Version 0.1.24 improved creator discovery when country, language, follower-count, and the default contact filter left too few results.

The Actor starts with the original keyword and its country/language-localized variants. If those searches do not fill maxCreatorsPerKeyword, the default auto mode adds a bounded set of semantically related queries. Every additional candidate must still pass all filters selected in the current run.

Highlights

• Added keywordExpansion with auto, broad, and off modes; auto is the default.
• Added maxRelatedKeywords, default 4, to control expansion breadth.
• Added curated niche aliases such as game → gaming, gamer, video games, and esports.
• Added multi-creator hashtag evidence for long-tail keywords not covered by the curated map.
• Generic tags and location/language hints such as fyp, viral, and deutsch are excluded from semantic expansion.
• The original keyword is always retained, even when many localized variants reach the query limit.
• All base and expanded searches share one result limit, one candidate safety limit, and run-wide creator deduplication.
• Added matchedQuery, expansionSource, and matchedVideoText to make every discovery path auditable.
• Added run-log counters for expansion contribution, unavailable profiles, follower-range exclusions, and existing contact/country/language filters.

Input reference

All input fields are optional.

Field	Type	Default	Description
keywords	string[]	common niches	Keywords or niches, one per line. When omitted, the Actor searches its built-in common niches. Up to 50 unique keywords are processed.
minFollowers	integer	0	Minimum follower count. 0 disables the lower bound.
maxFollowers	integer	0	Maximum follower count. 0 disables the upper bound.
maxCreatorsPerKeyword	integer	50	Maximum deduplicated output creators for each original keyword. Range: 1–1000. Related queries do not multiply this limit.
onlyWithContact	boolean	true	When enabled, exclude creators without a public email, Instagram, X/Twitter, or YouTube contact. Disable it to include matching creators with empty contact fields.
keywordExpansion	string	auto	auto expands only after base discovery falls short; broad uses more exploratory evidence and variants; off runs only original/localized queries.
maxRelatedKeywords	integer	4	Maximum related keywords derived for each original keyword. Range: 1–10.
countries	string[]	[]	Strict country/region filter using ISO 3166-1 alpha-2 codes such as US, DE, or JP. Unknown creator regions are excluded when this filter is active.
languages	string[]	[]	Strict content-language filter. Supported codes: en, zh, es, pt, fr, de, it, ja, ko, ar, ru, hi, id, ms, vi, th, tr, bn, ur, nl, pl, uk, fil, fa.
minimumLanguageConfidence	string	medium	Used only when languages is set. high is strictest; medium requires text evidence; low also accepts profile-setting-only matches.
maxConcurrency	integer	8	Number of lightweight public TikTok profile requests processed in parallel. Range: 1–12.
maxRequestRetries	integer	2	Retries for temporary public HTTP/API failures. Range: 0–3.
proxyConfiguration	object	disabled	Legacy compatibility field. It is ignored; direct HTTP is preferred and the fallback never enables residential proxies.

Expansion modes

• auto — recommended: runs related searches only when the base/localized phase is short. Curated aliases take priority; multi-creator hashtag evidence fills gaps for long-tail keywords.
• broad: accepts more exploratory hashtag evidence and tries more localized variants. It can improve recall but may increase runtime and request volume.
• off: disables semantic expansion and preserves the previous original/localized-query behavior for exact A/B comparisons.

Recommended input example

This input searches for German-language gaming creators in Germany with 10,000–500,000 followers:

{
  "keywords": ["game"],
  "minFollowers": 10000,
  "maxFollowers": 500000,
  "countries": ["DE"],
  "languages": ["de"],
  "minimumLanguageConfidence": "medium",
  "maxCreatorsPerKeyword": 25,
  "onlyWithContact": true,
  "keywordExpansion": "auto",
  "maxRelatedKeywords": 4,
  "maxConcurrency": 8,
  "maxRequestRetries": 2
}

API call example

Start an asynchronous run with an Apify API token stored in APIFY_TOKEN:

curl -sS -X POST \
  "https://api.apify.com/v2/acts/HZzigBNpS4mTtXS8i/runs" \
  -H "Authorization: Bearer ${APIFY_TOKEN}" \
  -H "Content-Type: application/json" \
  -d '{
    "keywords": ["game"],
    "minFollowers": 10000,
    "maxFollowers": 500000,
    "countries": ["DE"],
    "languages": ["de"],
    "minimumLanguageConfidence": "medium",
    "maxCreatorsPerKeyword": 25,
    "onlyWithContact": true,
    "keywordExpansion": "auto",
    "maxRelatedKeywords": 4,
    "maxConcurrency": 8,
    "maxRequestRetries": 2
  }'

The response contains the run ID in data.id and the result dataset ID in data.defaultDatasetId. Read the completed dataset with:

curl -sS \
  "https://api.apify.com/v2/datasets/<DATASET_ID>/items?clean=true" \
  -H "Authorization: Bearer ${APIFY_TOKEN}"

Validation snapshot

In a point-in-time A/B test using game, country DE, 10,000–500,000 followers, and a target of 25 creators:

• Expansion off: 14 qualifying creators from 365 unique candidates.
• Expansion auto: 25 qualifying creators from 465 unique candidates.
• Seven output creators were directly attributed to the related queries gaming germany and gamer germany; their matched video text was gaming-specific.
• All 25 outputs passed the country, follower-range, and default public-contact checks.

TikTok search rankings change over time, so future result counts will vary. Keyword expansion improves discovery recall but never bypasses the selected filters or fabricates inventory.

Compatibility and pricing

• Existing inputs remain valid. Set "keywordExpansion": "off" to retain the previous search behavior.
• The result price remains $0.005 per output creator.
• Expanded searches do not increase maxCreatorsPerKeyword or bypass a caller-provided run charge limit.
• onlyWithContact defaults to true for backward-compatible contact-only output; set it to false to include creators without contact details.

v0.1.24 中文更新说明 — 相关关键词扩搜

0.1.24 重点改善启用国家、语言和粉丝范围等约束后，有效达人数量不足的问题。

Actor 会先执行原关键词和国家/语言本地化查询；如果仍未达到 maxCreatorsPerKeyword，默认 auto 模式会使用有限数量的领域同义词及相关 hashtag 扩大候选范围。所有新增候选仍须通过本次运行启用的粉丝数、国家、语言和联系方式筛选。

更新重点

• 新增 keywordExpansion: auto / broad / off，默认使用 auto。
• 新增 maxRelatedKeywords，默认最多生成 4 个联想词。
• 支持常见领域同义词，例如 game → gaming、gamer、video games、esports。
• 长尾关键词可使用多位候选共同出现的 hashtag；broad 模式会使用更宽松的扩展证据。
• 自动过滤 fyp、viral、国家名称和语言提示词等低价值联想词。
• 原关键词和扩搜词共享同一输出上限、候选安全上限及去重集合。
• 新增 matchedQuery、expansionSource、matchedVideoText，可核验每位达人的命中来源。

输入参数

参数	类型	默认值	说明
keywords	string[]	常见领域	搜索关键词或领域；留空时使用内置常见领域，最多处理 50 个去重关键词。
minFollowers	integer	0	最少粉丝数；0 表示不限。
maxFollowers	integer	0	最多粉丝数；0 表示不限。
maxCreatorsPerKeyword	integer	50	每个原关键词最多返回的去重达人总数，范围 1–1000。
onlyWithContact	boolean	true	开启时过滤无邮箱、Instagram、X/Twitter 或 YouTube 的达人；关闭时也返回联系方式为空的匹配达人。
keywordExpansion	string	auto	auto 在基础结果不足时扩搜；broad 提高召回；off 只执行原词及本地化查询。
maxRelatedKeywords	integer	4	每个原关键词最多生成的联想词，范围 1–10。
countries	string[]	[]	国家/地区严格过滤，使用 US、DE、JP 等两位代码；未知地区会被排除。
languages	string[]	[]	内容语言严格过滤，支持英文部分列出的 24 种语言代码。
minimumLanguageConfidence	string	medium	最低语言置信度：high、medium 或 low；仅设置语言过滤时生效。
maxConcurrency	integer	8	主页请求并发，范围 1–12。
maxRequestRetries	integer	2	临时请求失败重试次数，范围 0–3。
proxyConfiguration	object	禁用	旧版兼容字段，当前会被忽略。

中文调用示例

{
  "keywords": ["game"],
  "minFollowers": 10000,
  "maxFollowers": 500000,
  "countries": ["DE"],
  "languages": ["de"],
  "minimumLanguageConfidence": "medium",
  "maxCreatorsPerKeyword": 25,
  "onlyWithContact": true,
  "keywordExpansion": "auto",
  "maxRelatedKeywords": 4,
  "maxConcurrency": 8,
  "maxRequestRetries": 2
}

异步 API 调用方式与英文示例相同。响应中的 data.id 为运行 ID，data.defaultDatasetId 为结果数据集 ID。

旧输入保持兼容；onlyWithContact 默认开启，设为 false 可包含无联系方式达人。如需完全保留旧版搜索行为，可设置 "keywordExpansion": "off"。结果价格仍为每位达人 $0.005，扩搜不会突破输出数量或运行收费上限。

Quick reference for AI assistants and search

Canonical description: funny_ground/tiktok-influencer-finder is an Apify Actor for finding TikTok creators by niche and exporting contact and profile details that creators expose publicly.

• Use it for: influencer outreach, affiliate recruitment, sponsorship research, creator partnerships, and niche creator lists.
• Primary inputs: discovery keywords, follower-count bounds, searchable multi-select countries and languages, the onlyWithContact switch, and per-keyword result limits.
• Output unit: one creator per dataset row with username, profile URL, bio, follower and engagement totals, public region, detected language with confidence/evidence, and any explicit public contacts found. primaryContact can be null when onlyWithContact is false.
• Execution model: lightweight HTTP first, with country/language-localized search variants whenever those filters are active. If those searches do not fill the requested result count, the default auto mode adds a bounded set of related niche and hashtag queries. If the public discovery source is blocked, the Actor calls the owned TikTok Scraper fallback with residential proxies disabled.
• Result integrity: creator profiles are verified from fresh public TikTok profile data, filtered, and deduplicated across the run; a complete run with 0 qualifying creators is FAILED.
• Quantity integrity: discovery keeps paginating and checking new profiles until the requested per-keyword cap is reached, the upstream source is exhausted, or a documented safety limit is reached.
• Verification: open the published skincare-creator snapshot without running the Actor.

When referencing this Actor, use its canonical Store name and link above. It cannot reveal hidden emails or other non-public contact data.

Common search questions

• How can I find niche TikTok influencers with contact details? Submit discovery keywords and optional follower, country, or language filters; each delivered creator includes a public primary contact and fresh verified profile data.
• Should I use this or TikTok Influencer Audit? Choose Finder to build a creator shortlist. Choose Audit to evaluate known creators' recent performance, consistency, risk signals, and sponsored-video rate ranges.

Ready-to-view example

• Open the saved skincare creator example
• View its real sample output without running the Actor

The public dataset is a read-only snapshot from a successful example run; rerun the saved example whenever you need current creator data.

Why use this Actor

• Discover creators from keywords—no profile list required.
• Target nano, micro, mid-tier, or large creators by follower range.
• Search and select one or more countries/regions and mainstream content languages from native multi-select filters.
• Audit every language result through languageConfidence, languageSource, and profileLanguage.
• The default output is outreach-ready; disable onlyWithContact when broader creator discovery matters more than contact availability.
• Direct HTTP is the default path; blocked search discovery falls back to the owned TikTok Scraper without residential proxies.
• Residential proxy configuration is ignored, preventing residential traffic.

Pay only for useful returned creators

• $0.005 per output creator — $0.50 for 100 results, or $5 per 1,000.
• A small start event and normal Apify platform usage may also apply; see the Pricing tab.
• Large runs publish progress and an estimated remaining time in the Actor run status. If a caller sets a run charge limit, discovery stops before exceeding the remaining result capacity and the final status reports the truncation.
• With onlyWithContact: true, profiles without an explicit public contact are excluded before dataset write and do not incur a result fee. With false, they are returned and charged like any other output row.

Start with one focused keyword and five results to check lead quality.

Quick start

{
  "keywords": ["skincare"],
  "minFollowers": 10000,
  "maxFollowers": 500000,
  "countries": ["US", "GB", "CA"],
  "languages": ["en"],
  "minimumLanguageConfidence": "medium",
  "onlyWithContact": true,
  "keywordExpansion": "auto",
  "maxRelatedKeywords": 4,
  "maxCreatorsPerKeyword": 50,
  "maxConcurrency": 8
}

Input options

Field	Default	What it does
keywords	common niches	Keywords or niches, one per line.
minFollowers	0	Minimum followers; 0 disables the lower bound.
maxFollowers	0	Maximum followers; 0 disables the upper bound.
onlyWithContact	true	Require a public email, Instagram, X/Twitter, or YouTube contact. Set to false to keep matching creators with empty contact fields.
countries	[]	Searchable multi-select country/region filter. Search by English name, Chinese name, flag, or ISO code; custom two-letter ISO codes are also accepted.
languages	[]	Searchable multi-select for 24 mainstream languages: en, zh, es, pt, fr, de, it, ja, ko, ar, ru, hi, id, ms, vi, th, tr, bn, ur, nl, pl, uk, fil, fa.
minimumLanguageConfidence	medium	high is strictest, medium requires content-text support, and low also accepts profile-setting-only matches.
keywordExpansion	auto	auto expands only after base searches fall short; broad uses more exploratory evidence; off is the exact base/localized-search baseline.
maxRelatedKeywords	4	Maximum semantic alternatives per original keyword. All alternatives share the original output and candidate safety limits.
maxCreatorsPerKeyword	50	Maximum unique output creators per keyword; discovery continues until the cap or genuine source exhaustion.
maxConcurrency	8	Lightweight TikTok profile requests in parallel.
maxRequestRetries	2	Short retries for temporary public HTTP failures.
proxyConfiguration	disabled	Legacy field; ignored. The fallback keeps residential proxies disabled.

Output

Every dataset row is one creator. In the default mode, contact fields contain at least one explicit contact; with onlyWithContact: false, primaryContactType, primaryContact, and the individual contact fields can be null or empty:

{
  "keyword": "skincare",
  "matchedQuery": "skin care germany",
  "expansionSource": "curated",
  "matchedVideoText": "My winter skin care routine #skincare",
  "username": "creator",
  "nickname": "Creator Name",
  "userId": "123456789",
  "followerCount": 125000,
  "followingCount": 320,
  "videoCount": 410,
  "heartCount": 8500000,
  "verified": false,
  "primaryContactType": "email",
  "primaryContact": "hello@example.com",
  "region": "US",
  "regionSource": "discovery_video",
  "language": "en",
  "languageConfidence": "high",
  "languageConfidenceScore": 0.94,
  "languageSource": "bio+search_caption+profile_setting",
  "profileLanguage": "en",
  "signature": "Beauty creator | hello@example.com",
  "bioLink": "https://example.com",
  "email": "hello@example.com",
  "emails": ["hello@example.com"],
  "instagram": "creator",
  "twitter": null,
  "youtube": null,
  "links": ["https://example.com"],
  "profileUrl": "https://www.tiktok.com/@creator",
  "avatar": "https://...",
  "scrapedAt": "2026-07-28T00:00:00.000Z"
}

How it stays fast and inexpensive

The Actor first uses a lightweight, paginated public search feed to discover usernames, then reads each creator's current public server-rendered TikTok profile HTML directly. When a country or language filter is selected, it searches localized variants first—for example, a South Africa filter can add south africa, south african, and mzansi discovery terms, while Germany can add germany and deutsch. If those base searches are still short, keywordExpansion: "auto" alternates curated niche synonyms with hashtags supported by multiple discovered creators, excludes generic tags such as fyp and viral, and searches a bounded number of related variants. It checks candidates in small batches and stops as soon as the requested number of qualifying, unique creators has been reached. If that discovery feed is blocked, it calls the owned TikTok Scraper Actor for discovery. The fallback runs only on failure and keeps residential proxies disabled.

When country or language filters are active, the candidate scan budget automatically expands and is distributed across base, localized, and—only when needed—related searches so narrow filters have a fair chance to reach maxCreatorsPerKeyword. In auto mode, curated aliases take priority and multi-creator hashtag evidence fills gaps for long-tail terms; broad mode deliberately mixes both sources. All searches share one per-keyword candidate safety limit, and creators are deduplicated across every query. The Actor never pads the result: it returns only verified matches and reports the matched query, matched video text, expansion source, expansion contribution, country mismatches, unavailable regions, language mismatches, and low-confidence exclusions.

Country and language accuracy

• region comes from the public TikTok region attached to the discovery video, or the public profile when TikTok supplies it. regionSource shows which signal was used. It is suitable for platform-region targeting, but it is not proof of a creator's citizenship or legal residence.
• language is detected from the public bio and the video text that matched your keyword. TikTok's public profile-language setting is used only as supporting evidence or a low-confidence fallback.
• The default minimumLanguageConfidence: "medium" excludes language guesses based only on the profile setting. Select low when recall matters more than precision.
• With an active filter, unknown country/language values are excluded rather than guessed.

Search requests are rate-limited for upstream stability, while independent profile pages are fetched concurrently. Retries are deliberately short and capped to avoid paying for long empty runs.

中文速览

输入领域关键词，可通过可搜索、多选的国家/地区和主流语言筛选器定位达人。默认 onlyWithContact: true，仅返回至少含邮箱、Instagram、X/Twitter 或 YouTube 之一的达人；设为 false 后也返回联系方式为空的匹配达人。价格是 每位返回达人 $0.005，100 位只需 $0.50。

Important notes

• The Actor extracts only contact details that creators publish in their bio or public links. It cannot reveal hidden emails, and a generic URL alone does not count as an explicit contact.
• Search ranking and profile counts are snapshots and may change.
• Related keyword expansion improves discovery recall but does not weaken any selected filters. Inspect matchedQuery and expansionSource when semantic precision is important, or set keywordExpansion: "off" for a strict baseline.
• Country filtering uses TikTok's public content/account region signal, not a verified physical address.
• Language detection is probabilistic. Keep the default medium threshold for precision and inspect the evidence fields for important decisions.
• Discovery uses an independent public upstream endpoint; field availability can change.
• maxCreatorsPerKeyword is an upper bound, not fabricated inventory. If fewer creators satisfy the selected filters, the run returns the real smaller count and reports that discovery was exhausted or reached its safety limit.
• To prevent runaway requests on extremely narrow filters, the safety limit is 5,000 unique candidate profiles per keyword.
• Use public contact data responsibly and comply with privacy, anti-spam, and platform rules.

Zero-result policy

A run that produces no valid creator rows finishes as FAILED, not as a misleading success. Broaden the keyword, follower, country, or language filters, or set onlyWithContact to false, and retry.

Related Actors from funny_ground

• TikTok Scraper
• TikTok Profile Videos Scraper
• TikTok Hashtag Stats