# TikTok API > Search public TikTok content and retrieve profiles, videos, LIVE data, music, hashtags, and location results. Page: https://docs.toolzerhub.com/reference/tiktok ## Hashtag Search public TikTok content and retrieve profiles, videos, LIVE data, music, hashtags, and location results. - [Get TikTok hashtag by ID (v2)](https://docs.toolzerhub.com/reference/tiktok/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 details (v1)](https://docs.toolzerhub.com/reference/tiktok/hashtag/get-tiktok-web-hashtag.md): `GET /v1/tiktok/hashtag`. Returns 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. - [List TikTok hashtag videos (v1)](https://docs.toolzerhub.com/reference/tiktok/hashtag/get-tiktok-web-hashtag-videos.md): `GET /v1/tiktok/hashtag_videos`. Returns public videos for a hashtag, given the challenge_id from /v1/tiktok/hashtag. Page with cursor and count. - [Search TikTok hashtags (v2)](https://docs.toolzerhub.com/reference/tiktok/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. - [Get TikTok hashtag by name (v2)](https://docs.toolzerhub.com/reference/tiktok/hashtag/get-tik-tok-tag-detail.md): `GET /v2/tiktok/web/hashtag`. Deprecated: 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. - [List TikTok hashtag videos by ID (v2)](https://docs.toolzerhub.com/reference/tiktok/hashtag/get-tik-tok-hashtag-videos.md): `GET /v2/tiktok/app/hashtag/videos`. Deprecated: use /v1/tiktok/hashtag_videos instead. Returns public videos under the hashtag with numeric ch_id. Page with cursor and count; region localizes results. - [List TikTok hashtag videos by name (v2)](https://docs.toolzerhub.com/reference/tiktok/hashtag/get-tik-tok-tag-posts.md): `GET /v2/tiktok/web/hashtag/videos`. Deprecated: 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. ## Live Search public TikTok content and retrieve profiles, videos, LIVE data, music, hashtags, and location results. - [Check TikTok LIVE room status (v2)](https://docs.toolzerhub.com/reference/tiktok/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 (v2)](https://docs.toolzerhub.com/reference/tiktok/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 (v2)](https://docs.toolzerhub.com/reference/tiktok/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 (v2)](https://docs.toolzerhub.com/reference/tiktok/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 (v2)](https://docs.toolzerhub.com/reference/tiktok/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 (v2)](https://docs.toolzerhub.com/reference/tiktok/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 (v2)](https://docs.toolzerhub.com/reference/tiktok/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 (v2)](https://docs.toolzerhub.com/reference/tiktok/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 (v2)](https://docs.toolzerhub.com/reference/tiktok/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 (v2)](https://docs.toolzerhub.com/reference/tiktok/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 (v2)](https://docs.toolzerhub.com/reference/tiktok/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) (v2)](https://docs.toolzerhub.com/reference/tiktok/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. ## Music Search public TikTok content and retrieve profiles, videos, LIVE data, music, hashtags, and location results. - [Get TikTok music chart (v2)](https://docs.toolzerhub.com/reference/tiktok/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 (v2)](https://docs.toolzerhub.com/reference/tiktok/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 (v1)](https://docs.toolzerhub.com/reference/tiktok/music/get-tiktok-web-music-videos.md): `GET /v1/tiktok/music_videos`. Returns 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. - [Search TikTok sounds (v2)](https://docs.toolzerhub.com/reference/tiktok/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. - [List TikTok videos by sound ID (v2)](https://docs.toolzerhub.com/reference/tiktok/music/get-tik-tok-music-videos.md): `GET /v2/tiktok/app/music/videos`. Deprecated: use /v1/tiktok/music_videos instead. Returns public videos that use the sound with numeric music_id. Page with cursor and count. ## Search Search public TikTok content and retrieve profiles, videos, LIVE data, music, hashtags, and location results. - [Get TikTok search suggestions (v2)](https://docs.toolzerhub.com/reference/tiktok/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 (v2)](https://docs.toolzerhub.com/reference/tiktok/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) (v2)](https://docs.toolzerhub.com/reference/tiktok/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 (v2)](https://docs.toolzerhub.com/reference/tiktok/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 (v2)](https://docs.toolzerhub.com/reference/tiktok/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 profile (v1)](https://docs.toolzerhub.com/reference/tiktok/user/get-tik-tok-web-profile.md): `GET /v1/tiktok/profile`. Returns a TikTok profile's public statistics: followers, following, likes, and video count. An unknown username returns data: null. - [Get TikTok user country (v2)](https://docs.toolzerhub.com/reference/tiktok/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 (v2)](https://docs.toolzerhub.com/reference/tiktok/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. - [List TikTok playlist videos (v2)](https://docs.toolzerhub.com/reference/tiktok/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 (v2)](https://docs.toolzerhub.com/reference/tiktok/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. A 404 means TikTok keeps no similar-user list for this account; it is final, so do not retry. - [List TikTok sounds by user (v2)](https://docs.toolzerhub.com/reference/tiktok/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 (v2)](https://docs.toolzerhub.com/reference/tiktok/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 following (v2)](https://docs.toolzerhub.com/reference/tiktok/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 likes (v2)](https://docs.toolzerhub.com/reference/tiktok/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 (v2)](https://docs.toolzerhub.com/reference/tiktok/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) (v2)](https://docs.toolzerhub.com/reference/tiktok/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) (v2)](https://docs.toolzerhub.com/reference/tiktok/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 (v2)](https://docs.toolzerhub.com/reference/tiktok/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 (v2)](https://docs.toolzerhub.com/reference/tiktok/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 (v2)](https://docs.toolzerhub.com/reference/tiktok/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 (v2)](https://docs.toolzerhub.com/reference/tiktok/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 (v2)](https://docs.toolzerhub.com/reference/tiktok/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 (v2)](https://docs.toolzerhub.com/reference/tiktok/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 (v2)](https://docs.toolzerhub.com/reference/tiktok/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 (v2)](https://docs.toolzerhub.com/reference/tiktok/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) (v2)](https://docs.toolzerhub.com/reference/tiktok/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. - [Get TikTok user profile (web) (v2)](https://docs.toolzerhub.com/reference/tiktok/user/get-tik-tok-user-profile.md): `GET /v2/tiktok/web/user/profile`. Deprecated: use /v1/tiktok/profile instead. Returns a public TikTok profile, with stats, in userInfo. Provide unique_id (the handle) or sec_uid. - [List TikTok user followers (web) (v2)](https://docs.toolzerhub.com/reference/tiktok/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 (web) (v2)](https://docs.toolzerhub.com/reference/tiktok/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. ## Video Search public TikTok content and retrieve profiles, videos, LIVE data, music, hashtags, and location results. - [Get multiple TikTok videos by ID (v2)](https://docs.toolzerhub.com/reference/tiktok/video/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 (v2)](https://docs.toolzerhub.com/reference/tiktok/video/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 video by ID (v2)](https://docs.toolzerhub.com/reference/tiktok/video/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 (v2)](https://docs.toolzerhub.com/reference/tiktok/video/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 (v2)](https://docs.toolzerhub.com/reference/tiktok/video/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. - [Get TikTok video details (v1)](https://docs.toolzerhub.com/reference/tiktok/video/get-tik-tok-web-video.md): `GET /v1/tiktok/video`. Returns 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. - [List TikTok comment replies (v2)](https://docs.toolzerhub.com/reference/tiktok/video/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) (v2)](https://docs.toolzerhub.com/reference/tiktok/video/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 (v2)](https://docs.toolzerhub.com/reference/tiktok/video/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 (v2)](https://docs.toolzerhub.com/reference/tiktok/video/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 (v2)](https://docs.toolzerhub.com/reference/tiktok/video/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. - [Get TikTok post by ID (deprecated) (v2)](https://docs.toolzerhub.com/reference/tiktok/video/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.