TikTok User API
Search public TikTok content and retrieve profiles, videos, LIVE data, music, hashtags, and location results.
User
24 endpoints- Get TikTok profile (v1)GETReturns a TikTok profile's public statistics: followers, following, likes, and video count. An unknown username returns data: null.
/v1/tiktok/profile1 cr - Get TikTok user country (v2)GETReturns the registered country of a TikTok account, looked up by username (the handle without @). The response includes country and the account's user_id.
/v2/tiktok/app/user/country2 cr - Get TikTok user LIVE room (v2)GETReturns the current LIVE room of a TikTok user, looked up by unique_id (the handle without @), in data. The room details are empty when the user is not live.
/v2/tiktok/web/user/live2 cr - List TikTok playlist videos (v2)GETReturns the videos in one TikTok playlist (mix), looked up by mix_id, in itemList. Get mix_id from the user playlists endpoint. Page with cursor and count.
/v2/tiktok/web/user/mix2 cr - List TikTok similar users (v2)GETReturns accounts TikTok suggests as similar to the user with sec_uid, in users. For the next page, send the page_token the response provides. A 404 means TikTok keeps no similar-user list for this account; it is final, so do not retry.
/v2/tiktok/app/user/similar2 cr - List TikTok sounds by user (v2)GETReturns sounds created by the TikTok user with sec_uid, in music. music can be null for accounts with none. Page with cursor and count.
/v2/tiktok/app/user/music2 cr - List TikTok user followers (v2)GETReturns followers of a TikTok user, identified by user_id or sec_user_id. Maximum 20 per page; continue with the response's min_time and next_page_token.
/v2/tiktok/app/user/followers2 cr - List TikTok user following (v2)GETReturns accounts a TikTok user follows, identified by user_id or sec_user_id. Maximum 20 per page; continue with the response's min_time and next_page_token.
/v2/tiktok/app/user/following2 cr - List TikTok user likes (v2)GETReturns videos liked by the user with sec_uid, only when that user's likes are public. Otherwise the result is empty. Page with cursor and count.
/v2/tiktok/web/user/likes2 cr - List TikTok user playlists (v2)GETReturns the playlists (mixes) of the user with sec_uid. Page with cursor and count. The result is empty for users with no public playlists.
/v2/tiktok/web/user/playlists2 cr - List TikTok user reposts (app) (v2)GETReturns videos a TikTok user reposted, looked up by numeric user_id, in aweme_list. Page with offset and count.
/v2/tiktok/app/user/reposts2 cr - List TikTok user reposts (web) (v2)GETReturns videos reposted by the user with sec_uid, in itemList. Page with cursor and count; cover_format picks the cover image format.
/v2/tiktok/web/user/reposts2 cr - List TikTok user videos (v2)GETReturns public videos posted by a TikTok user. Identify the user with sec_user_id or unique_id; order with sort_type, page with max_cursor and count.
/v2/tiktok/app/user/posts2 cr - Resolve TikTok URL to sec user ID (v2)GETReturns the sec_user_id for a TikTok profile url, for example https://www.tiktok.com/@khaby.lame.
/v2/tiktok/web/resolve/sec-user-id2 cr - Resolve TikTok URL to user ID (v2)GETReturns the numeric user_id for a TikTok profile url, for example https://www.tiktok.com/@khaby.lame.
/v2/tiktok/web/resolve/user-id2 cr - Resolve TikTok URL to username (v2)GETReturns the unique_id (the handle without @) for a TikTok profile url, for example https://www.tiktok.com/@khaby.lame.
/v2/tiktok/web/resolve/unique-id2 cr - Resolve TikTok username to IDs (v2)GETReturns the numeric user_id and the sec_user_id for a TikTok username (handle without @). Other user endpoints take one of these IDs.
/v2/tiktok/app/user/resolve2 cr - Search a TikTok user's followers (v2)GETReturns followers of the account with numeric user_id whose names match keyword, in results. Get user_id from the username resolve endpoint.
/v2/tiktok/app/user/followers/search2 cr - Search a TikTok user's following (v2)GETReturns accounts followed by the user with numeric user_id whose names match keyword, in results. Get user_id from the username resolve endpoint.
/v2/tiktok/app/user/following/search2 cr - Search TikTok users (v2)GETReturns TikTok accounts matching keyword in user_list. Optional user_search_ filters narrow the match; page with offset and count.
/v2/tiktok/app/search/users2 cr - Search TikTok users (web) (v2)GETReturns TikTok accounts matching keyword in user_list. For later pages, send the previous response's cursor and search_id.
/v2/tiktok/web/search/users2 cr Get TikTok user profile (web) (v2)DeprecatedGETDeprecated: use /v1/tiktok/profile instead. Returns a public TikTok profile, with stats, in userInfo. Provide unique_id (the handle) or sec_uid./v2/tiktok/web/user/profile2 crList TikTok user followers (web) (v2)DeprecatedGETReturns followers of the user with sec_uid, in userList. Page with count, max_cursor, and min_cursor. Deprecated: use /v2/tiktok/app/user/followers./v2/tiktok/web/user/fans2 crList TikTok user following (web) (v2)DeprecatedGETReturns accounts followed by the user with sec_uid, in userList. Page with count, max_cursor, and min_cursor. Deprecated: use /v2/tiktok/app/user/following./v2/tiktok/web/user/following2 cr