TikTok V2 API
Search public TikTok content and retrieve profiles, videos, LIVE data, music, hashtags, and location results.
60 endpoints
Endpoints
Each endpoint links to its request parameters, response schema, and code examples.
Hashtag
5 endpoints- Get TikTok hashtag by IDReturns 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 crGET - Get TikTok hashtag by nameReturns 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 crGET - List TikTok hashtag videos by IDReturns public videos under the hashtag with numeric ch_id. Page with cursor and count; region localizes results.
/v2/tiktok/app/hashtag/videos2 crGET - List TikTok hashtag videos by nameReturns 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 crGET - Search TikTok hashtagsReturns public TikTok hashtags matching keyword in challenge_list. Page through results with offset and count.
/v2/tiktok/app/search/hashtags2 crGET
Live
12 endpoints- Check TikTok LIVE room statusReturns whether one TikTok LIVE room is currently live, in live_room_status, for the numeric room_id.
/v2/tiktok/web/live/alive3 crGET - Check TikTok LIVE status in bulkReturns 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 crGET - Get TikTok gift names by IDReturns 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 crPOST - Get TikTok LIVE creator rankingsReturns 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 crGET - Get TikTok LIVE gift rankingsReturns 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 crGET - Get TikTok LIVE room infoReturns 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 crGET - List recommended TikTok LIVE roomsReturns 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 crGET - List TikTok LIVE categoriesReturns 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 crGET - List TikTok LIVE chat messagesReturns 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 crGET - List TikTok LIVE giftsReturns 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 crGET - Search TikTok LIVE roomsReturns 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 crGET - Search TikTok LIVE rooms (web)Returns 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 crGET
Media
11 endpoints- Get multiple TikTok videos by IDReturns 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 crPOST - Get TikTok explore feedReturns 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 crGET - Get TikTok post by ID (deprecated)Returns 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 crGET - Get TikTok video by IDReturns details for one public TikTok video, looked up by aweme_id, in aweme_detail. region localizes the response.
/v2/tiktok/app/video2 crGET - Get TikTok video by share URLReturns 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 crGET - Get TikTok video commentsReturns 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 crGET - List TikTok comment repliesReturns 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 crGET - List TikTok post comments (web)Returns 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 crGET - Resolve TikTok URL to video IDReturns the video aweme_id for a TikTok video url, such as a share link or full video URL.
/v2/tiktok/web/resolve/aweme-id2 crGET - Search TikTok photo postsReturns 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 crGET - Search TikTok videos by keywordReturns 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 crGET
Music
4 endpoints- Get TikTok music chartReturns 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 crGET - Get TikTok sound detailsReturns public details for one TikTok sound (music track), looked up by numeric music_id, in music_info.
/v2/tiktok/app/music2 crGET - List TikTok videos by sound IDReturns public videos that use the sound with numeric music_id. Page with cursor and count.
/v2/tiktok/app/music/videos2 crGET - Search TikTok soundsReturns 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 crGET
Search
5 endpoints- Get TikTok search suggestionsReturns 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 crGET - List TikTok trending searchesReturns TikTok's current trending search keywords in trending_search_words. No inputs are needed.
/v2/tiktok/web/search/trending2 crGET - Search TikTok content (web)Returns 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 crGET - Search TikTok locationsReturns TikTok places and location tags matching keyword in poi_info. Page with offset and count.
/v2/tiktok/app/location/search2 crGET - Search TikTok videos, users, hashtagsReturns 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 crGET
User
23 endpoints- Get TikTok user countryReturns 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 crGET - Get TikTok user LIVE roomReturns 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 crGET - Get TikTok user profile (web)Returns a public TikTok profile, with stats, in userInfo. Provide unique_id (the handle) or sec_uid.
/v2/tiktok/web/user/profile2 crGET - List TikTok playlist videosReturns 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 crGET - List TikTok similar usersReturns accounts TikTok suggests as similar to the user with sec_uid, in users. For the next page, send the page_token the response provides.
/v2/tiktok/app/user/similar2 crGET - List TikTok sounds by userReturns 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 crGET - List TikTok user followersReturns 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 crGET - List TikTok user followers (web)Returns 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 crGET - List TikTok user followingReturns 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 crGET - List TikTok user following (web)Returns 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 crGET - List TikTok user likesReturns 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 crGET - List TikTok user playlistsReturns 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 crGET - List TikTok user reposts (app)Returns videos a TikTok user reposted, looked up by numeric user_id, in aweme_list. Page with offset and count.
/v2/tiktok/app/user/reposts2 crGET - List TikTok user reposts (web)Returns 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 crGET - List TikTok user videosReturns 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 crGET - Resolve TikTok URL to sec user IDReturns the sec_user_id for a TikTok profile url, for example https://www.tiktok.com/@khaby.lame.
/v2/tiktok/web/resolve/sec-user-id2 crGET - Resolve TikTok URL to user IDReturns the numeric user_id for a TikTok profile url, for example https://www.tiktok.com/@khaby.lame.
/v2/tiktok/web/resolve/user-id2 crGET - Resolve TikTok URL to usernameReturns 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 crGET - Resolve TikTok username to IDsReturns 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 crGET - Search a TikTok user's followersReturns 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 crGET - Search a TikTok user's followingReturns 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 crGET - Search TikTok usersReturns TikTok accounts matching keyword in user_list. Optional user_search_ filters narrow the match; page with offset and count.
/v2/tiktok/app/search/users2 crGET - Search TikTok users (web)Returns TikTok accounts matching keyword in user_list. For later pages, send the previous response's cursor and search_id.
/v2/tiktok/web/search/users2 crGET
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/v2/tiktok/app/search/hashtags?keyword=<keyword>" -H "x-api-key: $TOOLZERHUB_API_KEY"Need a key? Create an account, then review credits and responses and errors.