Fetch Facebook page/user posts on demand for $0.06 per request via MPP payment.
What it does
This endpoint (`POST /api/facebook/posts`) retrieves posts from a Facebook page or user profile. It is part of StableSocial, a pay-per-request social media data API covering TikTok, Instagram, Facebook, and Reddit through a unified interface. Each call costs a flat $0.06 USD, settled via USDC on Base, Solana, or Tempo (MPP method). No API keys or subscriptions are required — payment itself serves as authentication.
The endpoint uses an async two-step flow. You POST a JSON body with the target `profile_id` (Facebook username or ID) and optional parameters like `max_posts` (up to 300, default 50), `order_by` (date_desc, date_asc, id_desc), `max_page_size`, and a `cursor` for pagination. On success, you receive a 202 response containing 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 your data is returned. Jobs typically complete in 5–60 seconds; tokens expire after 30 minutes.
This endpoint depends on the profile having been collected first — you should call `POST /api/facebook/profile` before fetching posts to ensure fresh data. Pagination is cursor-based: each page costs a separate $0.06 request. Payment only settles on 2xx responses, so failed triggers are not charged. The full OpenAPI spec is available at `https://stablesocial.dev/openapi.json`.
Capabilities
Use cases
- —Collecting recent posts from a Facebook page for competitive analysis or brand monitoring
- —Building a social listening pipeline that aggregates Facebook content alongside other platforms
- —Feeding Facebook post data into an LLM agent for sentiment analysis or summarization
- —Monitoring a public figure's Facebook activity programmatically
- —Paginating through a page's full post history for research or archival
Fit
Best for
- —Agents needing on-demand Facebook post data without managing Facebook Graph API credentials
- —Pay-as-you-go social media research with no subscription commitment
- —Unified multi-platform social data collection (TikTok, Instagram, Facebook, Reddit in one API)
Not for
- —High-volume bulk scraping where per-request costs would accumulate significantly
- —Real-time streaming of Facebook content (this is async polling, not webhooks/streaming)
- —Accessing private or non-public Facebook content
Quick start
# Step 1: Trigger post collection (requires MPP payment header)
curl -X POST https://stablesocial.dev/api/facebook/posts \
-H 'Content-Type: application/json' \
-d '{"profile_id": "NASA", "max_posts": 10}'
# → 202 {"token": "eyJ..."}
# Step 2: Poll for results (requires SIWX wallet auth)
curl 'https://stablesocial.dev/api/jobs?token=eyJ...'Example
Request
{
"order_by": "date_desc",
"max_posts": 10,
"profile_id": "NASA",
"max_page_size": 10
}Response
{
"token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
}Endpoint
Quality
Full OpenAPI schema with clear request parameters, detailed guidance documentation, and explicit pricing. The endpoint returned 405 on HEAD/GET probes, which is expected since it only accepts POST. No example response body for the actual post data is provided in the schema (only the 202 token response is documented), and the /docs page returns 404, slightly reducing the score.
Warnings
- —Probe returned 405 on HEAD/GET — endpoint only accepts POST with payment header, which is expected behavior
- —No response schema for the actual post data payload (only the 202 token response is documented)
- —The /docs page returns 404; all documentation is embedded in the OpenAPI x-guidance field
- —This endpoint depends on /api/facebook/profile being called first for fresh data
Citations
- —Each endpoint costs $0.06 per request in USDC 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/openapi.json
- —Facebook posts endpoint accepts profile_id, max_posts (up to 300), order_by, max_page_size, and cursor parametershttps://stablesocial.dev/openapi.json
- —Jobs typically finish in 5–60 seconds; tokens expire after 30 minuteshttps://stablesocial.dev/openapi.json
- —Payment only settles on 2xx responses — failed triggers are not chargedhttps://stablesocial.dev/openapi.json
- —36 endpoints across 4 platforms: TikTok, Instagram, Facebook, Reddithttps://stablesocial.dev