Fetch Reddit comment details on demand for $0.06 per request via MPP payment.
What it does
This endpoint (`POST /api/reddit/comment`) retrieves details for a specific Reddit comment by its ID. It is part of StableSocial, a pay-per-request social media data API covering TikTok, Instagram, Facebook, and Reddit through 36 unified endpoints. Each request costs a flat $0.06 USD, settled via USDC on Base, Solana, or Tempo (MPP/x402). No API keys or subscriptions are required — payment itself serves as authentication.
The flow is asynchronous: you POST with a `comment_id` and a payment header, receive a 202 response containing a JWT token, then poll `GET /api/jobs?token=...` (free, but requires SIWX wallet auth) until the job finishes. Jobs typically complete in 5–60 seconds; tokens expire after 30 minutes. If the trigger POST fails (e.g., invalid comment ID), you are not charged. Only the wallet that paid can poll for results.
The endpoint accepts a single required field (`comment_id`, a string) in the JSON body. No response schema is documented beyond the generic `{"status": "finished", "data": {...}}` envelope. This is one of six Reddit endpoints; others cover posts, post comments, search, profile search, and subreddit listing. Pagination via cursor is supported on collection endpoints but is not applicable to this single-comment lookup.
Capabilities
Use cases
- —Retrieving the full details of a specific Reddit comment by ID for sentiment analysis or monitoring
- —Building automated research agents that pull Reddit discussion data on demand
- —Enriching datasets with Reddit comment metadata without managing Reddit API credentials
- —Monitoring specific Reddit comments for changes or engagement metrics
Fit
Best for
- —AI agents needing on-demand Reddit comment data without credential management
- —Pay-as-you-go social media research with no subscription commitment
- —Developers who want a unified API across multiple social platforms
Not for
- —Bulk scraping of millions of Reddit comments (each costs $0.06, no bulk discount documented)
- —Real-time streaming of Reddit comments (async polling model with 5–60 second latency)
- —Use cases requiring official Reddit API compliance or OAuth-based access
Quick start
# Step 1: Trigger the job (requires MPP/x402 payment header)
curl -X POST https://stablesocial.dev/api/reddit/comment \
-H 'Content-Type: application/json' \
-d '{"comment_id": "abc123def"}'
# → 202 {"token": "eyJ..."}
# Step 2: Poll for results (free, SIWX wallet auth required)
curl https://stablesocial.dev/api/jobs?token=eyJ...Example
Request
{
"comment_id": "kx1a2b3"
}Response
{
"data": {
"body": "This is an example Reddit comment.",
"score": 42,
"author": "example_user",
"comment_id": "kx1a2b3",
"created_utc": 1700000000
},
"status": "finished"
}Endpoint
Quality
Full OpenAPI schema is available with clear request body definition and pricing. The endpoint is documented as part of a well-structured 36-endpoint suite. However, the probe returned 405 (not 402) because the endpoint only accepts POST, not HEAD/GET — this is expected behavior, not a failure. Response schema for the actual comment data is not documented (only the generic job envelope), and no example responses are provided in the spec. The example_response_json above is inferred/illustrative.
Warnings
- —Probe returned 405 because endpoint only accepts POST; HEAD/GET are not supported. Endpoint is likely live but liveness could not be confirmed via the probe.
- —No response schema documented for the actual comment data payload — the example_response_json is illustrative and may not match the real structure.
- —SIWX wallet authentication is required for polling results, which adds complexity beyond simple HTTP calls.
- —The /docs, /pricing, and /api pages all return 404; documentation is only available via the OpenAPI spec and the landing page.
Citations
- —Each request costs $0.06 USD, fixed price across all endpointshttps://stablesocial.dev
- —Payment via USDC on Base, Solana, or Tempo; supports both x402 and MPP protocolshttps://stablesocial.dev/openapi.json
- —Async two-step flow: POST to trigger (paid), then poll GET /api/jobs (free, SIWX auth)https://stablesocial.dev
- —Reddit comment endpoint requires a single comment_id string fieldhttps://stablesocial.dev/openapi.json
- —Jobs typically finish in 5–60 seconds; tokens expire after 30 minuteshttps://stablesocial.dev
- —36 endpoints across TikTok, Instagram, Facebook, and Reddithttps://stablesocial.dev