Fetch Facebook post comments on demand for $0.06 per request via pay-per-call social data API.
What it does
This endpoint retrieves comments on a Facebook post through StableSocial's unified social media data API. You POST a JSON body containing a `post_id` (the Facebook post ID) along with optional parameters for pagination (`cursor`, `max_page_size`) and sorting (`order_by`). Each call costs $0.06 in USDC, settled via x402 or MPP (Tempo). No API keys or signup required — payment serves as authentication.
The flow is asynchronous: the paid POST returns HTTP 202 with a JWT token, which you then poll at `GET /api/jobs?token=...` (free, but requires SIWX wallet auth proving you are the paying wallet). Jobs typically complete in 5–60 seconds. Tokens expire after 30 minutes. If the trigger POST itself fails (e.g., bad parameters), you are not charged. Results support cursor-based pagination via `page_info.has_next_page`; each subsequent page requires a new paid POST.
This endpoint depends on posts having been previously collected for the target profile. The recommended sequence is: first call `/api/facebook/profile` to collect the profile, then `/api/facebook/posts` to collect posts, then `/api/facebook/post-comments` with a specific `post_id`. Up to 300 comments can be requested per call (`max_comments`, default 50). Sort options include `date_desc`, `date_asc`, and `id_desc`.
Capabilities
Use cases
- —Sentiment analysis on Facebook post comments for brand monitoring
- —Collecting user feedback and reactions from Facebook page posts
- —Competitive analysis by comparing comment volumes and themes across pages
- —Building datasets of public Facebook discussions for research
- —Automated social listening pipelines that ingest Facebook engagement data
Fit
Best for
- —AI agents needing on-demand Facebook comment data without managing credentials
- —Researchers collecting public Facebook discussion data at scale
- —Social media monitoring tools that need per-request pricing without subscriptions
Not for
- —Real-time streaming of Facebook comments as they arrive (this is async polling, not a live stream)
- —Accessing private or friends-only Facebook post comments (only public data)
- —High-frequency bulk scraping where per-request costs would accumulate significantly
Quick start
# Step 1: Trigger comment collection (paid, $0.06)
curl -X POST https://stablesocial.dev/api/facebook/post-comments \
-H 'Content-Type: application/json' \
-d '{"post_id": "123456789", "max_comments": 50}'
# Returns 202 {"token": "eyJ..."}
# Step 2: Poll for results (free, SIWX wallet auth required)
curl https://stablesocial.dev/api/jobs?token=eyJ...Example
Request
{
"post_id": "123456789",
"order_by": "date_desc",
"max_comments": 50,
"max_page_size": 50
}Response
{
"token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
}Endpoint
Quality
Full OpenAPI schema with clear request parameters, well-documented async flow, and confirmed pricing ($0.06/request). The probe returned 405 on HEAD/GET because the endpoint only accepts POST, which is expected. No example response data schema for the actual comments payload is provided, and the /docs page returns 404, limiting documentation depth.
Warnings
- —Probe returned 405 because HEAD/GET were tried but this endpoint only accepts POST — this is expected behavior, not an outage.
- —No response schema is documented for the actual comment data returned via the jobs polling endpoint.
- —The /docs page returns 404; all documentation is embedded in the OpenAPI x-guidance field and the landing page.
- —This endpoint depends on prior calls to /api/facebook/profile and /api/facebook/posts for the target profile.
Citations
- —Each endpoint costs $0.06 per request in USDC on Base, Solana, or Tempohttps://stablesocial.dev
- —The flow is async: POST returns 202 with a JWT token, then poll GET /api/jobs?token=...https://stablesocial.dev
- —Tokens expire after 30 minutes; jobs typically finish in 5-60 secondshttps://stablesocial.dev
- —post_id is required; max_comments defaults to 50, max 300; order_by supports date_desc, date_asc, id_deschttps://stablesocial.dev/openapi.json
- —Payment only settles on 2xx responses; failed triggers are not chargedhttps://stablesocial.dev
- —SIWX wallet authentication is required for polling; only the paying wallet can retrieve resultshttps://stablesocial.dev