InsightSocial APITikTok
36 TikTok endpoints on one API key.
Profiles, videos, comments, followers and following, hashtags, songs, playlists, trending and popular feeds, search, transcripts and the TikTok Ad Library.
Base path: /v1/tiktok/...
Quickstart
curl "https://api.insightsocial.app/v1/tiktok/profile?handle=charlidamelio" \
-H "x-api-key: $INSIGHTSOCIAL_API_KEY"Endpoints
11 of these are metered: the price depends on how much the call reads. See Credits.
| Endpoint | Credits | What it returns | Key parameters |
|---|---|---|---|
/profile | 20 | Returns a TikTok account's public profile: display name, bio, follower count on author.followers (or the rounded figure with author.ext.followers_approximate), likes, verification, and user id. | handle, user_id |
/profile/videos | 20–100 | Returns a page of an account's recent public videos, each with caption, view, like, comment and share counts, and a thumbnail URL. | handle, user_id |
/post | 20 | Returns one TikTok video in full: caption, engagement counts, author, sound, video metadata, and any on-screen text the creator typed with TikTok's text tool (post.ext.on_screen_texts). | url |
/post/comments | 20–140 | Returns a page of comments on one TikTok video, each with the commenter's username, comment text, like count, reply count, and timestamp. | url |
/video/comment/replies | 20–100 | Returns the replies under a single TikTok comment, with each reply's text, author, likes, and timestamps. | comment_id, url |
/comment | 40–120 | Returns one TikTok comment with its current like count, reply count, pinned flag, author, and timestamp, found by link, by id, or by its text. | comment_url, post_url |
/search | 20–840 | Returns TikTok videos matching a keyword, each with caption, view and like counts, author details, a thumbnail, and post.ext.region (the country the video is registered to). | query |
/trending | 100 | Returns a page of popular TikTok videos with caption, view and like counts, author and thumbnail. | region |
/search/hashtag | 20–100 | Returns TikTok videos posted under a given hashtag, each with caption, view, like, comment and share counts, author details, and a thumbnail. | hashtag |
/search/top | 20 | Returns the videos TikTok ranks highest for a keyword on its Top tab, each with caption, author, engagement counts, a music id, and post.ext.region (the country the video is registered to). | query |
/search/users | 20–2000 | Returns TikTok accounts for a search term with username, name, avatar, followers, verification. | query |
/user/audience | 100 | Returns where a creator's followers are: the top countries in their audience, with sampled follower counts and each country's share. | handle |
/user/followers | 20 | Returns a page of accounts that follow a TikTok user, each with username, display name, avatar, and its own follower count. | handle, user_id |
/user/following | 20 | Returns a page of accounts a TikTok user follows, each with username, display name, avatar, and its own follower count. | handle, user_id |
/user/live | 20 | Returns a TikTok account's live room in the platform's own shape: cover image, title, start time, status code, viewer and entry counts, stream ids, and the host's profile. | handle |
/post/transcript | 200 | Returns the spoken text of a TikTok video from its captions, with an option to fall back to AI transcription when no captions exist. | url |
/video/screen-text | 100 | Returns the text shown on the video itself: native text stickers plus AI OCR of the cover frame, so burned-in editor captions are caught too. | url |
/song | 20 | Returns one TikTok sound's details: title, artist, duration, how many videos use it, and its cover image. | clipId |
/song/videos | 20 | Returns videos that use a given TikTok sound, each with caption, author details, and engagement counts. | clipId |
/hashtags/popular | 120–1920 | Returns TikTok's trending-hashtag board for one of 27 markets over 7, 30 or 90 days: each hashtag's rank, window post and view counts, daily popularity curve, industry board and top creators. | — |
/videos/popular | 520–900 | Returns TikTok's Top Videos board for the US, Japan, Vietnam, Thailand or Indonesia over 7 or 30 days: each video's rank, lifetime and window views, organic views, engagement rate and creator. | — |
/profile/region | 20 | Returns the two letter country code for a public TikTok profile, for example US or MX. | handle |
/adlibrary/search | 100–340 | Returns TikTok Ad Library ads matching a keyword or advertiser name, each with creative, title, advertiser, impressions and date; include=ad adds the brand, landing page and advertiser link. | query, advertiser_name |
/adlibrary/ad | 100 | Returns one TikTok Ad Library ad: creative video, title, advertiser account, landing page, brand name, and first-shown date. | ad_id, url |
/search/suggestions | 20 | Returns the autocomplete suggestions TikTok's own search box shows for a partial query, as a list of suggestion rows. | query |
/collection/videos | 20 | Returns the public videos inside a TikTok collection, each with caption, play like comment share and save counts, author, and a playable URL. | url |
/profile/playlists | 20 | Returns the playlists a TikTok creator has published on their profile, each with its playlist id, its name, and the number of videos it holds. | handle, user_id |
/playlist/videos | 20 | Returns the videos inside one of a creator's profile playlists, in playlist order, each with engagement counts, caption, author, and a playable URL. | playlist_id, handle, user_id |
/user/liked | 20 | Returns the videos a TikTok account has liked, newest first, each carrying its own third party author, engagement counts, caption, and a playable URL. | handle, user_id |
/location/posts | 20 | Returns public TikTok videos tagged at a place, each with engagement counts, caption, author, and a playable URL. | location_id |
/effects | 20 | Returns TikTok camera effects by id, each with its name, its designer, the views of videos made with it, and how many such videos exist. | ids |
/effect/videos | 20 | Returns public TikTok videos created with a camera effect, each with engagement counts, caption, author, and a playable URL. | effect_id |
/search/music | 20 | Returns TikTok sounds matching a keyword, each with title, artist, duration, cover art, a preview audio URL, and how many videos use it. | query |
/hashtag | 20 | Returns TikTok's own record for a hashtag, with its display name, its description where one exists, the live total views under the tag, and how many videos carry it. | hashtag, hashtag_id |
/ads/top | 200–2000 | Returns TikTok's Creative Center leaderboard of top-performing ads for a market and time window, each with click-through rate, board rank, like count, industry, objective, and the ad video. | — |
/profile/full | 100 | Returns a TikTok profile plus its latest 10 videos and computed stats: engagement rate by views and by followers, posting cadence, the top post, and the mix of formats. | handle, user_id |