# TikTok V2 API > Search public TikTok content and retrieve profiles, videos, LIVE data, music, hashtags, and location results. Page: https://docs.toolzerhub.com/reference/tiktok-v2 ## Hashtag Search public TikTok content and retrieve profiles, videos, LIVE data, music, hashtags, and location results. - [Get TikTok hashtag by ID](https://docs.toolzerhub.com/reference/tiktok-v2/hashtag/get-tik-tok-hashtag-detail.md): `GET /v2/tiktok/app/hashtag`. Returns 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. - [Get TikTok hashtag by name](https://docs.toolzerhub.com/reference/tiktok-v2/hashtag/get-tik-tok-tag-detail.md): `GET /v2/tiktok/web/hashtag`. 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. - [List TikTok hashtag videos by ID](https://docs.toolzerhub.com/reference/tiktok-v2/hashtag/get-tik-tok-hashtag-videos.md): `GET /v2/tiktok/app/hashtag/videos`. Returns public videos under the hashtag with numeric ch_id. Page with cursor and count; region localizes results. - [List TikTok hashtag videos by name](https://docs.toolzerhub.com/reference/tiktok-v2/hashtag/get-tik-tok-tag-posts.md): `GET /v2/tiktok/web/hashtag/videos`. Returns public videos under a hashtag, in itemList, for the numeric challenge_id from the hashtag details response. Page with cursor and count. - [Search TikTok hashtags](https://docs.toolzerhub.com/reference/tiktok-v2/hashtag/search-tik-tok-hashtags.md): `GET /v2/tiktok/app/search/hashtags`. Returns public TikTok hashtags matching keyword in challenge_list. Page through results with offset and count. ## Live Search public TikTok content and retrieve profiles, videos, LIVE data, music, hashtags, and location results. - [Check TikTok LIVE room status](https://docs.toolzerhub.com/reference/tiktok-v2/live/check-tik-tok-live-alive.md): `GET /v2/tiktok/web/live/alive`. Returns whether one TikTok LIVE room is currently live, in live_room_status, for the numeric room_id. - [Check TikTok LIVE status in bulk](https://docs.toolzerhub.com/reference/tiktok-v2/live/batch-check-tik-tok-live-alive.md): `GET /v2/tiktok/web/live/alive/batch`. Returns the current LIVE status of several rooms at once, in results. Pass the numeric room IDs as a comma-separated room_ids string. - [Get TikTok gift names by ID](https://docs.toolzerhub.com/reference/tiktok-v2/live/get-tik-tok-gift-names.md): `POST /v2/tiktok/web/gift/names`. Returns 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. - [Get TikTok LIVE creator rankings](https://docs.toolzerhub.com/reference/tiktok-v2/live/get-tik-tok-live-daily-rank.md): `GET /v2/tiktok/app/live/daily-rank`. Returns 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. - [Get TikTok LIVE gift rankings](https://docs.toolzerhub.com/reference/tiktok-v2/live/get-tik-tok-live-ranking-list.md): `GET /v2/tiktok/app/live/ranking`. Returns 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. - [Get TikTok LIVE room info](https://docs.toolzerhub.com/reference/tiktok-v2/live/get-tik-tok-live-room-info.md): `GET /v2/tiktok/app/live/room`. Returns 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. - [List recommended TikTok LIVE rooms](https://docs.toolzerhub.com/reference/tiktok-v2/live/get-tik-tok-live-recommend.md): `GET /v2/tiktok/web/live/recommend`. Returns TikTok LIVE rooms recommended for a topic, given as related_live_tag (for example music). Category names come from the LIVE recommendation categories endpoint. - [List TikTok LIVE categories](https://docs.toolzerhub.com/reference/tiktok-v2/live/get-tik-tok-live-recommend-tabs.md): `GET /v2/tiktok/web/live/recommend/tabs`. Returns the LIVE recommendation categories in data. When has_more is true, send the response's logid as logid for the next page. - [List TikTok LIVE chat messages](https://docs.toolzerhub.com/reference/tiktok-v2/live/get-tik-tok-live-im-fetch.md): `GET /v2/tiktok/web/live/im`. Returns 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. - [List TikTok LIVE gifts](https://docs.toolzerhub.com/reference/tiktok-v2/live/get-tik-tok-live-gift-list.md): `GET /v2/tiktok/web/live/gifts`. Returns the TikTok LIVE gift catalog in data. Pass room_id to get the gifts for one room; without it the general catalog is returned. - [Search TikTok LIVE rooms](https://docs.toolzerhub.com/reference/tiktok-v2/live/search-tik-tok-live.md): `GET /v2/tiktok/app/search/live`. Returns active TikTok LIVE rooms matching keyword. Use the returned cursor as offset for the next page while has_more is nonzero; region localizes results. - [Search TikTok LIVE rooms (web)](https://docs.toolzerhub.com/reference/tiktok-v2/live/search-tik-tok-live-web.md): `GET /v2/tiktok/web/search/live`. 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. ## Media Search public TikTok content and retrieve profiles, videos, LIVE data, music, hashtags, and location results. - [Get multiple TikTok videos by ID](https://docs.toolzerhub.com/reference/tiktok-v2/media/get-tik-tok-multi-video.md): `POST /v2/tiktok/app/video/multi`. Returns details for several public TikTok videos in one call. The JSON body is a non-empty array of video (aweme) IDs, for example ["7662422992172911903"]. - [Get TikTok explore feed](https://docs.toolzerhub.com/reference/tiktok-v2/media/get-tik-tok-explore-posts.md): `GET /v2/tiktok/web/explore`. Returns posts from TikTok's public explore feed in itemList. category_type selects a category; count sets how many posts to request. - [Get TikTok post by ID (deprecated)](https://docs.toolzerhub.com/reference/tiktok-v2/media/get-tik-tok-post-detail.md): `GET /v2/tiktok/web/post`. 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. - [Get TikTok video by ID](https://docs.toolzerhub.com/reference/tiktok-v2/media/get-tik-tok-video.md): `GET /v2/tiktok/app/video`. Returns details for one public TikTok video, looked up by aweme_id, in aweme_detail. region localizes the response. - [Get TikTok video by share URL](https://docs.toolzerhub.com/reference/tiktok-v2/media/get-tik-tok-video-by-share-url.md): `GET /v2/tiktok/app/video/by-share-url`. Returns 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. - [Get TikTok video comments](https://docs.toolzerhub.com/reference/tiktok-v2/media/get-tik-tok-video-comments.md): `GET /v2/tiktok/app/video/comments`. Returns 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. - [List TikTok comment replies](https://docs.toolzerhub.com/reference/tiktok-v2/media/get-tik-tok-video-comment-replies.md): `GET /v2/tiktok/app/video/comments/replies`. Returns replies to one TikTok comment in comments. Requires the video's item_id and the parent comment_id. Page with cursor and count. - [List TikTok post comments (web)](https://docs.toolzerhub.com/reference/tiktok-v2/media/get-tik-tok-post-comments.md): `GET /v2/tiktok/web/post/comments`. Returns comments on one public TikTok post in comments, looked up by aweme_id. current_region localizes the request; page with cursor and count. - [Resolve TikTok URL to video ID](https://docs.toolzerhub.com/reference/tiktok-v2/media/resolve-tik-tok-aweme-id.md): `GET /v2/tiktok/web/resolve/aweme-id`. Returns the video aweme_id for a TikTok video url, such as a share link or full video URL. - [Search TikTok photo posts](https://docs.toolzerhub.com/reference/tiktok-v2/media/search-tik-tok-photos.md): `GET /v2/tiktok/web/search/photos`. Returns 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. - [Search TikTok videos by keyword](https://docs.toolzerhub.com/reference/tiktok-v2/media/search-tik-tok-videos.md): `GET /v2/tiktok/app/search/videos`. Returns 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. ## Music Search public TikTok content and retrieve profiles, videos, LIVE data, music, hashtags, and location results. - [Get TikTok music chart](https://docs.toolzerhub.com/reference/tiktok-v2/music/get-tik-tok-music-chart.md): `GET /v2/tiktok/app/music/chart`. Returns a TikTok music chart in music_list. All inputs are optional: scene selects the chart, and cursor and count page through it. - [Get TikTok sound details](https://docs.toolzerhub.com/reference/tiktok-v2/music/get-tik-tok-music-detail.md): `GET /v2/tiktok/app/music`. Returns public details for one TikTok sound (music track), looked up by numeric music_id, in music_info. - [List TikTok videos by sound ID](https://docs.toolzerhub.com/reference/tiktok-v2/music/get-tik-tok-music-videos.md): `GET /v2/tiktok/app/music/videos`. Returns public videos that use the sound with numeric music_id. Page with cursor and count. - [Search TikTok sounds](https://docs.toolzerhub.com/reference/tiktok-v2/music/search-tik-tok-music.md): `GET /v2/tiktok/app/search/music`. Returns TikTok sounds matching keyword in music_info_list. Narrow with filter_by, sort_type, and region; page with offset and count. ## Search Search public TikTok content and retrieve profiles, videos, LIVE data, music, hashtags, and location results. - [Get TikTok search suggestions](https://docs.toolzerhub.com/reference/tiktok-v2/search/get-tik-tok-search-keyword-suggest.md): `GET /v2/tiktok/web/search/keyword-suggest`. Returns TikTok search autocomplete suggestions for the partial text in keyword. The result is empty when TikTok has no suggestions for it. - [List TikTok trending searches](https://docs.toolzerhub.com/reference/tiktok-v2/search/get-tik-tok-trending-searchwords.md): `GET /v2/tiktok/web/search/trending`. Returns TikTok's current trending search keywords in trending_search_words. No inputs are needed. - [Search TikTok content (web)](https://docs.toolzerhub.com/reference/tiktok-v2/search/search-tik-tok-general-web.md): `GET /v2/tiktok/web/search/general`. 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. - [Search TikTok locations](https://docs.toolzerhub.com/reference/tiktok-v2/search/search-tik-tok-location.md): `GET /v2/tiktok/app/location/search`. Returns TikTok places and location tags matching keyword in poi_info. Page with offset and count. - [Search TikTok videos, users, hashtags](https://docs.toolzerhub.com/reference/tiktok-v2/search/search-tik-tok-general.md): `GET /v2/tiktok/app/search/general`. Returns mixed public TikTok search results (videos, users, hashtags) for keyword. Sort with sort_type and filter by publish_time; page with offset and count. ## User Search public TikTok content and retrieve profiles, videos, LIVE data, music, hashtags, and location results. - [Get TikTok user country](https://docs.toolzerhub.com/reference/tiktok-v2/user/get-tik-tok-user-country.md): `GET /v2/tiktok/app/user/country`. Returns the registered country of a TikTok account, looked up by username (the handle without @). The response includes country and the account's user_id. - [Get TikTok user LIVE room](https://docs.toolzerhub.com/reference/tiktok-v2/user/get-tik-tok-user-live-detail.md): `GET /v2/tiktok/web/user/live`. Returns 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. - [Get TikTok user profile (web)](https://docs.toolzerhub.com/reference/tiktok-v2/user/get-tik-tok-user-profile.md): `GET /v2/tiktok/web/user/profile`. Returns a public TikTok profile, with stats, in userInfo. Provide unique_id (the handle) or sec_uid. - [List TikTok playlist videos](https://docs.toolzerhub.com/reference/tiktok-v2/user/get-tik-tok-user-mix.md): `GET /v2/tiktok/web/user/mix`. Returns 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. - [List TikTok similar users](https://docs.toolzerhub.com/reference/tiktok-v2/user/get-tik-tok-similar-users.md): `GET /v2/tiktok/app/user/similar`. Returns accounts TikTok suggests as similar to the user with sec_uid, in users. For the next page, send the page_token the response provides. - [List TikTok sounds by user](https://docs.toolzerhub.com/reference/tiktok-v2/user/get-tik-tok-user-music.md): `GET /v2/tiktok/app/user/music`. Returns sounds created by the TikTok user with sec_uid, in music. music can be null for accounts with none. Page with cursor and count. - [List TikTok user followers](https://docs.toolzerhub.com/reference/tiktok-v2/user/get-tik-tok-user-followers.md): `GET /v2/tiktok/app/user/followers`. Returns 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. - [List TikTok user followers (web)](https://docs.toolzerhub.com/reference/tiktok-v2/user/get-tik-tok-user-fans.md): `GET /v2/tiktok/web/user/fans`. 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. - [List TikTok user following](https://docs.toolzerhub.com/reference/tiktok-v2/user/get-tik-tok-user-following.md): `GET /v2/tiktok/app/user/following`. Returns 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. - [List TikTok user following (web)](https://docs.toolzerhub.com/reference/tiktok-v2/user/get-tik-tok-user-follow.md): `GET /v2/tiktok/web/user/following`. 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. - [List TikTok user likes](https://docs.toolzerhub.com/reference/tiktok-v2/user/get-tik-tok-user-likes.md): `GET /v2/tiktok/web/user/likes`. Returns 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. - [List TikTok user playlists](https://docs.toolzerhub.com/reference/tiktok-v2/user/get-tik-tok-user-playlists.md): `GET /v2/tiktok/web/user/playlists`. Returns the playlists (mixes) of the user with sec_uid. Page with cursor and count. The result is empty for users with no public playlists. - [List TikTok user reposts (app)](https://docs.toolzerhub.com/reference/tiktok-v2/user/get-tik-tok-user-reposts.md): `GET /v2/tiktok/app/user/reposts`. Returns videos a TikTok user reposted, looked up by numeric user_id, in aweme_list. Page with offset and count. - [List TikTok user reposts (web)](https://docs.toolzerhub.com/reference/tiktok-v2/user/get-tik-tok-user-reposts-web.md): `GET /v2/tiktok/web/user/reposts`. Returns videos reposted by the user with sec_uid, in itemList. Page with cursor and count; cover_format picks the cover image format. - [List TikTok user videos](https://docs.toolzerhub.com/reference/tiktok-v2/user/get-tik-tok-user-posts.md): `GET /v2/tiktok/app/user/posts`. Returns 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. - [Resolve TikTok URL to sec user ID](https://docs.toolzerhub.com/reference/tiktok-v2/user/resolve-tik-tok-sec-user-id.md): `GET /v2/tiktok/web/resolve/sec-user-id`. Returns the sec_user_id for a TikTok profile url, for example https://www.tiktok.com/@khaby.lame. - [Resolve TikTok URL to user ID](https://docs.toolzerhub.com/reference/tiktok-v2/user/resolve-tik-tok-user-id.md): `GET /v2/tiktok/web/resolve/user-id`. Returns the numeric user_id for a TikTok profile url, for example https://www.tiktok.com/@khaby.lame. - [Resolve TikTok URL to username](https://docs.toolzerhub.com/reference/tiktok-v2/user/resolve-tik-tok-unique-id.md): `GET /v2/tiktok/web/resolve/unique-id`. Returns the unique_id (the handle without @) for a TikTok profile url, for example https://www.tiktok.com/@khaby.lame. - [Resolve TikTok username to IDs](https://docs.toolzerhub.com/reference/tiktok-v2/user/resolve-tik-tok-user-ids.md): `GET /v2/tiktok/app/user/resolve`. Returns the numeric user_id and the sec_user_id for a TikTok username (handle without @). Other user endpoints take one of these IDs. - [Search a TikTok user's followers](https://docs.toolzerhub.com/reference/tiktok-v2/user/search-tik-tok-user-followers.md): `GET /v2/tiktok/app/user/followers/search`. Returns followers of the account with numeric user_id whose names match keyword, in results. Get user_id from the username resolve endpoint. - [Search a TikTok user's following](https://docs.toolzerhub.com/reference/tiktok-v2/user/search-tik-tok-user-following.md): `GET /v2/tiktok/app/user/following/search`. Returns accounts followed by the user with numeric user_id whose names match keyword, in results. Get user_id from the username resolve endpoint. - [Search TikTok users](https://docs.toolzerhub.com/reference/tiktok-v2/user/search-tik-tok-users.md): `GET /v2/tiktok/app/search/users`. Returns TikTok accounts matching keyword in user_list. Optional user_search_ filters narrow the match; page with offset and count. - [Search TikTok users (web)](https://docs.toolzerhub.com/reference/tiktok-v2/user/search-tik-tok-users-web.md): `GET /v2/tiktok/web/search/users`. Returns TikTok accounts matching keyword in user_list. For later pages, send the previous response's cursor and search_id.