1. Filtering Creators by Follower Count Tier & Verification Badge
Unlike generic web search scrapers that return random fan accounts, /v1/user/search exposes TikTok's native creator directory filters directly as query parameters:
| Parameter | Allowed Values | Engineering Usage | Example |
|---|---|---|---|
| keywords | Any UTF-8 string | Niche, product category, location, or bio phrase | keywords=fitness+coach |
| follower_count | 0 (All), 1 (0–1K), 2 (1K–10K), 3 (10K–100K), 4 (100K+) | Target micro-influencers (tier 3) or macro talent (tier 4) | follower_count=3 |
| profile_type | 0 (All), 1 (Verified Blue-V) | Filter for verified brands, athletes, or public figures | profile_type=0 |
| cursor | 0, 10, 20, 30... | Pagination offset for deep niche harvesting | cursor=0 |
2. Three-Stage Influencer Discovery & Vetting Architecture
Production influencer databases run a three-stage funnel to keep unit costs under $0.005 per vetted creator:
- Stage 1 — Candidate Discovery (/v1/user/search): Paginate through niche keywords (e.g. 'skincare aesthetician', 'pilates instructor', 'saas founder') filtered to follower_count=3 (10K–100K) at $0.10 per 1,000 candidates.
- Stage 2 — Bio Contact & Link Extraction (/v1/user/info): Parse signature (bio text) and bioLink for business emails, Linktree/Beacons URLs, and Instagram handles.
- Stage 3 — Engagement & Velocity Scoring (/v1/user/posts): Fetch the creator's last 15 non-pinned videos to verify they published within the last 14 days and maintain an Engagement Rate by Views (ERV) above 4.5%.
3. Production Python & Node.js Influencer Search Pipeline
The script below searches for mid-tier creators (10K–100K followers), extracts business emails from their bios, and computes their recent video engagement rate.
Search Mid-Tier Influencers (10K–100K) & Compute Engagement Rate
Queries GET /v1/user/search with follower_count=3 and enriches each creator with GET /v1/user/posts.
curl -s "https://api.tiktokapi.io/v1/user/search?keywords=fitness+coach&follower_count=3&profile_type=0&cursor=0" \
-H "x-api-key: tk_live_your_api_key" | jq '.data.user_list[0].user_info | {unique_id, nickname, follower_count, signature}'Interactive Engineering Workbench · GET /v1/user/search
Verify real-time latency, pagination math & JSON schema
Frequently Asked Questions
- How much does it cost to build a database of 50,000 TikTok influencers?
- At 1 Credit per returned creator on GET /v1/user/search, fetching 50,000 creator profiles costs 50,000 Credits ($5.00 at base rate, or $3.80 on the Starter monthly plan).
- Does /v1/user/search return the creator's bio text (signature) directly?
- Yes. Each entry in data.user_list[].user_info includes unique_id, nickname, uid, sec_uid, signature (full bio text), follower_count, total_favorited, and avatar URLs.