Get the list of accounts a TikTok user follows — $0.06 per request, pay with USDC.
What it does
This endpoint retrieves the accounts that a given TikTok user follows. It is part of StableSocial, a 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 in USDC via the x402 or MPP (Tempo) protocol — no API keys, no subscriptions, no signup required.
The workflow is asynchronous. You POST to `/api/tiktok/following` with a JSON body containing the target TikTok `handle`. On successful payment the endpoint returns HTTP 202 with a signed JWT token. You then poll `GET /api/jobs?token=...` (free, but requires SIWX wallet authentication proving you are the paying wallet) until the job status is `finished` and data is returned. Jobs typically complete in 5–60 seconds; tokens expire after 30 minutes. Pagination is supported via a `cursor` field in the response's `page_info` object — each additional page is a new paid POST.
This endpoint depends on the profile having been collected first. You should call `POST /api/tiktok/profile` with the same handle before requesting following data to ensure fresh results. Parameters include `handle` (required), `max_page_size` (default 100), and `cursor` for pagination. Payment settles only on 2xx responses; if the trigger fails (bad params, user not found), you are not charged.
Capabilities
Use cases
- —Mapping a TikTok creator's social graph by listing all accounts they follow
- —Competitive analysis — discovering which brands or influencers a user follows
- —Enriching CRM or audience profiles with TikTok following data
- —Monitoring changes in a user's following list over time
- —Agent-driven social research pipelines that need structured TikTok data
Fit
Best for
- —AI agents that need on-demand TikTok social graph data without managing credentials
- —Researchers analyzing influencer networks across social platforms
- —Developers building social intelligence tools who want a unified, pay-per-call API
Not for
- —Bulk scraping of millions of users (each page costs $0.06 and requires sequential polling)
- —Real-time streaming of following changes (async polling model with 5–60 second latency)
- —Use cases requiring official TikTok API compliance or OAuth user consent
Quick start
# Step 1: Trigger the job (requires x402/MPP payment header)
curl -X POST https://stablesocial.dev/api/tiktok/following \
-H 'Content-Type: application/json' \
-d '{"handle": "charlidamelio"}'
# → 202 {"token": "eyJ..."}
# Step 2: Poll for results (free, SIWX wallet auth required)
curl 'https://stablesocial.dev/api/jobs?token=eyJ...' \
-H 'SIGN-IN-WITH-X: <wallet-signature>'
# → 200 {"status": "finished", "data": { ... }}Example
Request
{
"handle": "charlidamelio",
"max_page_size": 50
}Response
{
"token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
}Endpoint
Quality
Full OpenAPI schema with clear request parameters, detailed x-guidance documentation, and explicit pricing. The endpoint returned 405 on HEAD/GET probes (expected since it's POST-only), and no response schema is provided for the actual data payload. No example response body for the finished job data is available.
Warnings
- —Probe returned 405 because the endpoint only accepts POST; it is not broken but liveness could not be confirmed via HEAD/GET.
- —No response schema is defined for the finished job data — the structure of the returned following list is undocumented.
- —This endpoint depends on /api/tiktok/profile being called first for the same handle.
- —Scraping social media data may violate platform terms of service; verify compliance for your use case.
Citations
- —Every endpoint costs $0.06 per request, payable in USDC on Base, Solana, or Tempo.https://stablesocial.dev
- —The workflow is async: POST returns 202 with a JWT token, then poll GET /api/jobs with SIWX wallet auth.https://stablesocial.dev
- —Tokens expire after 30 minutes; jobs typically finish in 5–60 seconds.https://stablesocial.dev
- —Payment only settles on 2xx responses; failed triggers are not charged.https://stablesocial.dev
- —The /api/tiktok/following endpoint accepts handle, max_page_size, and cursor parameters.https://stablesocial.dev/openapi.json
- —This endpoint depends on the profile being collected first.https://stablesocial.dev