Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.mindcase.co/llms.txt

Use this file to discover all available pages before exploring further.

$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

FieldDisplay nameType
profileUrlProfile URLurl
usernameUsernametext
displayNameDisplay Nametext
bioBiotext
followersFollowersnumber
followingFollowingnumber
totalLikesTotal Likesnumber
videosVideosnumber
friendsFriendsnumber
likedVideosLiked Videosnumber
verifiedVerifiedboolean
privatePrivateboolean
tiktokSellerTikTok Sellerboolean
commerceUserCommerce Userboolean
joinedAtJoined Atnumber
avatarAvatarurl
bioLinkBio Linkurl

​
Example

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