How to get TikTok user followings
GET request to /v1/tiktok/user-followings with your input. You get clean JSON back in seconds for 1 credit per call — no OAuth, scraping or platform SDKs. List who a TikTok user follows — id, secUid, createTime, region, language, cursor pagination. Flat 1 credit.How to get TikTok user followings (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 Followings API
Send an authenticated GET request to /v1/tiktok/user-followings 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-followings?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": 81,
"totalIsApproximate": false,
"totalReturned": 2,
"hasMore": true,
"nextCursor": "1661588126000",
"followings": [
{
"username": "user927647273",
"displayName": "user927647273",
"bio": "secret",
"url": "https://www.tiktok.com/@user927647273",
"followers": 9282,
"following": 4,
"verified": false,
"profileImage": "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/c70537d713e096c514e7e8e27be0cf39~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=14579&refresh_token=616e8df2&x-expires=1785405600&x-signature=w%2BadFFsdbgxPDur8Y6yIeu5%2FYU8%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my2",
"id": "7221286453480817706",
"secUid": "MS4wLjABAAAAg4rTr5twSx0cDvC90WsFq6Zk2HpEcyOVjWMV1rb37RyZkyjSMTpnHzCTsTU2UObL",
"createTime": "2023-04-12T22:02:13.000Z",
"createTimeUnix": 1681336933,
"language": "en"
},
{
"username": "fifaworldcup",
"displayName": "FIFA World Cup",
"bio": "🏆 The official #FIFAWorldCup account on TikTok",
"url": "https://www.tiktok.com/@fifaworldcup",
"followers": 86600000,
"following": 93,
"verified": true,
"profileImage": "https://p16-common-sign.tiktokcdn.com/tos-useast2a-avt-0068-euttp/d260685754e3ae8139f47e7ec9fda7e9~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=14579&refresh_token=4d3bd79a&x-expires=1785405600&x-signature=UpkTTNy5CO1ckN0jnBQ1jrq4nRo%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my2",
"id": "7059636734342038534",
"secUid": "MS4wLjABAAAApf8MKCE246Q60LYymhpec5wPGF-uaGZgzl7W19U-AxtzHzeydNdE8xZedO_gUWDL",
"createTime": "2022-02-01T16:22:46.000Z",
"createTimeUnix": 1643732566,
"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 Followings API do?
The TikTok User Followings API lets you list items in bulk with metadata from a public TikTok user followings using one GET request to /v1/tiktok/user-followings. It returns clean JSON — no OAuth or infrastructure setup required.
How many credits does the TikTok User Followings 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 Followings 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 followings?
Start free with 100 credits — no credit card required.
Get your free API key