> Parel documentation. Index of every page: https://parel.si/docs/llms.txt. This page in HTML: https://parel.si/docs/tools/get_tiktok_profile

# get_tiktok_profile

> A TikTok creator's public profile: followers, following, likes, video count and bio. ₹0.28 per call; a result that finds nothing is ₹0.

## What it does

The public profile of one TikTok account from its handle or user_id: data with the name, bio, verification, follower and following counts, total likes, video count and avatar.

Use it to size a creator before a collaboration or to check a competitor's presence; [`get_tiktok_videos`](https://parel.si/docs/tools/get_tiktok_videos.md) lists their videos, get_tiktok_popular_creators finds creators by follower band and country. Flat price per call; an unknown or private account is free. One to three seconds.

India: TikTok is blocked in India; creators reach their audience from other markets.

## Inputs

Generated from the contract captured from staging on 2026-11-05.

| Field | Type | Required | Description |
|---|---|---|---|
| `handle` | string | one of | The TikTok handle, without the @. |
| `user_id` | string | one of | The numeric user id, instead of handle. |

One of these sets must be complete (anything else is `invalid_input`, ₹0): `handle`; `user_id`.

## What drives the cost

Flat per call; an unknown or private account is free. A result that finds nothing is `class: "ok_free"`, ₹0. The timeout is 30 seconds.

## Price today

| | |
|---|---|
| Price today | **₹0.28** per call (`cost_paise: 28`) at ₹93.93 per US dollar on 17 November 2026 |
| Hold before the call | ₹0.42 (`hold_paise: 42`); when the call settles the real price is charged and the unused part is released |
| ₹0 when | it fails, or the provider answers but there is nothing in it (an empty list, no email, no page): `class: "ok_free"`, ₹0 |
| Timeout | 30 s, then `upstream_timeout` (₹0, retryable) |
| Over MCP | `run_tool` with `tool: "get_tiktok_profile"` |
| Over REST | `POST https://api.parel.si/v1/run` with `"tool": "get_tiktok_profile"` |
| Confirmation | not needed (the estimate is under the ₹200 threshold) |

## Request

```bash
curl https://api.parel.si/v1/run \
  -H "Authorization: Bearer $PAREL_KEY" \
  -H "Content-Type: application/json" \
  -d '{"tool":"get_tiktok_profile","input":{"handle":"stoolpresidente"}}'
```

## What comes back

`data`, as the live check of 2026-11-05 recorded it, trimmed:

```json
{
  "user": {
    "id": "6659752019493208069",
    "shortId": "",
    "uniqueId": "a_public_figure",
    "nickname": "A User 23",
    "avatarLarger": "(picture link removed)",
    "avatarMedium": "(picture link removed)",
    "avatarThumb": "(picture link removed)",
    "signature": "El Presidente/Barstool Sports Founder.",
    "createTime": 1550594547,
    "verified": true,
    "secUid": "MS4wLjABAAAAINC_ElRR-l1RCcnEjOZhNO-9wOzAMf-YHXqRY8vvG9bEhMRa6iu23TaE3JPZYXBD",
    "ftc": false,
    "relation": 0,
    "openFavorite": false,
    "bioLink": {
      "link": "https://youtu.be/oFbD0Ot7nQ8",
      "risk": 0
    },
    "commentSetting": 0,
    "commerceUserInfo": {
      "commerceUser": false
    },
    "duetSetting": 0,
    "stitchSetting": 0,
    "privateAccount": false,
    "secret": false,
    "isADVirtual": false,
    "roomId": "",
    "uniqueIdModifyTime": 0,
    "ttSeller": false,
    "downloadSetting": 0,
    "profileTab": {
      "showMusicTab": false,
      "showQuestionTab": false,
      "showPlayListTab": true
    },
    "followingVisibility": 1,
    "recommendReason": "",
    "nowInvitationCardUrl": "",
    "nickNameModifyTime": 0,
    "isEmbedBanned": false,
    "canExpPlaylist": true,
    "profileEmbedPermission": 1,
    "language": "en",
    "eventList": [],
    "suggestAccountBind": false,
    "isOrganization": 0,
    "UserStoryStatus": 0,
    "shortDramaCreator": {}
  },
  "stats": {
    "followerCount": 4800000,
    "followingCount": 99,
    "heart": 232200000,
    "heartCount": 232200000,
    "videoCount": 2594,
    "diggCount": 0,
    "friendCount": 64
  },
  "statsV2": {
    "followerCount": "4789806",
    "followingCount": "99",
    "heart": "232213590",
    "heartCount": "232213590",
    "videoCount": "2594",
    "diggCount": "0",
    "friendCount": "64"
  }
}
```

## Notes

- Flat per call; an unknown or private account is free.
- Handle without the @, or the numeric user_id.
- Pairs with get_tiktok_videos.

## Siblings

- [`get_tiktok_videos`](https://parel.si/docs/tools/get_tiktok_videos.md)
