InsightSocial APITikTok
TikTok API reference: 37 endpoints for profiles, videos, comments, followers, hashtags, search and transcripts. Per-endpoint credit prices and cURL examples.
Profiles, videos, comments, followers and following, hashtags, songs, playlists, trending and popular feeds, search, transcripts and the TikTok Ad Library.
New to the API? Read the TikTok scraper API overview for what it returns and how it compares with the official API.
Base path: /v1/tiktok/...
Quickstart
curl "https://api.insightsocial.app/v1/tiktok/profile?handle=charlidamelio" \
-H "x-api-key: $INSIGHTSOCIAL_API_KEY"Endpoints
9 of these are metered: the price depends on how much the call reads. See Credits.
6 are beta: they return the source's own structure under our naming rules (snake_case keys, string ids, ISO times where the source gives a timestamp) rather than a schema-2 entity, and their fields may change. See Schema 2.
| Endpoint | Credits | What it returns | Key parameters |
|---|---|---|---|
/profile | 10 | Returns a TikTok account's public profile: display name, bio, follower count on author.followers (or the rounded figure with followers_approximate), likes, verification, and user id. | handle, user_id |
/profile/videos | 10 | 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 | 10 | 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 | 10–30 | 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 | 10 | Returns the replies under a single TikTok comment, with each reply's text, author, likes, and timestamps. | comment_id, url |
/comment | 20–60 | 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 | 10–370 | 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 | 50 | Returns a page of popular TikTok videos with caption, view and like counts, author and thumbnail. | region |
/search/hashtag | 10 | 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 | 10 | 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 | 10–1310 | Returns TikTok accounts for a search term with username, name, avatar, followers, verification. | query |
/similar | 50 | Returns about 30 TikTok accounts similar to a given creator, each with username, display name, avatar, bio, verification, and follower, following, video and like counts. | handle |
/user/audience | 50 | Returns where a creator's followers are: the top countries in their audience, with sampled follower counts and each country's share. Beta. | handle |
/user/followers | 10 | 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 | 10 | 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 | 10 | 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. Beta. | handle |
/post/transcript | 100 | 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 | 50 | 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. Beta. | url |
/song | 10 | Returns one TikTok sound's details: title, artist, duration, how many videos use it, and its cover image. | clipId |
/song/videos | 10 | Returns videos that use a given TikTok sound, each with caption, author details, and engagement counts. | clipId |
/hashtags/popular | 60–960 | 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 | 260–450 | 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 | 10 | Returns the two letter country code for a public TikTok profile, for example US or MX. Beta. | handle |
/adlibrary/search | 50–170 | 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 | 50 | Returns one TikTok Ad Library ad: creative video, title, advertiser account, landing page, brand name, and first-shown date. | ad_id, url |
/search/suggestions | 10 | Returns the autocomplete suggestions TikTok's own search box shows for a partial query, as a list of suggestion rows. Beta. | query |
/collection/videos | 10 | 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 | 10 | 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 | 10 | 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 | 10 | 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 | 10 | Returns public TikTok videos tagged at a place, each with engagement counts, caption, author, and a playable URL. | location_id |
/effects | 10 | 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 | 10 | Returns public TikTok videos created with a camera effect, each with engagement counts, caption, author, and a playable URL. | effect_id |
/search/music | 10 | 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 | 10 | 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 | 100–1000 | 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 | 50 | Returns a TikTok profile plus its latest 10 videos in one call. Beta. | handle, user_id |