Search Reddit posts by keyword via pay-per-request API — $0.06 per call, no API keys needed.
What it does
This endpoint searches Reddit posts by keyword through StableSocial's unified social media data API. It is part of a broader suite of 36 endpoints covering TikTok, Instagram, Facebook, and Reddit. You POST a JSON body with your search keywords, and the service returns a 202 Accepted with a JWT token. You then poll a separate GET /api/jobs endpoint (authenticated via SIWX wallet signature) until results are ready, typically within 5–60 seconds.
Every call costs a flat $0.06 USD, settled via USDC on Base, Solana, or Tempo (pathUSD). Payment acts as authentication — there are no API keys, accounts, or subscriptions. If the trigger POST fails (bad params, entity not found), you are not charged; payment only settles on 2xx responses. Results support pagination via a cursor field in the response's page_info object; each subsequent page requires a new paid POST.
The request body accepts `keywords` (required string), `max_posts` (default 50), `max_page_size` (default 50), and an optional `cursor` for pagination. Tokens expire after 30 minutes and can be polled repeatedly. Only the wallet that paid can retrieve results.
Capabilities
Use cases
- —Monitoring Reddit discussions about a brand, product, or topic in near real-time
- —Gathering Reddit post data for sentiment analysis or market research
- —Building social listening dashboards that include Reddit alongside other platforms
- —Agents autonomously researching Reddit threads relevant to a user query
- —Competitive intelligence by tracking keyword mentions across subreddits
Fit
Best for
- —AI agents that need on-demand Reddit search without managing API credentials
- —Pay-as-you-go social media research with no subscription commitment
- —Multi-platform social data pipelines where Reddit is one of several sources
Not for
- —High-volume bulk Reddit archival (each page costs $0.06, which adds up quickly)
- —Real-time streaming of Reddit content (this is an async poll-based API)
- —Use cases requiring official Reddit API features like voting, posting, or moderation
Quick start
# Step 1: Trigger search (requires MPP/x402 payment header)
curl -X POST https://stablesocial.dev/api/reddit/search \
-H 'Content-Type: application/json' \
-d '{"keywords": "artificial intelligence", "max_posts": 10}'
# → 202 {"token": "eyJ..."}
# Step 2: Poll for results (requires SIWX wallet auth)
curl 'https://stablesocial.dev/api/jobs?token=eyJ...'Example
Request
{
"keywords": "artificial intelligence",
"max_posts": 10,
"max_page_size": 10
}Response
{
"token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
}Endpoint
Quality
Full OpenAPI schema with clear request parameters and pricing is available. The endpoint is a POST-only route, so the probe's HEAD/GET returning 405 is expected and does not indicate downtime. However, no example response data schema is documented (only the 202 token response), and the /docs page returns 404, so the actual shape of Reddit search results must be inferred.
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 for the actual search results — only the 202 token envelope is specified.
- —The /docs page returns 404; all documentation comes from the OpenAPI spec's x-guidance field and the landing page.
- —SIWX wallet authentication is required for polling results, which adds integration complexity beyond the initial payment.
Citations
- —Every endpoint costs $0.06 per request, settled via USDC on Base, Solana, or Tempo.https://stablesocial.dev
- —The reddit/search endpoint accepts keywords (required), max_posts, max_page_size, and cursor parameters.https://stablesocial.dev/openapi.json
- —Requests follow an async two-step flow: POST to trigger (paid, returns JWT token), then GET /api/jobs to poll (free, SIWX wallet auth required).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
- —The API covers 36 endpoints across TikTok, Instagram, Facebook, and Reddit.https://stablesocial.dev