Fetch Reddit subreddit posts on demand for $0.06 per request via MPP/x402 payment.
What it does
This endpoint retrieves posts from a specified Reddit subreddit. It is part of StableSocial, a pay-per-request social media data API covering TikTok, Instagram, Facebook, and Reddit (36 endpoints total). Every call costs a flat $0.06 in USDC, settled via x402 or MPP (Tempo method). No API keys or subscriptions are required — payment itself serves as authentication.
The workflow is asynchronous: you POST to `/api/reddit/subreddit` with a JSON body containing the subreddit name (without the `r/` prefix), along with optional pagination parameters (`max_page_size`, `cursor`). On success, you receive a 202 response with a 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. Tokens expire after 30 minutes; jobs typically complete in 5–60 seconds.
The endpoint supports cursor-based pagination: each finished response includes `page_info` with `has_next_page` and a `cursor` value. Fetching the next page requires a new paid POST. Results default to 50 items per page. The OpenAPI spec is published at `stablesocial.dev/openapi.json` and covers all 36 endpoints with full request schemas.
Capabilities
Use cases
- —Monitoring a subreddit for new posts on a topic or brand
- —Collecting subreddit posts for sentiment analysis or trend detection
- —Building a social listening dashboard that includes Reddit data
- —Agent-driven research across Reddit communities
- —Aggregating subreddit content for competitive intelligence
Fit
Best for
- —AI agents that need on-demand Reddit subreddit data without managing API keys
- —Pay-as-you-go social media research with no subscription commitment
- —Programmatic collection of subreddit posts with cursor-based pagination
Not for
- —High-volume bulk Reddit archiving where $0.06 per page would be cost-prohibitive
- —Use cases requiring real-time streaming of Reddit posts (this is async polling)
- —Accessing private or quarantined subreddits (no indication of support)
Quick start
# Step 1: Trigger the job (requires MPP or x402 payment header)
curl -X POST https://stablesocial.dev/api/reddit/subreddit \
-H 'Content-Type: application/json' \
-d '{"name": "programming", "max_page_size": 25}'
# → 202 {"token": "eyJ..."}
# Step 2: Poll for results (free, SIWX wallet auth required)
curl https://stablesocial.dev/api/jobs?token=eyJ...
# → 200 {"status": "finished", "data": {...}}Example
Request
{
"name": "programming",
"max_page_size": 25
}Response
{
"token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
}Endpoint
Quality
Full OpenAPI schema with clear request parameters and documented async flow. The endpoint is a POST-only route so the HEAD/GET probe returning 405 is expected and does not indicate downtime. However, no example response data schema is provided (only 200: "Successful response"), and the docs page returns 404, so the actual shape of returned subreddit data is unknown.
Warnings
- —Probe returned 405 because HEAD/GET were used on a POST-only endpoint; the endpoint is likely live but liveness could not be confirmed via 402 challenge.
- —No response schema is documented — the structure of returned subreddit post data is unspecified in the OpenAPI spec.
- —The /docs page returns 404; detailed documentation beyond the OpenAPI guidance field is unavailable.
- —SIWX wallet authentication is required for the polling step, which adds integration complexity beyond a simple HTTP call.
Citations
- —Every endpoint costs $0.06 per request in USDC, settled via x402 or MPP (Tempo).https://stablesocial.dev
- —The subreddit endpoint accepts a required 'name' parameter (subreddit name without r/) plus optional max_page_size and cursor.https://stablesocial.dev/openapi.json
- —The async two-step flow returns a 202 with a JWT token, then you poll GET /api/jobs?token=... with SIWX wallet auth.https://stablesocial.dev
- —Tokens expire after 30 minutes; jobs typically finish in 5–60 seconds.https://stablesocial.dev
- —Payment only settles on 2xx responses; failed triggers are not charged.https://stablesocial.dev