> ## Documentation Index
> Fetch the complete documentation index at: https://docs.usegoro.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 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, 

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.

<Note>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.</Note>

## 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      | Required | 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.                                     |

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

## Example

```bash theme={null}
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.

```json theme={null}
{
  "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
}
```