Get TikTok followers for any user via pay-per-request API — $0.06/call, no API keys needed.
What it does
This endpoint retrieves TikTok follower lists for a given username. It is part of StableSocial, a unified pay-per-request social media data API covering TikTok, Instagram, Facebook, and Reddit (36 endpoints total). Every call costs a flat $0.06 USD, payable via USDC on Base, Solana, or Tempo (MPP/x402). No API keys, signups, or subscriptions are required — payment itself serves as authentication.
The workflow is asynchronous: POST to `/api/tiktok/followers` with a JSON body containing the TikTok `handle` and optional parameters (`max_followers` up to default 500, `max_page_size` default 100, `cursor` for pagination). On success, you receive a 202 response with a signed JWT token. You then poll `GET /api/jobs?token=...` (free, but requires SIWX wallet auth from the paying wallet) until the job status is `finished`, at which point the follower data is returned. Jobs typically complete in 5–60 seconds; tokens expire after 30 minutes.
Important dependency: you must first call `/api/tiktok/profile` for the same handle before requesting followers, so that the profile data is collected. Pagination is supported — if `page_info.has_next_page` is true, pass the returned `cursor` in a new paid POST to fetch the next page. Failed jobs are not charged. The endpoint supports both x402 and MPP (Tempo method, charge intent) payment protocols.
Capabilities
Use cases
- —Retrieve the follower list of a TikTok account for influencer analysis
- —Build audience overlap reports by comparing followers across TikTok profiles
- —Monitor follower growth over time by periodically fetching follower snapshots
- —Feed TikTok follower data into an AI agent for social research workflows
- —Identify potential brand ambassadors by analyzing follower profiles
Fit
Best for
- —AI agents needing on-demand TikTok follower data without managing API credentials
- —Social media researchers who want pay-as-you-go access without subscriptions
- —Developers building cross-platform social analytics tools
Not for
- —Real-time streaming of follower changes (async polling model with 5–60s latency)
- —Bulk historical data dumps requiring millions of records (each page costs $0.06)
- —Users who need free or trial access (every request requires payment)
Quick start
# Step 1: Trigger follower collection (requires payment header)
curl -X POST https://stablesocial.dev/api/tiktok/followers \
-H 'Content-Type: application/json' \
-d '{"handle": "charlidamelio", "max_followers": 100}'
# → 202 {"token": "eyJ..."}
# Step 2: Poll for results (requires SIWX wallet auth)
curl 'https://stablesocial.dev/api/jobs?token=eyJ...' \
-H 'SIGN-IN-WITH-X: <wallet-signature>'
# → 200 {"status": "finished", "data": {...}}Example
Request
{
"handle": "charlidamelio",
"max_followers": 100,
"max_page_size": 50
}Response
{
"token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
}Endpoint
Quality
Full OpenAPI schema with clear request parameters, detailed guidance docs embedded in the spec, and consistent pricing info. The endpoint returned 405 on HEAD/GET probes (expected since it's POST-only), so liveness couldn't be directly confirmed via 402 challenge. No response schema is documented for the actual follower data payload. Landing page is live (200).
Warnings
- —Endpoint returned 405 on HEAD and GET probes; it is POST-only, so the MPP 402 challenge was not captured directly — liveness is inferred from the OpenAPI spec and live landing page.
- —No response schema is provided for the follower data payload — the actual shape of returned follower objects is undocumented.
- —The /docs page returns 404; documentation is only available via the OpenAPI spec's x-guidance field and the landing page.
- —Dependent call required: you must first call /api/tiktok/profile for the same handle before requesting followers.
Citations
- —Every endpoint costs $0.06 per requesthttps://stablesocial.dev
- —Supports USDC on Base, Solana, or Tempo paymenthttps://stablesocial.dev
- —Async two-step flow: POST to trigger, then poll GET /api/jobs with SIWX wallet authhttps://stablesocial.dev
- —Followers endpoint depends on profile being collected firsthttps://stablesocial.dev
- —Tokens expire after 30 minutes; jobs typically finish in 5–60 secondshttps://stablesocial.dev
- —36 endpoints across TikTok, Instagram, Facebook, and Reddithttps://stablesocial.dev
- —max_followers default 500, max_page_size default 100 for this endpointhttps://stablesocial.dev/openapi.json