Get Facebook page/user followers on demand — $0.06 per request, no API keys needed.
What it does
This endpoint retrieves followers of a Facebook user or page. It is part of StableSocial, a pay-per-request social media data API covering TikTok, Instagram, Facebook, and Reddit through 36 unified endpoints. Every call costs a flat $0.06 in USDC (settled on Base, Solana, or Tempo). No signup, API keys, or subscriptions are required — payment itself serves as authentication.
The endpoint uses an async two-step flow. First, you POST to `/api/facebook/followers` with a `profile_id` and a payment header. On success you receive a 202 response containing a signed JWT token. Then you poll `GET /api/jobs?token=...` (free, but requires SIWX wallet auth proving you are the paying wallet) until the job status is "finished" and your follower data is returned. Jobs typically complete in 5–60 seconds; tokens expire after 30 minutes. If the trigger POST itself fails (bad params, entity not found), you are not charged.
Key parameters include `profile_id` (required — Facebook username or numeric ID), `max_followers` (default 500), `max_page_size` (default 100), and `cursor` for pagination. Each additional page requires a new paid POST. The endpoint depends on the profile being collected first via `POST /api/facebook/profile` to ensure fresh data. Payment is accepted via both x402 and MPP (Tempo method, charge intent) protocols.
Capabilities
Use cases
- —Retrieve the follower list of a Facebook page for competitive analysis
- —Build audience overlap reports by comparing followers across Facebook pages
- —Feed Facebook follower data into an AI agent's research pipeline
- —Monitor follower growth of a brand's Facebook presence over time
- —Enrich CRM records with social follower information
Fit
Best for
- —AI agents needing on-demand Facebook follower data without managing credentials
- —Researchers who want pay-as-you-go access to Facebook social graphs
- —Developers building social analytics tools who want a unified multi-platform API
Not for
- —Bulk continuous monitoring requiring real-time webhook-style updates
- —Use cases needing official Facebook Graph API features like posting or ad management
- —Users who cannot pay with USDC on Base, Solana, or Tempo
Quick start
# Step 1: Trigger follower collection (requires payment header)
curl -X POST https://stablesocial.dev/api/facebook/followers \
-H 'Content-Type: application/json' \
-d '{"profile_id": "zuck", "max_followers": 100}'
# → 202 {"token": "eyJ..."}
# Step 2: Poll for results (requires SIWX wallet auth)
curl 'https://stablesocial.dev/api/jobs?token=eyJ...'Example
Request
{
"profile_id": "zuck",
"max_followers": 100,
"max_page_size": 50
}Response
{
"token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
}Endpoint
Quality
Full OpenAPI schema with clear request parameters, detailed guidance documentation, and confirmed pricing at $0.06/request. The endpoint returned 405 on HEAD/GET probes, which is expected since it only accepts POST. No example response body for the actual follower data is provided in the schema (only 202 trigger response documented), and no /docs page exists, which slightly limits completeness.
Warnings
- —Probe returned 405 on HEAD/GET — endpoint only accepts POST, which is consistent with the documented async trigger pattern
- —No response schema for the actual follower data payload is documented in the OpenAPI spec
- —The /docs page returns 404; all documentation is embedded in the OpenAPI x-guidance field and the landing page
- —Dependent endpoint: you should call POST /api/facebook/profile first to ensure fresh data before fetching followers
Citations
- —Every endpoint costs $0.06 per request in USDChttps://stablesocial.dev
- —Payment is accepted on Base, Solana, or Tempohttps://stablesocial.dev
- —Async two-step flow: POST to trigger (paid), then poll GET /api/jobs with SIWX wallet auth (free)https://stablesocial.dev
- —Tokens expire after 30 minutes; jobs typically finish in 5–60 secondshttps://stablesocial.dev
- —Followers endpoint depends on profile being collected first via /api/facebook/profilehttps://stablesocial.dev
- —If the POST trigger fails, you are not charged — payment only settles on 2xx responseshttps://stablesocial.dev
- —facebook_followers endpoint accepts profile_id (required), max_followers (default 500), max_page_size (default 100), and cursor parametershttps://stablesocial.dev/openapi.json