# Changelog of Tiktok Influencer Finder (`coregent/tiktok-influencer-finder`) Actor

- **URL**: https://apify.com/coregent/tiktok-influencer-finder/changelog.md
- **Full Actor documentation**: https://apify.com/coregent/tiktok-influencer-finder.md

## Changelog

All notable changes to TikTok Influencer Finder.

### 0.2 — 2026-07-19

**TikHub-first discovery (faster, more reliable, lower compute)**

- All three modes (hashtag, keyword, seed profile) run through browserless TikHub endpoints, with the Puppeteer path kept as an automatic fallback. A run fully served by TikHub never launches Chromium.
- Bounded, parallelized profile **enrichment** fills fields the search endpoints omit — hashtag authors get follower stats; keyword creators get bio-derived fields (email, Instagram, YouTube, link-in-bio, language).

**Opt-in enrichment tiers (each its own pay-per-event)**

- **Enrich Bio & Contact Fields** (`enrichBio`, default on) → `bio-enrichment` event.
- **Analyze Recent Performance** (`includePerformance`, default off) → recent-video sample (median views/likes/comments, estimated engagement rate, activity/recency); `performance-sample` event.
- **Follow Bio Links** (`followBioLinks`, default off) → resolve emails from Linktree/Beacons/site pages; `emailSource` marks `bio` vs `followed_link`; `bio-link-follow` event, charged only when an email is found.

**New filters & inputs**

- Country Filter (`countryCodes`, dropdown) + `languages` (dropdown) + `countryMatchMode` (best-effort/strict); creator-quality filters `minVideos` / `minTotalLikes` / `excludePrivateAccounts`; `maxCreatorsPerSource`; Discovery Region (`region`, hashtags only); `campaignBrief` for brand-fit; `sortBy` adds `brandFitScore`.

**New output fields & signals**

- `secUid`, `emailSource`, `instagramUrl` / `youtubeUrl`, `likesPerFollower`, `searchRankBySource` / `bestSearchRank`, `shortlistRank`, `countryConfidence` / `languageConfidence`, transparent scoring (`qualificationComponents` / `relevanceComponents` / `scoringVersion`), `brandFitScore` (+ reason/components), `audienceQualityFlag` / `audienceQualityScore`, the performance block, and `profileStatus` / `errorCode`.
- New **Shortlist** dataset view (ranks top candidates); README adds Outreach/CRM recipes and an API & MCP section.

**Pricing (4 pay-per-events)**

- `influencer-result` (always) + `bio-enrichment` + `performance-sample` + `bio-link-follow` — add-ons charged only when enabled and only for work actually done.

**Input simplification**

- Removed low-value / confusing inputs (email-only, external-link, bio-keyword filters, an unused proxy option, and a debug section). Scoring, country/language annotation, and deduplication run by default. Filters and Options merged into one section.

### 0.1 — Initial release

- Discover TikTok creators by hashtag, keyword, or seed profile.
- Filter by follower range and verification; qualification + relevance scoring with reasons.
- Public contact clues (email, Instagram, YouTube, external link), discovery lineage, and four curated dataset views.