All endpoints
TikTok User Following

TikTok User Following API

Get the accounts a user follows, by username, numeric user ID, or profile URL. Returns the same profile fields as User Followers for each account, 50 per page. Accounts that hide their following list return 403.

Price: $0.006 per page
Free tier: 50 requests/month
Get API Key Documentation
Endpoint
GET /v1/tiktok/user/following

Parameters

username
TikTok username, with or without leading @ (max 100 characters). Provide exactly one of username, user_id, or url.
user_id
Numeric TikTok user ID, as returned by Search Users or User Profile. Provide exactly one of username, user_id, or url.
url
TikTok profile URL, e.g. https://www.tiktok.com/@tiktok (max 500 characters). Provide exactly one of username, user_id, or url.
pages
Number of pages to fetch, 1-1000 (default: 1). Each page returns up to 50 accounts.

Response fields

following
Array of the accounts the user follows
username
TikTok username (unique ID)
nickname
Display name
user_id
TikTok user ID
sec_uid
TikTok secondary user ID (secUid)
bio
Profile bio / signature
verified
Whether the user is verified
is_private
Whether the account is private
followers
Number of followers
following
Number of accounts followed
likes
Total likes received
video_count
Number of videos posted
videos_liked
Number of videos the user has liked
avatar
URL to profile picture
region
2-letter region code of the account
language
Account language code
date_joined
Date and time the account was created
date_joined_timestamp
Unix timestamp of the account creation date
instagram_username
Linked Instagram username, or empty string
twitter_id
Linked X/Twitter account ID, or empty string
twitter_username
Linked X/Twitter username, or empty string
youtube_channel_id
Linked YouTube channel ID, or empty string
youtube_channel_title
Linked YouTube channel name, or empty string
url
Link to the profile
username
The requested username (empty when looked up by user_id)
user_id
The user's numeric ID
total
The user's total following count
pages
Number of pages returned
count
Number of results returned

Example Request

curl "https://apidirect.io/v1/tiktok/user/following?username=gordonramsayofficial&pages=2"   -H "X-API-Key: YOUR_API_KEY"

Example Response

{
  "following": [
    {
      "username": "netflixuk",
      "nickname": "NetflixUK",
      "user_id": "6796949557193655302",
      "sec_uid": "MS4wLjABAAAAQp_PoXccOVClw6n4sGzXVXdr3W92EtzhdlaZeE...",
      "bio": "🐝",
      "verified": true,
      "is_private": false,
      "followers": 2238486,
      "following": 41,
      "likes": 95184771,
      "video_count": 1614,
      "videos_liked": 1723,
      "avatar": "https://p19-common-sign.tiktokcdn.com/.../avatar.jpeg",
      "region": "GB",
      "language": "en",
      "date_joined": "2020-02-24 01:58:52",
      "date_joined_timestamp": 1582509532,
      "instagram_username": "",
      "twitter_id": "",
      "twitter_username": "",
      "youtube_channel_id": "",
      "youtube_channel_title": "",
      "url": "https://www.tiktok.com/@netflixuk"
    }
  ],
  "username": "gordonramsayofficial",
  "user_id": "6747935906352907269",
  "total": 555,
  "pages": 2,
  "count": 100
}

Frequently asked questions

What does limited_account mean?

The account hides its following list, so TikTok does not expose it. The endpoint returns 403 with code limited_account.

Can I look up a user by URL or user ID?

Yes. Provide exactly one of username, user_id, or url.

How does pricing work?

You only pay for successful requests. The TikTok User Following API costs $0.006 per page. There are no monthly fees or commitments. You get 50 free requests per endpoint every month.

Do I need a credit card to start?

No. You can sign up and use the free tier (50 requests/endpoint/month) without adding a payment method. You only need to add a card when you want to exceed the free tier.

Are there rate limits?

Yes, there's a concurrency limit of 10 simultaneous requests per endpoint per user. If you need more, just get in touch.

Start using the TikTok User Following API

Get your API key and start making requests in minutes. 50 requests/month free every month.

Get API Key