Fetch Reddit post comments on demand for $0.06 per request via pay-per-call MPP/x402.
What it does
This endpoint retrieves comments on a Reddit post through StableSocial's unified social media data API. You POST a JSON body containing a `post_id` (the Reddit post ID) and optionally `max_comments` (up to 300, default 50), `order_by` (date_desc, date_asc, id_desc), `max_page_size`, and a `cursor` for pagination. Each call costs $0.06 USD, settled via USDC on Base, Solana, or Tempo (MPP method "tempo" with intent "charge", or x402).
The API uses an async two-step flow. Step 1: POST to `/api/reddit/post-comments` with payment header — you receive a 202 response containing a signed JWT token. Step 2: Poll `GET /api/jobs?token=...` with SIWX wallet authentication (the same wallet that paid) until the job status is "finished" and data is returned. 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.
This endpoint depends on the post data being collected first — you should call `POST /api/reddit/post` with the same `post_id` before fetching comments to ensure fresh data. StableSocial is part of a broader suite covering 36 endpoints across TikTok, Instagram, Facebook, and Reddit, all at the same $0.06 per-request price with no API keys, signups, or subscriptions required. Payment serves as authentication.
Capabilities
Use cases
- —Retrieving all comments on a specific Reddit post for sentiment analysis
- —Monitoring discussion threads for brand mentions or competitor analysis
- —Collecting Reddit comment data for research or content aggregation
- —Building social listening dashboards that include Reddit conversations
- —Feeding Reddit discussion data into LLM-based summarization pipelines
Fit
Best for
- —Agents needing on-demand Reddit comment data without managing API keys
- —Pay-as-you-go social media research across multiple platforms
- —Automated workflows that need structured Reddit comment data with pagination
Not for
- —Real-time streaming of Reddit comments (this is async polling, not websocket)
- —Bulk historical Reddit data dumps (each page costs $0.06 and max 300 comments per call)
- —Use cases requiring Reddit user authentication or posting/writing actions
Quick start
# Step 1: Trigger comment collection (requires MPP/x402 payment header)
curl -X POST https://stablesocial.dev/api/reddit/post-comments \
-H 'Content-Type: application/json' \
-d '{"post_id": "1abc2de", "max_comments": 50}'
# → 202 {"token": "eyJ..."}
# Step 2: Poll for results (requires SIWX wallet auth)
curl 'https://stablesocial.dev/api/jobs?token=eyJ...' \
-H 'SIGN-IN-WITH-X: <siwx_token>'
# → 200 {"status": "finished", "data": {...}}Example
Request
{
"post_id": "1abc2de",
"order_by": "date_desc",
"max_comments": 50,
"max_page_size": 50
}Response
{
"token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
}Endpoint
Quality
Full OpenAPI schema with clear request parameters, documented async flow, and explicit pricing. The endpoint returned 405 on HEAD/GET probes, which is expected since it only accepts POST. No response schema is documented (only "Successful response"), and no example response data shape for the actual comment payload is provided. Docs page returns 404.
Warnings
- —Probe returned 405 on HEAD and GET — endpoint only accepts POST, which is consistent with the OpenAPI spec; it is likely live but could not be confirmed with a 402 challenge via the probe methods used.
- —No response schema is defined in the OpenAPI spec — the shape of returned comment data is undocumented.
- —The /docs page returns 404; detailed documentation beyond the OpenAPI x-guidance field is unavailable.
- —This endpoint depends on /api/reddit/post being called first to ensure data freshness.
Citations
- —Each call costs $0.06 USD, fixed pricehttps://stablesocial.dev
- —Payment via USDC on Base, Solana, or Tempo; MPP method tempo with intent chargehttps://stablesocial.dev/openapi.json
- —Async two-step flow: POST to trigger (paid, returns 202 with JWT), then poll GET /api/jobs with SIWX wallet authhttps://stablesocial.dev
- —Jobs typically finish in 5–60 seconds; tokens expire after 30 minuteshttps://stablesocial.dev
- —post-comments endpoint depends on post data being collected firsthttps://stablesocial.dev
- —Request accepts post_id (required), max_comments (default 50, max 300), order_by, max_page_size, cursorhttps://stablesocial.dev/openapi.json
- —36 endpoints across TikTok, Instagram, Facebook, and Reddithttps://stablesocial.dev