MPPtempoquality 0.75

Get TikTok followers for any user via pay-per-request API — $0.06/call, no API keys needed.

Price
$0.06 / call
Protocol
mpp
Verified
no

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

tiktok-followerssocial-media-datapay-per-requestasync-job-pollingcursor-paginationno-api-keywallet-authmulti-platform-socialx402-paymentmpp-tempo-payment

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

Transporthttp
Protocolmpp
CurrencypathUSD

Quality

0.75/ 1.00

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

Provenance

Indexed frommpp_dev
Enriched2026-04-19 16:45:56Z · anthropic/claude-opus-4.6 · v2
First seen2026-04-18
Last seen2026-04-22

Agent access