How to get TikTok user followers
GET request to /v1/tiktok/user-followers with your input. You get clean JSON back in seconds for 1 credit per call — no OAuth, scraping or platform SDKs. List a TikTok user's followers — id, secUid, createTime, region, language, cursor pagination. Flat 1 credit.How to get TikTok user followers (step by step)
- 1
Get a free API key
Create a free Captapi account (100 credits, no card) and generate an API key from the dashboard.
- 2
Call the TikTok User Followers API
Send an authenticated GET request to /v1/tiktok/user-followers with your input. No OAuth, no scraping setup.
- 3
Read the JSON response
Parse the clean JSON response. Pass cache=true for a free 24h cache hit; default is always fresh.
Code example
curl "https://api.captapi.com/v1/tiktok/user-followers?url=https%3A%2F%2Fwww.tiktok.com%2F%40khaby.lame" \
-H "Authorization: Bearer capt_live_..."
# or: -H "x-api-key: capt_live_..."What the response looks like
{
"success": true,
"data": {
"url": "https://www.tiktok.com/@khaby.lame",
"total": 162476412,
"totalIsApproximate": false,
"totalReturned": 2,
"hasMore": true,
"nextCursor": "1785219170000",
"followers": [
{
"username": "abdullah007a3",
"displayName": "𝄢 ⃝ᶦᵗᶻ•abdullah 亗",
"bio": "/ মানুষকে বোঝা কঠিন -\nআর বোঝানো তো অসম্ভব..!🖤",
"url": "https://www.tiktok.com/@abdullah007a3",
"followers": 17500,
"following": 6,
"verified": false,
"profileImage": "https://p16-common-sign.tiktokcdn.com/tos-alisg-avt-0068/ff95fdfeca275eed2d2984d618a10530~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=14579&refresh_token=d7015725&x-expires=1785405600&x-signature=Zs92egTgumV89yLzYImuFHbHTrI%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my2",
"id": "7084524072541307910",
"secUid": "MS4wLjABAAAAU2DhFzvcREPkAwTEDm5wYxPFCSf7l7g0GSQHY3rFZCBY1IlFORcpPL4TMDaxjNUq",
"createTime": "2022-04-09T09:37:50.000Z",
"createTimeUnix": 1649497070,
"language": "en"
},
{
"username": "hawulet97",
"displayName": "ሀያት",
"bio": null,
"url": "https://www.tiktok.com/@hawulet97",
"followers": 41,
"following": 1239,
"verified": false,
"profileImage": "https://p19-common-sign.tiktokcdn.com/tos-alisg-avt-0068/5acdd487480e04ffe37f451a62fa134d~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=14579&refresh_token=9e5f5d27&x-expires=1785405600&x-signature=r06fBPyezVcEOXYXR%2Fn5PrC0kQc%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my2",
"id": "7636369819877950485",
"secUid": "MS4wLjABAAAA-iwqiDRUYsYB6EPWLtkKC7LnR81u_bnHPwV2hjD_6vvHCV5WRlc5imKT_JYNVLCl",
"createTime": "2026-05-05T11:35:24.000Z",
"createTimeUnix": 1777980924,
"language": "en"
}
]
}
}Billing metadata (credits charged, cache hit/miss) is returned in the X-Captapi-Credits and X-Captapi-Cache response headers.
Request parameters
| Name | Type | Required | Description |
|---|---|---|---|
| url | string | Yes | TikTok profile URL, @handle, or username, e.g. https://tiktok.com/@username. Not a YouTube channel URL. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble. |
| limit | integer | No | Max items to return (default 50, max 500). Flat 1 credit per call. |
| cursor | string | No | Pagination cursor (TikTok minCursor). Leave empty for the first page; then pass nextCursor from the previous response. |
| cache | boolean | No | Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. |
Frequently asked questions
What does the TikTok User Followers API do?
The TikTok User Followers API lets you list items in bulk with metadata from a public TikTok user followers using one GET request to /v1/tiktok/user-followers. It returns clean JSON — no OAuth or infrastructure setup required.
How many credits does the TikTok User Followers API cost?
Each successful call costs 1 credit. Pass cache=true to serve from the 24h cache (0 credits on hit); default is always fresh. Selected profile endpoints also accept cacheMaxAge=1d|3d|7d|14d|30d. Failed or empty results are never charged.
Do I need a TikTok API key or OAuth?
No. A single Captapi key works across every platform Captapi supports — YouTube, TikTok, Instagram, Facebook, Twitter/X, Reddit, Threads, Bluesky, Pinterest, LinkedIn, Rumble, Spotify, Kwai, and more. We handle proxies, rate limits, retries, and authentication for you.
Do follower rows include secUid?
Yes — same identity fields as search-users (id + secUid) on every row when TikTok exposes them, plus createTime/createTimeUnix, region, and language for audience-quality signals. total is the profile's followerCount/followingCount; page with nextCursor + hasMore.
Why is this 1 credit when older docs said ~20?
Native signer path (/api/user/list/) is flat 1 credit. The old ~20 figure was Apify billed at ~0.4 credits per returned user (min 5). Billing is now flat 1 credit on every path, fallback included.
Is the TikTok User Followers API suitable for production use?
Yes. It is a stable REST endpoint with predictable JSON and automatic retries. Pass cache=true to serve from the 24h cache (0 credits on hit); default is always fresh. Selected profile endpoints also accept cacheMaxAge=1d|3d|7d|14d|30d. Use it for analytics, monitoring, and content automation.
Ready to get TikTok user followers?
Start free with 100 credits — no credit card required.
Get your free API key