TikTok followers API

Q: What does it return?

A page holds 30 accounts; follow cursor for older followers. parent is the creator's profile, which carries the follower total. A private account answers private . Each profile has up to 20 fields, and the sample fills avatar_url , handle , id , is_private , kind , name , stats and url and 1 more.

Q: What do I send?

Send one of handle or id . handle : Username, with or without the leading @. id : TikTok user id (numeric) or secUid.

Q: Which errors can it return?

invalid_params , not_found and private . None is charged, and the errors list says which to retry.

Q: Is there an SDK call for it?

client.tiktok.profile_followers(...) in Python and client.tiktok.profileFollowers() in TypeScript.

The accounts that follow a creator, newest follower first, each with its name, avatar, bio, verified flag and follower, following, video and like counts.

Get an API key See a sample response

100 free credits. No card needed.

Each request1 credit

Fields in each profile20

A failed requestFree

A cached repeatFree

What you get for each profile

Every count

Followers, following, likes and posts as plain numbers, such as 100 followers on the sample.

Pictures

Links to the profile picture.

Name

The display name, such as Example follower 1.

Link

A link to the profile on TikTok.

Account flags

Whether the account is verified or private.

Account type

What kind of account it is, such as creator.

How it works

1
Get a key
Sign up and get 100 free credits. No card needed.
Your API key100 free credits
2
Send a handle
Pass handle (khaby.lame).
khaby.lame
3
Page through the results
Send back cursor until has_more is false.
Page 2Page 3

Request and response

Request

1curl -G "https://api.socialscrape.dev/v1/tiktok/profile/followers" \2  -d handle=khaby.lame \3  -H "x-api-key: $SOCIALSCRAPE_API_KEY"

1import requests2 3r = requests.get(4  "https://api.socialscrape.dev/v1/tiktok/profile/followers",5  params={"handle": "khaby.lame"},6  headers={"x-api-key": KEY},7)8profiles = r.json()["data"]["items"]

1const url = new URL("https://api.socialscrape.dev/v1/tiktok/profile/followers");2url.searchParams.set("handle", "khaby.lame");3 4const res = await fetch(url, {5  headers: { "x-api-key": KEY },6});7const { data } = await res.json();

Response200 OKSample values

{
  "ok": true,
  "credits_charged": 1,
  "data": {
    "items": [
      { "name": "Example follower 1",
        "handle": "example.follower1",
        "stats": { "followers": 100, "following": 26,
          "likes": 425, ... },
        "url": "https://www.tiktok.com/@example.f...",
        "avatar_url": "https://p16-sign.tiktokcdn-us.com...",
        ... },
      ...
    ],
    "cursor": "c1794333658",
    "has_more": true
  }
}

See every parameter in the docs

Use it from your AI agent

Ask in plain words

Ask your agent for TikTok followers in plain words, and the SocialScrape MCP server makes the call.

Set up the MCP server

One tool call

TikTok followers, given a handle.

Same price as the API

1 credit a call; a repeat within 30 days is free.

Runs on your machine

Your key stays in your agent's settings.

Pairs well with

TikTok profilePublic profile of a TikTok account: name, bio, bio...TikTok profile regionThe country TikTok recorded for an account's newest...TikTok profile videosAn account's videos, newest first.TikTok followingThe accounts a creator follows, each with its name...See all 27 TikTok endpoints

Pay only for data you get

A page of profiles1 credit

The same request within max_age_daysFree

A failed requestFree

Free credits for new accounts100

Starter

18,000 credits a month

GrowthMost popular

50,000 credits a month

Scale

150,000 credits a month

$27/mo

$73/mo

$209/mo

Get an API key

$1.50 per 1,000

$1.46 per 1,000

$1.39 per 1,000

Resets monthly

No rate limits

Over 1M credits a month? Talk to us. Or see full pricing.

Questions

What does it return?

A page holds 30 accounts; follow cursor for older followers. parent is the creator's profile, which carries the follower total. A private account answers private. Each profile has up to 20 fields, and the sample fills avatar_url, handle, id, is_private, kind, name, stats and url and 1 more.

What do I send?

Send one of handle or id.

handle: Username, with or without the leading @.

id: TikTok user id (numeric) or secUid.

Which errors can it return?

invalid_params, not_found and private. None is charged, and the errors list says which to retry.

Is there an SDK call for it?

client.tiktok.profile_followers(...) in Python and client.tiktok.profileFollowers() in TypeScript.

Same key works everywhere

FacebookYouTubeInstagramGitHubLinkedInRedditX (Twitter)SpotifyCosmosThreadsPinterestTwitchSee all 29 platforms