TikTok User API Endpoints
Last updated
Access comprehensive public profile information, including nickname, bio, follower count, verification status, and more for any TikTok user.
New here? See the TikTok User API overview for use cases, code samples, and FAQs.
User ID
Retrieve the unique numeric User ID (UID) for any TikTok user by providing their username. Essential for subsequent API requests. The response is a single JSON object with the id field, for example {"id": "107955"} for the official tiktok account. Store this ID once per account: /user-posts/, /user-followers/, /user-following/ and both info endpoints all key off the numeric userid rather than the handle, and handles can change while the ID never does.
User Info by Username
Fetch detailed user profile information including bio, stats (followers, heart count), nickname, and verified status using a username. Returns two blocks in one call: a user object with id, uniqueId, nickname, signature (the bio), avatar URLs in three sizes, verified, privateAccount, secUid, createTime (account creation as a Unix timestamp) and bioLink when the account has set one, plus a stats object with followerCount, followingCount, heartCount, videoCount and diggCount. This is the go-to endpoint for influencer vetting and profile enrichment when all you have is a handle.
User Info by ID
Get comprehensive user profile details such as follower count, total likes, bio, secUid and account creation time (createTime) using the unique numeric User ID. The response shape is identical to the username variant - a user block and a stats block - so the two endpoints share one parser. Use this one when you already store numeric IDs and want to refresh follower counts on a schedule without resolving handles again, for example in a daily competitor-tracking snapshot.
User Posts
Retrieve a list of video posts from a specific TikTok user, including video play URL, cover image, stats, and description. Each entry in the videos array carries play (clean MP4 URL), wmplay (watermarked), cover images, duration, create_time, a nested music_info block, and live counters: play_count, digg_count, comment_count, share_count, download_count and collect_count. Loop on the returned cursor while hasMore is true to walk the entire public channel, newest first.
User Followers
Get the complete list of followers for a specific TikTok user. Access user profiles of followers for deeper audience analysis. Each follower is a full profile object - unique_id, nickname, region, avatar, verified, follower_count, following_count and aweme_count (post count) - alongside a total for the account. Pagination is time-based: pass the time value from the previous response to fetch the next page of up to 200. Region and count fields make this the raw material for audience-quality and fake-follower audits.
User Following
Retrieve the list of accounts that a specific TikTok user is following. Analyze user interests and network connections. The followings array mirrors the follower object shape - unique_id, nickname, region, verified and full stat counts per account - with a total and time-based pagination up to 200 per page. Following lists reveal partnerships, brand relationships and interest graphs that follower lists cannot show.
User Search
Search for TikTok users by keyword or username. Find profiles matching your search criteria with detailed user snippets. Each hit in user_list bundles a user object and a stats object, so follower counts arrive inline and you can rank candidates without a second lookup per profile. Page with cursor and hasMore. Typical uses: seeding an influencer-discovery pipeline by niche keyword, or locating a brand account and its imitators in one pass.
User Collections
Retrieve a list of public collections (favorites) created by a specific TikTok user, including each collection's title and video count. The collection_list array returns id, name, state and video_count per collection, with cursor pagination. Feed a collection id into /collection-posts/ to enumerate the saved videos - together the two calls expose what a creator curates, which is often a stronger interest signal than what they post.
User Liked Posts
Access the list of videos that a specific TikTok user has liked. Note: The user's liked videos must be public. Returns the same rich video objects as /user-posts/ - media URLs, music_info and the full engagement counters - with a timestamp-style cursor and hasMore for paging. Most accounts hide their likes, so treat an empty result as the normal case and the public ones as bonus behavioural signal.
User Playlists (Mix)
Browse and retrieve all public playlists created by a specific TikTok user. Discover their personal video collections and curated series. The mix_list array gives id, name and type per playlist, paged with cursor and hasMore. Pass any id to /playlist-posts/ for the full video sequence, or to /playlist-info/ for its metadata - useful for mapping how a creator organises episodic or series content.
User Stories
Retrieve active stories posted by a specific TikTok user. Access temporary video content before it expires. Stories come back as standard video objects - cover, play and wmplay URLs, duration, music_info and engagement counts - with a millisecond-timestamp cursor. Because stories vanish after 24 hours, poll this endpoint on a schedule and archive the media URLs promptly if retention matters to your pipeline.