---
title: "TikTok User Followers API"
method: GET
path: "/v1/tiktok/user-followers"
tags: ["TikTok"]
---

# TikTok User Followers API

`GET /v1/tiktok/user-followers`

## Request

- Base URL: `https://api.captapi.com`
- URL: `https://api.captapi.com/v1/tiktok/user-followers`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

List a TikTok user's followers — id, secUid, createTime, region, language, cursor pagination.

Pass a TikTok profile URL or @handle and get followers as clean JSON: id + secUid (stable identity — same fields search-users documents), username, displayName, bio, url, followers, following, verified, profileImage, plus createTime/createTimeUnix — and region / language only when TikTok exposes them on the row (keys are omitted, not nulled, when it does not). total is the profile's exact followerCount from statsV2 (universe size) with totalIsApproximate beside it; totalReturned is this page. Cursor pagination via nextCursor + hasMore (TikTok minCursor). Flat 1 credit per call on every path.

Docs: https://captapi.com/apis/tiktok-user-followers

## Query parameters

- `url` string, required
- `limit` integer
- `cursor` string
- `cache` boolean

## Response `200`

Success. The data object for this endpoint.

- object
  - `success` unknown, required
  - `data` object, required
    - `url` string: Canonical URL of the item.
    - `total` integer: The profile's exact followerCount from statsV2 (universe size). totalIsApproximate is true only when TikTok exposed nothing but a display-rounded value.
    - `totalIsApproximate` boolean: True when total is a display-rounded figure rather than an exact statsV2 counter.
    - `totalReturned` integer: Number of items returned in this response.
    - `hasMore` boolean: Whether more results are available beyond this page. When true, pass nextCursor to fetch the next page.
    - `nextCursor` string: Cursor to pass for the next page of results. May be null when the platform does not expose deep pagination (e.g. some Facebook Ad Library searches).
    - `followers` object[]: Follower count.
      - `username` string: Account username / handle.
      - `displayName` string: Display name of the account. Canonical across profile endpoints (prefer over name).
      - `bio` string, nullable: Profile bio. Canonical across profile endpoints (prefer over description on YouTube).
      - `url` string: Canonical URL of the item.
      - `followers` integer: Follower count.
      - `following` integer: Number of accounts followed.
      - `verified` boolean: Whether the account is verified on this platform.
      - `profileImage` string: Profile image URL. Deprecated alias of avatar on Instagram/Twitter/Threads/TikTok profile endpoints (one release).
      - `id` string: Id of this followers item.
      - `secUid` string: TikTok secure user ID — required for many platform-internal list endpoints.
      - `createTime` string: When the account was created (ISO 8601).
      - `createTimeUnix` integer: Create time unix. Example: 1649497070.
      - `language` string: Detected or requested language code.

## Other responses

- `400`: Bad request: wrong platform URL, unknown endpoint, or an invalid parameter value. Not billed.
- `401`: Missing, invalid or revoked API key. Not billed.
- `402`: Not enough credits for this request. Not billed.
- `404`: The resource does not exist or is not public. Not billed.
- `422`: A required parameter is missing or has the wrong type. Not billed.
- `429`: Rate limit reached. Wait for Retry-After seconds. Not billed.
- `502`: The platform could not be reached or returned nothing usable. Retryable, not billed. 503 and 504 use the same envelope.

---

[API](https://skmtc.dev/captapi/apis/captapi-api.md) · [All operations](https://skmtc.dev/captapi/apis/captapi-api/llms.txt) · [OpenAPI document](https://skmtc.dev/captapi/apis/captapi-api/revisions/c9b9ac5ff1bd?raw)