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.

$0.9 / 1k followers Extract TikTok followers and following — full profile data — from TikTok profiles

​
Endpoint

POST /api/v1/agents/tiktok/followers/run

​
Parameters

​
profiles
array
required
List · TikTok usernames to fetch follower / following lists for. One per line.
​
maxFollowersPerProfile
integer
default:50
Number · Maximum number of followers you want to scrape per profile. Use 0 for all.
​
maxFollowingPerProfile
integer
default:50
Number · Maximum number of following profiles you want to scrape per profile. Use 0 for all.

​
Response columns

FieldDisplay nameType
sourceUsernameSource Usernametext
connectionTypeConnection Typetext
urlURLurl
usernameUsernametext
nameNametext
avatarAvatarurl
bioBiotext
followersFollowersnumber
followingFollowingnumber
likesLikesnumber
videosVideosnumber
verifiedVerifiedboolean
privatePrivateboolean
sellerSellerboolean

​
Example

curl -X POST https://api.mindcase.co/api/v1/agents/tiktok/followers/run \
  -H "Authorization: Bearer mk_live_abc123def456" \
  -H "Content-Type: application/json" \
  -d '{
  "params": {
    "profiles": [
      "khaby.lame"
    ],
    "maxFollowersPerProfile": 50,
    "maxFollowingPerProfile": 50
  }
}'

​
Example response

Response
{
  "job_id": "job_7f3a2b1c",
  "status": "completed",
  "data": [
    {
      "sourceUsername": "khaby.lame",
      "connectionType": "follower",
      "url": "https://www.tiktok.com/@taflomayenza0",
      "username": "taflomayenza0",
      "name": "mhukahuru",
      "avatar": "https://p16-common-sign.tiktokcdn.com/musically-maliva-obj/1594805258216454~tplv-tiktokx-cropcenter:720:720.jpeg?dr=14579&refresh_token=6f907470&x-expires=1778580000&x-signature=skqN8RwHwejp2KDJc4cMooHkPj4%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my",
      "bio": null,
      "followers": 47,
      "following": 334,
      "likes": 0,
      "videos": 0,
      "verified": false,
      "private": false,
      "seller": false
    }
  ]
}