Get the list of accounts a Facebook user or page follows — $0.06 per request via MPP.
What it does
This endpoint retrieves the accounts that a given Facebook user or page follows. 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 in USDC, settled via the MPP (Tempo) or x402 protocol — no API keys, no subscriptions.
The workflow is asynchronous. You POST to `/api/facebook/following` with a `profile_id` (Facebook username or numeric ID) and receive a 202 response containing a signed JWT token. You then poll `GET /api/jobs?token=...` (authenticated via SIWX wallet signature) until the job status is `finished`, at which point the response includes the following-list data. 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 requires a new paid POST.
This endpoint depends on the profile resource: for best results, call `/api/facebook/profile` for the same `profile_id` first so the platform has fresh profile data to work from. Payment settles only on 2xx responses, so failed triggers (bad params, entity not found) are not charged.
Capabilities
Use cases
- —Mapping the social graph of a Facebook page or user to find brand affiliations
- —Competitive analysis by comparing which accounts rival pages follow
- —Enriching CRM records with a contact's public Facebook following data
- —Monitoring influencer networks by tracking who key accounts follow
- —Building audience overlap reports across Facebook pages
Fit
Best for
- —Agents that need on-demand Facebook social-graph data without managing API keys
- —Workflows requiring pay-per-call pricing instead of monthly subscriptions
- —Crypto-native applications that can settle payments via USDC on Tempo, Base, or Solana
Not for
- —High-volume bulk scraping where per-request costs add up quickly
- —Use cases requiring real-time streaming updates rather than on-demand polling
- —Applications that cannot perform SIWX wallet authentication for result retrieval
Quick start
# Step 1: Trigger the job (paid — $0.06 USDC)
curl -X POST https://stablesocial.dev/api/facebook/following \
-H 'Content-Type: application/json' \
-d '{"profile_id": "zuck"}'
# → 202 {"token": "eyJ..."}
# Step 2: Poll for results (free, SIWX auth required)
curl 'https://stablesocial.dev/api/jobs?token=eyJ...' \
-H 'SIGN-IN-WITH-X: <siwx_token>'
# → 200 {"status": "finished", "data": { ... }}Example
Request
{
"profile_id": "zuck",
"max_page_size": 50
}Response
{
"token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
}Endpoint
Quality
Full OpenAPI schema with clear request parameters, pricing, and detailed guidance docs are available. The endpoint returned 405 on HEAD/GET (expected since it requires POST), so the 402 challenge was not directly captured, but the OpenAPI x-payment-info confirms it is live and priced. No response schema is documented, so the shape of the returned following data is unknown.
Warnings
- —Probe returned 405 because HEAD/GET were tried; the endpoint only accepts POST — this is expected, not a failure.
- —No response schema is provided in the OpenAPI spec; the structure of the returned following data is undocumented.
- —The /docs page returns 404, so there is no dedicated documentation site beyond the OpenAPI spec and landing page.
- —SIWX wallet authentication is required to poll results, which adds integration complexity for non-crypto callers.
Citations
- —Every endpoint costs $0.06 per request in USDChttps://stablesocial.dev
- —The facebook/following endpoint accepts profile_id and max_page_size parameters via POSThttps://stablesocial.dev/openapi.json
- —Async two-step flow: POST to trigger (paid), then poll GET /api/jobs with SIWX wallet authhttps://stablesocial.dev
- —Payment settles via MPP Tempo or x402 protocol; currency is USDChttps://stablesocial.dev
- —Tokens expire after 30 minutes; jobs typically finish in 5–60 secondshttps://stablesocial.dev
- —This endpoint depends on the profile resource being fetched firsthttps://stablesocial.dev