TikTok API
Search public TikTok content and retrieve profiles, videos, LIVE data, music, hashtags, and location results.
65 endpoints
Endpoints
Each endpoint links to its request parameters, response schema, and code examples.
Hashtag
7 endpoints- Get TikTok hashtag by ID (v2)GETReturns the public details of one TikTok hashtag, looked up by numeric ch_id (the challenge id from a hashtag search result). region localizes the response.
/v2/tiktok/app/hashtag2 cr - Get TikTok hashtag details (v1)GETReturns one hashtag record, including the numeric id that /v1/tiktok/hashtag_videos takes as challenge_id. Returns data: null when the hashtag does not exist.
/v1/tiktok/hashtag1 cr - List TikTok hashtag videos (v1)GETReturns public videos for a hashtag, given the challenge_id from /v1/tiktok/hashtag. Page with cursor and count.
/v1/tiktok/hashtag_videos1 cr - Search TikTok hashtags (v2)GETReturns public TikTok hashtags matching keyword in challenge_list. Page through results with offset and count.
/v2/tiktok/app/search/hashtags2 cr Get TikTok hashtag by name (v2)DeprecatedGETDeprecated: use /v1/tiktok/hashtag instead. Returns public details of one TikTok hashtag, looked up by tag_name (without #), in challengeInfo. It includes the challenge id used by the hashtag videos endpoint./v2/tiktok/web/hashtag2 crList TikTok hashtag videos by ID (v2)DeprecatedGETDeprecated: use /v1/tiktok/hashtag_videos instead. Returns public videos under the hashtag with numeric ch_id. Page with cursor and count; region localizes results./v2/tiktok/app/hashtag/videos2 crList TikTok hashtag videos by name (v2)DeprecatedGETDeprecated: use /v1/tiktok/hashtag_videos instead. Returns public videos under a hashtag, in itemList, for the numeric challenge_id from the hashtag details response. Page with cursor and count./v2/tiktok/web/hashtag/videos2 cr
Live
12 endpoints- Check TikTok LIVE room status (v2)GETReturns whether one TikTok LIVE room is currently live, in live_room_status, for the numeric room_id.
/v2/tiktok/web/live/alive3 cr - Check TikTok LIVE status in bulk (v2)GETReturns the current LIVE status of several rooms at once, in results. Pass the numeric room IDs as a comma-separated room_ids string.
/v2/tiktok/web/live/alive/batch75 cr - Get TikTok gift names by ID (v2)POSTReturns the display names of TikTok LIVE gifts for the gift_ids array in the JSON body. Maximum 1000 IDs per request; 50 per call is recommended.
/v2/tiktok/web/gift/names38 cr - Get TikTok LIVE creator rankings (v2)GETReturns a TikTok LIVE ranking board. Every input is optional: rank_type, region_type, and gap_interval pick the board and time window, and room_id or anchor_id scope it to one room or host.
/v2/tiktok/app/live/daily-rank2 cr - Get TikTok LIVE gift rankings (v2)GETReturns the gifting ranking for one TikTok LIVE room. Requires the numeric room_id and the host's anchor_id, both available from the LIVE room info response.
/v2/tiktok/app/live/ranking2 cr - Get TikTok LIVE room info (v2)GETReturns public metadata for one TikTok LIVE room, looked up by numeric room_id. The id comes from a LIVE search result or a user's LIVE detail.
/v2/tiktok/app/live/room2 cr - List recommended TikTok LIVE rooms (v2)GETReturns TikTok LIVE rooms recommended for a topic, given as related_live_tag (for example music). Category names come from the LIVE recommendation categories endpoint.
/v2/tiktok/web/live/recommend2 cr - List TikTok LIVE categories (v2)GETReturns the LIVE recommendation categories in data. When has_more is true, send the response's logid as logid for the next page.
/v2/tiktok/web/live/recommend/tabs2 cr - List TikTok LIVE chat messages (v2)GETReturns chat messages from one TikTok LIVE room, looked up by numeric room_id. user_unique_id and resp_content_type adjust the request. The result can be empty when the room is not live.
/v2/tiktok/web/live/im2 cr - List TikTok LIVE gifts (v2)GETReturns the TikTok LIVE gift catalog in data. Pass room_id to get the gifts for one room; without it the general catalog is returned.
/v2/tiktok/web/live/gifts38 cr - Search TikTok LIVE rooms (v2)GETReturns active TikTok LIVE rooms matching keyword. Use the returned cursor as offset for the next page while has_more is nonzero; region localizes results.
/v2/tiktok/app/search/live2 cr - Search TikTok LIVE rooms (web) (v2)GETReturns active TikTok LIVE rooms matching keyword. For the next page, send the response's cursor as offset and its search_id as search_id while has_more is nonzero.
/v2/tiktok/web/search/live2 cr
Music
5 endpoints- Get TikTok music chart (v2)GETReturns a TikTok music chart in music_list. All inputs are optional: scene selects the chart, and cursor and count page through it.
/v2/tiktok/app/music/chart2 cr - Get TikTok sound details (v2)GETReturns public details for one TikTok sound (music track), looked up by numeric music_id, in music_info.
/v2/tiktok/app/music2 cr - List TikTok videos by sound (v1)GETReturns public videos that use a sound, given its music_id (the music.id on any returned video). Page with cursor and count. An unknown sound returns data: null.
/v1/tiktok/music_videos1 cr - Search TikTok sounds (v2)GETReturns TikTok sounds matching keyword in music_info_list. Narrow with filter_by, sort_type, and region; page with offset and count.
/v2/tiktok/app/search/music2 cr List TikTok videos by sound ID (v2)DeprecatedGETDeprecated: use /v1/tiktok/music_videos instead. Returns public videos that use the sound with numeric music_id. Page with cursor and count./v2/tiktok/app/music/videos2 cr
Search
5 endpoints- Get TikTok search suggestions (v2)GETReturns TikTok search autocomplete suggestions for the partial text in keyword. The result is empty when TikTok has no suggestions for it.
/v2/tiktok/web/search/keyword-suggest2 cr - List TikTok trending searches (v2)GETReturns TikTok's current trending search keywords in trending_search_words. No inputs are needed.
/v2/tiktok/web/search/trending2 cr - Search TikTok content (web) (v2)GETReturns mixed public TikTok search results for keyword. For the next page, send the response's cursor as offset and its search_id as search_id while has_more is nonzero.
/v2/tiktok/web/search/general2 cr - Search TikTok locations (v2)GETReturns TikTok places and location tags matching keyword in poi_info. Page with offset and count.
/v2/tiktok/app/location/search2 cr - Search TikTok videos, users, hashtags (v2)GETReturns mixed public TikTok search results (videos, users, hashtags) for keyword. Sort with sort_type and filter by publish_time; page with offset and count.
/v2/tiktok/app/search/general2 cr
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
Video
12 endpoints- Get multiple TikTok videos by ID (v2)POSTReturns details for several public TikTok videos in one call. The JSON body is a non-empty array of video (aweme) IDs, for example ["7662422992172911903"].
/v2/tiktok/app/video/multi38 cr - Get TikTok explore feed (v2)GETReturns posts from TikTok's public explore feed in itemList. category_type selects a category; count sets how many posts to request.
/v2/tiktok/web/explore2 cr - Get TikTok video by ID (v2)GETReturns details for one public TikTok video, looked up by aweme_id, in aweme_detail. region localizes the response.
/v2/tiktok/app/video2 cr - Get TikTok video by share URL (v2)GETReturns details of one public TikTok video, resolved from a share_url such as a vm.tiktok.com short link or a full video URL. Details are in aweme_details.
/v2/tiktok/app/video/by-share-url2 cr - Get TikTok video comments (v2)GETReturns top-level comments on one public TikTok video in comments, looked up by aweme_id. Page with cursor and count; use the comment replies endpoint for replies.
/v2/tiktok/app/video/comments2 cr - Get TikTok video details (v1)GETReturns one TikTok video's public detail. Requires the author's username and the video_id from its URL. data is null when the video is unavailable or removed.
/v1/tiktok/video1 cr - List TikTok comment replies (v2)GETReturns replies to one TikTok comment in comments. Requires the video's item_id and the parent comment_id. Page with cursor and count.
/v2/tiktok/app/video/comments/replies2 cr - List TikTok post comments (web) (v2)GETReturns comments on one public TikTok post in comments, looked up by aweme_id. current_region localizes the request; page with cursor and count.
/v2/tiktok/web/post/comments2 cr - Resolve TikTok URL to video ID (v2)GETReturns the video aweme_id for a TikTok video url, such as a share link or full video URL.
/v2/tiktok/web/resolve/aweme-id2 cr - Search TikTok photo posts (v2)GETReturns public TikTok photo posts matching keyword in item_list. For later pages, send the offset and search_id from the previous response; count sets the page size.
/v2/tiktok/web/search/photos2 cr - Search TikTok videos by keyword (v2)GETReturns public TikTok videos matching keyword. Order with sort_type, filter by publish_time and region; continue with the response cursor as offset while has_more is nonzero.
/v2/tiktok/app/search/videos2 cr Get TikTok post by ID (deprecated) (v2)DeprecatedGETReturns one public TikTok post, looked up by item_id, in itemInfo. region localizes the response. Deprecated: use /v2/tiktok/app/video for the same post./v2/tiktok/web/post2 cr
What you can build
- Research creators, videos, hashtags, and sounds.
- Collect public engagement data for content comparisons.
Make your first request
Replace the placeholders with your input values. The endpoint reference explains each input and the returned fields.
curl -X GET "https://api.toolzerhub.com/v1/tiktok/profile?username=<username>" -H "x-api-key: $TOOLZERHUB_API_KEY"Need a key? Create an account, then review credits and responses and errors.