$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
List · Search keywords to find TikTok profiles. Same syntax as the TikTok search bar. One per line.
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 -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
{
"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
}
]
}
