TikTok tools
Read TikTok accounts, videos, comments, transcripts and audiences from your agent: each tool's parameters, what it returns and what it costs.
Read public TikTok accounts, videos and comments, with transcripts and audience data. To check a creator, get the profile with tiktok_get_profile, then their videos with tiktok_get_videos, then tiktok_get_audience to see which countries their audience is in.
Each call costs what the data provider charges for it, and each tool below gives its cost. If TikTok has no way to answer a question, there is no tool for it.
To connect these tools to your agent, see the TikTok MCP page.
| Tool | What it does | Cost |
|---|---|---|
tiktok_get_profile | Get a TikTok account | From 1 credit |
tiktok_get_videos | Get an account's videos | From 1 credit |
tiktok_get_video | Get a TikTok video | From 10 credits |
tiktok_get_comments | Get a video's comments | From 1 credit |
tiktok_search_videos | Search TikTok videos | From 1 credit |
tiktok_get_transcript | Get a video's transcript | From 1 credit |
tiktok_get_followers | Get an account's followers | From 1 credit |
tiktok_get_audience | Get an account's audience | From 26 credits |
Get a TikTok account
tiktok_get_profileOne TikTok account: its follower count, its lifetime likes and how many videos it has posted.
Sizing a creator or a brand on TikTok, checking a handle is real, reading a bio before outreach.
- The account's videos, use
tiktok_get_videos. - Where its audience is, use
tiktok_get_audience. - Finding accounts by topic, use
tiktok_search_videosand read the authors.
One record. The account's handle, name, bio, verified, followers, following, posts_count, likes, views, website (the link in bio) and links, with other profile fields where TikTok fills them. null or empty = the platform does not publish it.
1 credit. Cached 24 hours.
Parameters
| Parameter | Default and notes |
|---|---|
handle | The account's handle, with or without the @. |
It also takes the common parameters max_credits and dry_run.
{
"handle": "@gymshark"
}Get an account's videos
tiktok_get_videosThe videos one TikTok account has posted, newest or most viewed first.
"what has this creator posted", judging how often a brand posts, pulling a creator's recent work before a partnership.
- One video in full, use
tiktok_get_video. - What was said in it, use
tiktok_get_transcript. - Videos by topic rather than by account, use
tiktok_search_videos.
A list. Each row has videos with author and author_followers, created_at, text (cut at 2000 characters), likes, comments, shares, saves, views, media, duration_s, links, transcript and top_comments[]. saves is how many people saved it; music is the sound and collaborators the branded-content partners. null or empty = the platform does not publish it.
1 credit per page. Cached 6 hours.
Parameters
| Parameter | Default and notes |
|---|---|
handle | The account's handle, with or without the @. |
sort | One of latest, popular. Newest first, or most viewed first. Default latest. |
It also takes the common parameters cursor, max_credits and dry_run.
{
"handle": "gymshark",
"sort": "popular"
}Get a TikTok video
tiktok_get_videoOne TikTok video with its engagement: views, likes, comments, shares and its length.
A row from a search or a listing is worth the detail, or you have a URL and nothing else.
- What was said in it, use
tiktok_get_transcript. - The replies, use
tiktok_get_comments.
One record with Each row has the one video, with author and author_followers, created_at, text (cut at 2000 characters), likes, comments, shares, saves, views, media, duration_s, links, transcript and top_comments[]. saves is how many people saved it; music is the sound and collaborators the branded-content partners. null or empty = the platform does not publish it.
10 credits when the vendor has to fetch the media, 1 when it does not. The estimate is the higher one, so max_credits never surprises you. Cached 6 hours.
Parameters
| Parameter | Default and notes |
|---|---|
url | Required. The full URL of a TikTok video. |
It also takes the common parameters max_credits and dry_run.
{
"url": "https://www.tiktok.com/@gymshark/video/7517114944362499342"
}Get a video's comments
tiktok_get_commentsThe comments on one TikTok video.
Reading what an audience actually said, finding objections and questions under a creator's post.
- Comments across many videos (there is no such search on TikTok).
- The video itself, use
tiktok_get_video.
A list. Each row has one comment each: author, created_at, text (cut at 2000 characters), likes, replies, and parent_id and depth for a reply.
1 credit per page. Cached 6 hours.
Parameters
| Parameter | Default and notes |
|---|---|
url | Required. The full URL of a TikTok video. |
It also takes the common parameters cursor, max_credits and dry_run.
{
"url": "https://www.tiktok.com/@gymshark/video/7517114944362499342"
}Search TikTok videos
tiktok_search_videosTikTok videos matching a keyword, ranked by the platform's own search.
"what is TikTok saying about X", finding creators in a category, watching a product or a brand name.
- One account's own videos, use
tiktok_get_videos. - A complete window of everything posted (TikTok search is ranked and never complete).
A list, ranked. Each row has videos with author and author_followers, created_at, text (cut at 2000 characters), likes, comments, shares, saves, views, media, duration_s, links, transcript and top_comments[]. saves is how many people saved it, music the sound, and author_followers sizes each creator without another call. null or empty = the platform does not publish it.
1 credit per page. Cached 6 hours.
Parameters
| Parameter | Default and notes |
|---|---|
query | Required. What to search TikTok for. |
since | One of day, week, month, year, all. How far back to search. Default month. |
sort | One of relevance, latest, popular. Ranking of the results. Default relevance. |
It also takes the common parameters cursor, max_credits and dry_run.
{
"query": "creatine gummies",
"since": "month",
"sort": "popular"
}Get a video's transcript
tiktok_get_transcriptWhat is said out loud in one TikTok video, as text.
Reading a video without watching it, pulling the claims or the hook out of an ad or a review.
- The video's numbers, use
tiktok_get_video. - The written caption, which
tiktok_get_videoalready returns as text.
One record with platform, url, language, text (the full transcript, uncut). NoData when the video carries no speech the platform kept.
1 credit, or 11 with ai_fallback. Cached 30 days.
Parameters
| Parameter | Default and notes |
|---|---|
url | Required. The full URL of a TikTok video. |
language | Language code of the transcript to prefer, when the platform has several. |
ai_fallback | Default false. Transcribe the audio when TikTok holds no transcript. Adds 10 credits and covers videos up to 2 minutes. |
It also takes the common parameters max_credits and dry_run.
{
"url": "https://www.tiktok.com/@gymshark/video/7517114944362499342"
}Get an account's followers
tiktok_get_followersThe accounts that follow one TikTok account, with their own follower counts.
Judging whether a creator's audience is real, looking for the notable accounts in a following.
- Where an audience is in the world, use
tiktok_get_audience. - How big the account is, use
tiktok_get_profile.
A list. Each row has handle, name, url, followers, following, country (the account's region code), bio.
1 credit per page. Cached 7 days.
Parameters
| Parameter | Default and notes |
|---|---|
handle | Required. The account's handle, with or without the @. |
It also takes the common parameters cursor, max_credits and dry_run.
{
"handle": "gymshark"
}Get an account's audience
tiktok_get_audienceWhere one TikTok account's audience is, by country.
Checking a creator reaches the market you sell in, before paying for a partnership.
- Who the followers are, use
tiktok_get_followers. - The account's size, use
tiktok_get_profile.
A list, largest share first. Each row has country, country_code, share (percent, a decimal), count. The split comes from a sample of followers, a few hundred for an account of millions: count is followers in that sample, not in the account, so read share and ignore count as a size.
26 credits, because the vendor charges 26 for this one call. Check the handle with tiktok_get_profile first. Cached 7 days.
Parameters
| Parameter | Default and notes |
|---|---|
handle | Required. The account's handle, with or without the @. |
It also takes the common parameters max_credits and dry_run.
{
"handle": "gymshark"
}