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

queries · array · required

List · Search keywords to find TikTok profiles. Same syntax as the TikTok search bar. One per line.

maxResults · integer · default: 10

Number · The maximum number of profiles to extract per query. Use 0 for all.

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

curl

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"
    ]
  }
}'

Example response

Response

{
  "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
    }
  ]
}