Fetch Facebook page or user profile data on demand for $0.06 per request via MPP.
What it does
This endpoint retrieves Facebook page or user profile information through StableSocial's unified social media API. Send a POST request with a `profile_id` (Facebook username or numeric ID) and receive a job token. Poll the separate `/api/jobs` endpoint (authenticated via SIWX wallet signature) until the result is ready, typically within 5–60 seconds.
The endpoint follows an async two-step flow: Step 1 is a paid POST that returns a JWT token (HTTP 202), and Step 2 is a free GET poll at `/api/jobs?token=...` that requires wallet authentication matching the paying wallet. Each request costs $0.06 USD, settled in USDC on Base, Solana, or Tempo (pathUSD). Payment only settles on a successful 2xx trigger response — if the request fails (bad params, entity not found), you are not charged. Tokens expire after 30 minutes.
This is one of 10 Facebook endpoints in the StableSocial suite, which also covers TikTok (10 endpoints), Instagram (10 endpoints), and Reddit (6 endpoints) — 36 endpoints total, all at the same $0.06 fixed price. No API keys or signup required; payment via the MPP or x402 protocol header serves as authentication. The profile endpoint is a prerequisite for dependent Facebook endpoints like posts, followers, and following.
Capabilities
Use cases
- —Retrieve public Facebook page metadata (name, description, follower count) for competitive analysis
- —Feed Facebook profile data into an AI agent's research pipeline without managing API keys
- —Monitor Facebook pages or user profiles on demand without a recurring subscription
- —Enrich CRM records with Facebook profile information
Fit
Best for
- —AI agents needing on-demand Facebook profile data without credential management
- —Pay-as-you-go social media research with no subscription commitment
- —Developers who want a unified API across Facebook, Instagram, TikTok, and Reddit
Not for
- —High-volume bulk scraping where per-request costs would accumulate significantly
- —Use cases requiring real-time streaming or webhook-based updates
- —Accessing private Facebook data (this fetches publicly available information)
Quick start
# Step 1: Trigger profile fetch (requires MPP or x402 payment header)
curl -X POST https://stablesocial.dev/api/facebook/profile \
-H 'Content-Type: application/json' \
-d '{"profile_id": "meta"}'
# Returns 202 with {"token": "eyJ..."}
# Step 2: Poll for results (requires SIWX wallet auth)
curl 'https://stablesocial.dev/api/jobs?token=eyJ...'Example
Request
{
"profile_id": "meta"
}Response
{
"token": "eyJhbGciOiJIUzI1NiIs..."
}Endpoint
Quality
Full OpenAPI schema with clear request body definition, well-documented async flow, and explicit pricing ($0.06/request). The 402 challenge was not directly captured because the endpoint only accepts POST (probe tried HEAD/GET which returned 405), but the OpenAPI spec confirms MPP and x402 payment protocols. No example response schema for the actual profile data is provided.
Warnings
- —Probe returned 405 on HEAD/GET because this endpoint only accepts POST — it is not broken, just method-restricted
- —No response schema for the actual Facebook profile data (only the job token response is documented)
- —The /docs page returns 404; documentation is embedded in the OpenAPI x-guidance field only
- —Exact fields returned in the profile data object are not specified in the OpenAPI spec
Citations
- —Each request costs $0.06 USD, fixed price across all endpointshttps://stablesocial.dev
- —The endpoint accepts POST with a profile_id parameter (Facebook profile ID or username)https://stablesocial.dev/openapi.json
- —Payment settles via USDC on Base, Solana, or Tempo (pathUSD) using MPP or x402 protocolshttps://stablesocial.dev
- —Async two-step flow: paid POST returns JWT token, free GET /api/jobs polls for results with SIWX wallet authhttps://stablesocial.dev
- —Tokens expire after 30 minutes; jobs typically finish in 5–60 secondshttps://stablesocial.dev
- —36 total endpoints across TikTok, Instagram, Facebook, and Reddithttps://stablesocial.dev
- —Payment only settles on 2xx responses; failed triggers are not chargedhttps://stablesocial.dev