1. Creator Profile, Posts & Follower Graph Endpoints
Combine these four endpoints to build a complete 360-degree creator intelligence pipeline:
| Endpoint | Compatible Route | Required Identifier | Page Size & Credits |
|---|---|---|---|
| GET /v1/users/profile | GET /v1/user/info | username (e.g. tiktok) | 1 profile + stats · 10 Credits ($0.001) |
| GET /v1/users/videos | GET /v1/user/posts | username (e.g. tiktok), limit (33), cursor | Up to 33 videos/call · 2 Credits / video |
| GET /v1/users/followers | GET /v1/user/followers | user_id (numeric ID from profile), limit (200), cursor | Up to 200 followers/call · 1 Credit / user |
| GET /v1/users/following | GET /v1/user/following | user_id (numeric ID from profile), limit (200), cursor | Up to 200 following/call · 1 Credit / user |
2. Two-Step Workflow: Resolve @username -> Fetch Posts & 200 Followers
First call /v1/users/profile to get the creator's numeric user_id and stats, then pass user_id to /v1/users/followers:
Creator Analytics & 200-Follower Graph Pipeline
Resolves @tiktok to numeric user_id=107955, fetches latest 33 videos, and retrieves 200 followers in a single page.
# Step 1: Resolve @username to numeric user_id
curl -sS "https://api.tiktokapi.io/v1/users/profile?username=tiktok" \
-H "x-api-key: tk_your_api_key_here"
# Step 2: Fetch 200 followers in one call using user_id
curl -sS "https://api.tiktokapi.io/v1/users/followers?user_id=107955&limit=200&cursor=0" \
-H "x-api-key: tk_your_api_key_here"Interactive Engineering Workbench · GET /v1/user/info
Verify real-time latency, pagination math & JSON schema
5,000 videos/day
10,000 comments/day
20,000 followers/day
Our HTTP Calls/Day
452
Large page sizes
Legacy Provider Calls
1,334
30-item small pages
Official Research API
Within 1K Cap
1,000 req/day limit
Estimated Monthly Pipeline Cost (30 Days)
$72.73/ mo with Business bonus ($120.00 base rate)
Daily consumption: 40,000 Credits ($4.00/day)
TikTokAPI.io (with volume bonus):$72.73 / mo
Legacy Scrapers ($1.50 / 1K calls):$60.03 / mo
Failed / 404 request fee:$0.00 (0 Credits)
Frequently Asked Questions
- Why does /v1/users/followers require a numeric user_id instead of @username?
- TikTok's internal graph index keys follower lists by the immutable 64-bit integer user_id rather than the mutable @unique_id handle. You can resolve any @username to its user_id in one call via GET /v1/users/profile or test it online with our free TikTok ID Finder tool (/tools/tiktok-id-finder).
- How many credits does it cost to fetch 10,000 followers?
- At 200 followers per request and 1 Credit per returned follower, 10,000 followers require only 50 API calls and cost 10,000 Credits ($1.00 base rate, or $0.60 with Business bonus).