All systems normalDashboardGet an API key
API reference / Users & profiles / Followers

Followers

A page of followers.

GETapi.tikultra.com/v1/user/followersHeavy · 10 credits
Upstream
/aweme/v1/user/follower/list/
Access
Every plan
Runs on
LeanPool · android · tiktok · 47.5.41
Pagination
{ cursor, has_more }
Client
os, app_flavour, app_version overrides
Billing
Failed calls are free
Older path
/v1/scrape/user/followers

Authorization & parameters

x-api-keyheader · stringrequired

Your API key. Create one in API keys.

Query parameters

usernamestringone of these

The @username, without the @. For example acme.

sec_uidstringone of these

The stable account ID used by the mobile API.

cursorstring

The cursor from the previous page. Omit it for the first page.

countinteger

Items per page. For example 20.

Client and egress

Optional. Leave them out to run as android · tiktok · 47.5.41 from the default LeanPool context. See Clients and versions.

osstring

android or ios. For example android.

app_flavourstring

Run as tiktok, lite, lite_coin, pro, studio, shop, tv, douyin. For example tiktok.

app_versionstring

A release of that app. Defaults to the current default for (os, app_flavour). For example 47.5.41.

regionstring

Two-letter country code for egress. For example US.

citystring

A supported city in that region. For example miami.

Response

A 200 returns JSON with stable field names. Every response carries x-credits-cost, x-credits-tier and x-credits-remaining.

Response fields

Key top-level and nested fields decoded from the mobile upstream payload:

status_codeinteger

Upstream TikTok mobile status code (0 indicates success).

cursorstring

Opaque pagination cursor to pass as cursor on the next request, or null at the end.

has_moreboolean

Whether another page of results is available.

itemsobject[]

Page of normalized records returned by this endpoint.

items[].uidstring

Numeric 64-bit TikTok user ID.

items[].sec_uidstring

Encrypted stable account identifier used across mobile endpoints.

items[].unique_idstring

Public @username handle without the leading @.

items[].nicknamestring

Display name shown on the creator profile.

items[].follower_countinteger

Total followers on the account.

items[].following_countinteger

Total accounts followed by this user.

log_pbobject

Upstream request trace envelope from the mobile gateway.

log_pb.impr_idstring

Upstream TikTok impression / trace identifier.

Pagination

Pass cursor from the previous page and stop when has_more is false. Both sit at the top level of every page; the raw upstream cursor fields are still in the body. See Pagination.

Page shape
{
  "cursor": "1794158512000",
  "has_more": true,
  "items": [
    "…"
  ]
}
Python SDKPython (HTTP)JavaScriptpages
import os
from tikultra import TikUltra

with TikUltra(api_key=os.environ["TIKULTRA_KEY"]) as client:
    for page in client.paginate("GET", "/v1/user/followers", params={
        "username": "acme",
        "count": 50,
    }):
        print(page.cursor, page.has_more, page.credits_cost)

Errors

Errors return a JSON body with a stable code and cost 0 credits. See Errors and retries.