# TikTok User Followers Lookup

> TikTok User Followers Lookup is a paid API for AI agents from x402.apidirect.io, paid per call via x402, $0.007/call, status unknown (last checked 2026-10-30).

Retrieves a TikTok user's followers list, sorted newest first, by username, numeric user ID, or profile URL.

## Facts

- Endpoint: GET https://x402.apidirect.io/v1/tiktok/user/followers?utm_source=zero.xyz
- Price: $0.007/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-30
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/tiktok-user-followers-lookup-95bdedf1
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_UNkjN5mJMmVfL_B9zgo8X

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-user-followers-lookup-95bdedf1
```

Example prompt: Can you pull the most recent followers of the TikTok account @charlidamelio — fetch the first 3 pages so I get up to 300 followers?

## When to prefer this

Choose this endpoint when you need to retrieve a TikTok user's followers sorted by recency, identified by username, numeric user ID, or profile URL. It supports bulk fetching via pagination (up to 100 followers per page, up to 1000 pages). Prefer this over manual scraping or other social APIs when the target platform is specifically TikTok and you need structured follower data for audience analysis, influencer research, or follower tracking.

## Known failure modes

- Invalid or non-existent username/user_id/URL returns an error or empty result
- Multiple identifier parameters provided simultaneously (username + user_id) causes a validation error
- Private TikTok accounts may return empty or restricted follower data
- Rate limiting or payment failure for the $0.007 USDC per-call cost
- Requesting too many pages may cause timeouts or partial results
- Malformed TikTok profile URL returns a parsing error

## How this service works

Get a user's followers, newest first, by username, numeric user ID, or profile URL.

## Output

Returns a paginated list of TikTok follower profiles for the specified user, ordered newest first. Each page contains up to 100 followers with profile details such as usernames, user IDs, and other public account information. Multiple pages can be fetched in a single call (up to 1000 pages).

## 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",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [],
     "properties": {
      "url": {
       "type": "string",
       "maxLength": 500,
       "description": "TikTok profile URL, e.g. https://www.tiktok.com/@tiktok (max 500 characters). Provide exactly one of username, user_id, or url."
      },
      "pages": {
       "type": "integer",
       "default": 1,
       "maximum": 1000,
       "minimum": 1,
       "description": "Number of pages to fetch, 1-1000 (default: 1). Each page returns up to 100 followers."
      },
      "user_id": {
       "type": "string",
       "description": "Numeric TikTok user ID, as returned by Search Users or User Profile. Provide exactly one of username, user_id, or url."
      },
      "username": {
       "type": "string",
       "maxLength": 100,
       "description": "TikTok username, with or without leading @ (max 100 characters). Provide exactly one of username, user_id, or url."
      }
     }
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/tiktok-user-followers-lookup-95bdedf1/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.apidirect.io](https://www.zero.xyz/host/x402.apidirect.io/llms.txt)