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

# TikTok User Search

> Search TikTok for users, returning profile data: name, nickname, signature, and follower count

`$2.4 / 1k profiles`

Search TikTok for users, returning profile data: name, nickname, signature, and follower count

## Endpoint

`POST /api/v1/agents/tiktok/user-search/run`

## Parameters

<ParamField body="queries" type="array" required>
  **List** · Search keywords to find TikTok profiles. Same syntax as the TikTok search bar. One per line.
</ParamField>

<ParamField body="maxResults" type="integer" default={10}>
  **Number** · The maximum number of profiles to extract per query. Use 0 for all.
</ParamField>

## Response columns

| Field          | Display name  | Type    |
| -------------- | ------------- | ------- |
| `profileUrl`   | Profile URL   | url     |
| `username`     | Username      | text    |
| `displayName`  | Display Name  | text    |
| `bio`          | Bio           | text    |
| `followers`    | Followers     | number  |
| `following`    | Following     | number  |
| `totalLikes`   | Total Likes   | number  |
| `videos`       | Videos        | number  |
| `friends`      | Friends       | number  |
| `likedVideos`  | Liked Videos  | number  |
| `verified`     | Verified      | boolean |
| `private`      | Private       | boolean |
| `tiktokSeller` | TikTok Seller | boolean |
| `commerceUser` | Commerce User | boolean |
| `joinedAt`     | Joined At     | number  |
| `avatar`       | Avatar        | url     |
| `bioLink`      | Bio Link      | url     |

## Example

<CodeGroup>
  ```bash curl theme={null}
  curl -X POST https://api.mindcase.co/api/v1/agents/tiktok/user-search/run \
    -H "Authorization: Bearer mk_live_abc123def456" \
    -H "Content-Type: application/json" \
    -d '{
    "params": {
      "queries": [
        "MrBeast"
      ]
    }
  }'
  ```

  ```python Python theme={null}
  import requests

  resp = requests.post(
      "https://api.mindcase.co/api/v1/agents/tiktok/user-search/run",
      headers={"Authorization": "Bearer mk_live_abc123def456"},
      json={"params": {
      "queries": [
          "MrBeast"
      ]
  }},
  )
  data = resp.json()
  ```
</CodeGroup>

### Example response

```json Response theme={null}
{
  "job_id": "job_7f3a2b1c",
  "status": "completed",
  "data": [
    {
      "profileUrl": "https://www.tiktok.com/@aljilani_1234",
      "username": "aljilani_1234",
      "displayName": "mrbeast fans",
      "bio": "No bio yet",
      "followers": 1900000,
      "following": 23,
      "totalLikes": 18200000,
      "videos": 472,
      "friends": 0,
      "likedVideos": 0,
      "verified": false,
      "private": false,
      "tiktokSeller": false,
      "commerceUser": false,
      "joinedAt": 1673428241,
      "avatar": "https://p16-common-sign.tiktokcdn-us.com/tos-alisg-avt-0068/7991c98607a32d8119a9b63c14e9c2b7~tplv-tiktokx-cropcenter:720:720.jpeg?dr=9640&refresh_token=9917b049&x-expires=1777874400&x-signature=n6OSfT1zbQ7PhXyjmSHXaHEfF%2BM%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=useast8",
      "bioLink": null
    }
  ]
}
```