TikTok

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.

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.

Price

$0.0060 per request. That is the rate you pay for each request the call returns, so the total depends on how many it produces. Billing follows actual usage, so a call that returns fewer requests costs less. discover and inspect also return a ceiling for your specific request, which is a maximum you will never be charged above.

Input

Field	Type	Notes
`music_id`	`string`	Music track lookup by ID.
`post_region`	`string`	Two letter region for the post lookup. Defaults to GB.
`post_awemeId`	`string`	Single post lookup by aweme_id.
`profile_region`	`string`	Two letter region for the profile lookup. Defaults to GB.
`profile_userId`	`string`	Profile lookup by numeric user ID.
`followers_count`	`integer`	Followers to return. Does NOT change the price: flat $0.002 per call.
`following_count`	`integer`	Followed accounts to return. Does NOT change the price.
`userLikes_count`	`integer`	Liked posts to return. Does NOT change the price.
`userPosts_count`	`integer`	Posts to return. Does NOT change the price.
`followers_userId`	`string`	User ID to list followers for.
`following_userId`	`string`	User ID to list followed accounts for.
`musicPosts_count`	`integer`	Videos to return for that sound. Does NOT change the price.
`profile_username`	`string`	Profile lookup by username, without the @ sign, e.g. katyperry.
`userLikes_userId`	`string`	User ID whose liked posts to list.

Goro forwards your input to the underlying tool unchanged, so any field the tool accepts works here even if it is not listed above.

Example

curl -X POST https://api.usegoro.ai/v1/run \
  -H "Authorization: Bearer $GORO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"slug":"tiktok.api","input":{}}'

Response

One row of the response. Values are illustrative.

{
  "user": {
    "uid": "7664638705177150477",
    "region": "US",
    "nickname": "NASA",
    "signature": "Making the seemingly impossible, possible.",
    "unique_id": "nasa",
    "aweme_count": 16,
    "follower_count": 329461,
    "following_count": 20,
    "favoriting_count": 0,
    "enterprise_verify_reason": "institution account"
  },
  "extra": {
    "now": 1785422006000,
    "logid": "20260730143325341C26D769F440188C83"
  },
  "status_msg": "",
  "status_code": 0
}

Guide

CLI reference

API reference

Tools

Price

Input

Example

Response

​Price

​Input

​Example

​Response

Price

Input

Example

Response