Fetch Reddit post details on demand for $0.06 per request via MPP payment.
What it does
This endpoint retrieves Reddit post details through StableSocial's unified social media data API. You send a POST request with a Reddit post ID and a payment header ($0.06 in USDC via x402 or MPP/Tempo), and receive a 202 response containing a JWT token. You then poll a separate jobs endpoint (GET /api/jobs?token=...) with SIWX wallet authentication until the data is ready. The async two-step flow (pay-to-trigger, then poll) typically completes in 5–60 seconds, with tokens valid for 30 minutes.
StableSocial covers four platforms (TikTok, Instagram, Facebook, Reddit) across 36 endpoints, all at a flat $0.06 per request. This specific endpoint — POST /api/reddit/post — accepts a single required field, `post_id` (the Reddit post ID), and returns the post's details once the job finishes. Payment settles only on successful 2xx responses; failed triggers are not charged. No API keys or signup required — the payment header serves as authentication.
The endpoint supports both x402 and MPP (method: tempo, intent: charge) payment protocols, settling in USDC. The probe returned 405 on HEAD/GET because this is a POST-only endpoint, which is expected behavior per the OpenAPI spec. The root landing page at stablesocial.dev returned 200, and a full OpenAPI 3.1.0 spec with detailed guidance documentation is available.
Capabilities
Use cases
- —Retrieving metadata and content of a specific Reddit post by ID for research or monitoring
- —Feeding Reddit post data into an AI agent pipeline for sentiment analysis or summarization
- —Building social listening dashboards that include Reddit post details
- —Archiving or indexing Reddit posts programmatically without managing Reddit API credentials
- —Competitive intelligence gathering from Reddit discussions
Fit
Best for
- —AI agents needing on-demand Reddit post data without managing OAuth credentials
- —Pay-as-you-go social media data collection across multiple platforms
- —Developers who want a unified API instead of platform-specific Reddit API setup
Not for
- —High-volume bulk Reddit scraping where per-request costs would accumulate significantly
- —Real-time streaming of Reddit posts (this is async poll-based, not websocket/streaming)
- —Accessing private or restricted Reddit content (fetches publicly available data)
Quick start
# Step 1: Trigger the job (requires MPP/x402 payment header)
curl -X POST https://stablesocial.dev/api/reddit/post \
-H 'Content-Type: application/json' \
-d '{"post_id": "1abc2de"}'
# Returns 202: {"token": "eyJ..."}
# Step 2: Poll for results (requires SIWX wallet auth)
curl https://stablesocial.dev/api/jobs?token=eyJ...Example
Request
{
"post_id": "1abc2de"
}Response
{
"token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
}Endpoint
Quality
Full OpenAPI 3.1.0 schema with detailed x-guidance documentation, clear pricing ($0.06/request), and well-defined request schema. The 405 on HEAD/GET is expected since this is a POST-only endpoint. Docked slightly because no response schema is defined (only 200: 'Successful response'), no example response data structure is documented, and the /docs page returns 404.
Warnings
- —Probe returned 405 because HEAD/GET were tried on a POST-only endpoint — this is expected, not a failure
- —No response schema defined in OpenAPI spec — the shape of returned Reddit post data is undocumented
- —The /docs page returns 404; all documentation is embedded in the OpenAPI x-guidance field
- —Polling step requires SIWX wallet authentication, which adds complexity beyond the initial payment
Citations
- —Each request costs $0.06 in USDChttps://stablesocial.dev
- —Endpoint uses async two-step flow: POST to trigger (paid), then GET /api/jobs to poll (free with SIWX auth)https://stablesocial.dev/openapi.json
- —POST /api/reddit/post requires a single field post_id (Reddit post ID)https://stablesocial.dev/openapi.json
- —Supports both x402 and MPP (method: tempo, intent: charge) payment protocolshttps://stablesocial.dev/openapi.json
- —Tokens expire after 30 minutes; jobs typically finish in 5–60 secondshttps://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, Reddit)https://stablesocial.dev