# TikTok Followers List

> TikTok Followers List is a paid API for AI agents from social.duoleads.com, paid per call via x402, $0.02/call, status unknown (last checked 2026-10-29).

Retrieves a paginated list of public followers for a given TikTok account handle, returning profile details for each follower.

## Facts

- Endpoint: GET https://social.duoleads.com/v1/tiktok/followers?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-29
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/tiktok-followers-list-ba3f62ff
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ZoAuROZoXQlsXhBEGFQbh

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability tiktok-followers-list-ba3f62ff
```

Example prompt: Can you pull the first page of public followers for TikTok account @charlidamelio and show me each follower's handle, name, bio, and how many followers they have?

## When to prefer this

Use this endpoint when you need structured follower profile data (handle, bio, follower/following counts, verification) for a specific TikTok account, especially for audience analysis, influencer research, or competitive intelligence. It is paginated via cursor, making it suitable for iterating through large follower lists. Prefer it over general social search endpoints when the goal is specifically enumerating followers of one account rather than searching by keyword or hashtag.

## Known failure modes

- Invalid or non-existent TikTok handle returns a not-found response (not charged)
- Malformed handle input is treated as bad input (not charged)
- Expired or invalid cursor may return an error or restart pagination
- Rate limits or provider downtime may result in service unavailability
- Private or restricted TikTok accounts may return no followers
- End of follower list returns complete:true with an empty items array

## How this service works

TikTok Followers List: the public followers of one TikTok account by handle, one page per call with next_cursor. Per follower the handle, name, bio, followers, following, posts and verification in the shared social schema. Bad input is free; not found or no match is not charged.

## Output

Returns a JSON object containing a paginated list of follower profiles for the specified TikTok account. Each follower entry includes their handle, display name, profile URL, follower count, following count, verification status, and profile image URL. The response also includes the original query handle, the next_cursor for fetching the next page, a timestamp (as_of), and a disclaimer about the public data source.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "handle"
     ],
     "properties": {
      "cursor": {
       "type": "string",
       "maxLength": 512,
       "description": "next_cursor of the previous page."
      },
      "handle": {
       "type": "string",
       "maxLength": 200,
       "description": "A TikTok handle (with or without @) or a tiktok.com/@handle URL."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "as_of": "2026-10-15T12:00:00.000Z",
  "items": [
   {
    "id": "6000000000000000301",
    "url": "https://www.tiktok.com/@synth_follower_1",
    "lang": null,
    "text": null,
    "type": "profile",
    "author": {
     "handle": "synth_follower_1",
     "verified": null,
     "followers": 319,
     "display_name": "Synthetic Follower One"
    },
    "metrics": {
     "likes": null,
     "views": null,
     "replies": null,
     "reposts": null
    },
    "profile": {
     "posts": null,
     "following": 1375,
     "likes_total": null
    },
    "platform": "tiktok",
    "parent_id": null,
    "created_at": null,
    "media_urls": [
     "https://p16.tiktokcdn.invalid/a/6000000000000000301.jpeg"
    ]
   }
  ],
  "query": {
   "cursor": null,
   "handle": "synthcreator"
  },
  "source": "public data via third-party provider; not affiliated with the platform",
  "complete": true,
  "platform": "tiktok",
  "disclaimer": "Public data via third-party providers; not affiliated with or endorsed by any platform. Do not use to profile, target or train AI on individuals.",
  "request_id": "01KEXAMPLE0000000000000000",
  "next_cursor": "1791289478"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/tiktok-followers-list-ba3f62ff/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from social.duoleads.com](https://www.zero.xyz/host/social.duoleads.com/llms.txt)