Social platforms

TikTok

from $0.0060 per requesttiktok.api

TikTok data through TikTok's own endpoints: a profile and its stats, a user's posts and likes, posts for a hashtag, keyword search across posts, users, sounds, hashtags and lives, comments and replies, followers and following, a single post, and watermark free download links.

What a call costs

Billed on actual usage, minimum $0.0020 per call, capped at $2.00 per call.

a price before every call. failed calls are never charged.

When to use it

Use for anything on TikTok: a creator's recent posts, what is trending for a hashtag, search results for a keyword, comments on a video, or a follower list. Fill in only the sections you want. Each section is one flat $0.002 request no matter how many results it returns, so ask for a large count in one call rather than paging with many small ones. Posts endpoints take a user id, not a username: send usernameToId_username first, or in the same call, to resolve one.

Inputs

TikTok takes 61 fields, none of them required. Anything you leave out falls back to the tool's own default.

FieldTypeRequiredWhat it does
music_idstringoptionalMusic track lookup by ID.
post_regionstringoptionalTwo letter region for the post lookup. Defaults to GB.
post_awemeIdstringoptionalSingle post lookup by aweme_id.
profile_regionstringoptionalTwo letter region for the profile lookup. Defaults to GB.
profile_userIdstringoptionalProfile lookup by numeric user ID.
followers_countintegeroptionalFollowers to return. Does NOT change the price: flat $0.002 per call.
following_countintegeroptionalFollowed accounts to return. Does NOT change the price.
userLikes_countintegeroptionalLiked posts to return. Does NOT change the price.
userPosts_countintegeroptionalPosts to return. Does NOT change the price.
followers_userIdstringoptionalUser ID to list followers for.
following_userIdstringoptionalUser ID to list followed accounts for.
musicPosts_countintegeroptionalVideos to return for that sound. Does NOT change the price.
profile_usernamestringoptionalProfile lookup by username, without the @ sign, e.g. katyperry.
userLikes_userIdstringoptionalUser ID whose liked posts to list.
userPosts_regionstringoptionalTwo letter region for the post list. Defaults to GB.
userPosts_userIdstringoptionalUser ID whose posts to list.
followers_maxTimeintegeroptionalPagination cursor, the min_time from the previous response.
following_maxTimeintegeroptionalPagination cursor for the following list.
musicPosts_cursorintegeroptionalPagination cursor for the sound's videos.
profile_secUserIdstringoptionalProfile lookup by TikTok sec_user_id.
searchLives_countintegeroptionalLives to return. Does NOT change the price.
searchPosts_countintegeroptionalPosts to return. Does NOT change the price.
searchUsers_countintegeroptionalUsers to return. Does NOT change the price.
challengePosts_cidstringoptionalHashtag or challenge ID whose posts to list.
listComments_countintegeroptionalComments to return. Does NOT change the price.
musicPosts_musicIdstringoptionalMusic ID whose videos to list.
searchLives_offsetintegeroptionalOffset for the live search.
searchPosts_offsetintegeroptionalOffset for the post search.
searchPosts_regionstringoptionalTwo letter region for the post search. Defaults to GB.
searchSounds_countintegeroptionalSounds to return. Does NOT change the price.
searchUsers_cursorintegeroptionalPagination cursor for the user search.
followers_secUserIdstringoptionalsec_user_id alternative for the follower list.
following_secUserIdstringoptionalsec_user_id alternative for the following list.
listComments_cursorintegeroptionalPagination cursor for comments.
searchLives_keywordstringoptionalKeyword to search live streams for.
searchPosts_keywordstringoptionalKeyword to search posts for.
searchSounds_cursorintegeroptionalPagination cursor for the sound search.
searchSounds_regionstringoptionalTwo letter region for the sound search. Defaults to GB.
searchUsers_keywordstringoptionalKeyword to search users for.
userLikes_maxCursorstringoptionalPagination cursor for liked posts.
userPosts_maxCursorstringoptionalPagination cursor for the post list.
userPosts_secUserIdstringoptionalsec_user_id alternative for the post list.
challengePosts_countintegeroptionalPosts to return for that hashtag. Does NOT change the price.
commentReplies_countintegeroptionalReplies to return. Does NOT change the price.
listComments_awemeIdstringoptionalPost ID to list top level comments for.
searchHashtags_countintegeroptionalHashtags to return. Does NOT change the price.
searchPosts_sortTypeintegeroptionalSort: 0 relevance, 1 most liked, 3 date.
searchSounds_keywordstringoptionalKeyword to search sounds for.
challengePosts_cursorintegeroptionalPagination cursor for the hashtag's posts.
commentReplies_cursorintegeroptionalPagination cursor for replies.
searchHashtags_cursorintegeroptionalPagination cursor for the hashtag search.
searchHashtags_regionstringoptionalTwo letter region for the hashtag search. Defaults to GB.
searchSounds_filterByintegeroptionalSound filter: 0 all, 1 title, 2 creators.
searchSounds_sortTypeintegeroptionalSound sort: 0 relevance, 1 most used, 2 most recent, 3 shortest, 4 longest.
usernameToId_usernamestringoptionalResolve a username to the numeric user ID most other sections need.
commentReplies_awemeIdstringoptionalPost ID containing that comment.
searchHashtags_keywordstringoptionalKeyword to search hashtags for.
searchPosts_publishTimeintegeroptionalRecency filter: 0 all time, 1 yesterday, 7 this week, 30 this month, 90 last 3 months, 180 last 6 months.
searchSounds_useFiltersbooleanoptionalApply the sound search filters below.
commentReplies_commentIdstringoptionalParent comment ID to list replies for.
videoWithoutWatermark_awemeIdstringoptionalPost ID to get a watermark free download URL for.

How to call it

Connect once and your agent can reach TikTok the same way it reaches everything else in the catalog. Add Goro as an MCP connector, or paste the setup line into an agent that reads skills.

MCP

Add this server in Claude, Claude Code, or any MCP client.

https://mcp.usegoro.ai/mcp

Skill

One line in your agent's chat. It sets itself up.

set up https://usegoro.ai/SKILL.md

Or plain HTTP

POST /v1/run

{
  "endpoint": "tiktok.api",
  "input": {
    "music_id": "<music_id>"
  }
}

Run TikTok from your agent.

One balance for every tool in the catalog. Start with Build, $25 of credit for $19 a month.

Get started