Search Reddit posts via micropayment — $0.02/request, no API key needed.
What it does
This endpoint searches Reddit posts by query and returns truncated previews (selftext capped at 500 characters) for efficient browsing. It is part of StableEnrich, a pay-per-request research API suite hosted at stableenrich.dev. The endpoint accepts POST requests with a JSON body containing a query string, optional sort order (relevance, new, top, comment_count), timeframe filter (all, day, week, month, year), pagination cursor, and maxResults (1–25, default 10). Responses include post metadata: id, title, author, subreddit, score, comment count, creation date, truncated selftext, a selftextTruncated flag, and permalink. A companion endpoint at /api/reddit/post-comments can retrieve full untruncated text and comments for any post found via search.
Payment is handled via the MPP protocol (method: tempo, intent: charge) or x402, settling in pathUSD on Tempo L2. The fixed price is $0.02 per request. No API keys or subscriptions are required — payment itself serves as authentication. Payments on Base mainnet (eip155:8453), Solana, or Tempo are supported across the StableEnrich platform. On server errors (5xx), payments are not settled.
The endpoint is a POST-only route. The probe returned 405 on HEAD and GET, which is expected behavior for a POST endpoint. The full OpenAPI 3.1.0 schema is available with complete request/response definitions, and the provider's guidance documentation is thorough.
Capabilities
Use cases
- —Searching Reddit for discussions on a specific topic or keyword
- —Monitoring Reddit for brand mentions or product feedback
- —Gathering Reddit posts as research input for market analysis
- —Building a pipeline that searches Reddit then drills into comments on relevant posts
- —Agent-driven social listening across subreddits
Fit
Best for
- —AI agents that need programmatic Reddit search without API key management
- —Pay-per-use Reddit research where volume is unpredictable
- —Lightweight browsing of Reddit results before selectively fetching full post content
- —Combining with /api/reddit/post-comments for a two-step search-then-drill workflow
Not for
- —High-volume bulk Reddit scraping (cost adds up at $0.02/request)
- —Real-time streaming of Reddit content (this is a request-response API)
- —Fetching full post text and comments in a single call (use post-comments endpoint for that)
Quick start
POST https://stableenrich.dev/api/reddit/search
Content-Type: application/json
{
"query": "AI agents",
"sort": "top",
"timeframe": "week",
"maxResults": 10
}Example
Request
{
"sort": "top",
"query": "AI agents",
"timeframe": "week",
"maxResults": 10
}Response
{
"after": "t3_abc124",
"posts": [
{
"id": "abc123",
"score": 342,
"title": "Best AI agent frameworks in 2025",
"author": "techuser42",
"selftext": "I've been testing several AI agent frameworks and wanted to share my findings...",
"createdAt": "2025-01-15T12:00:00Z",
"permalink": "/r/artificial/comments/abc123/best_ai_agent_frameworks_in_2025",
"subreddit": "artificial",
"numComments": 87,
"selftextTruncated": true
}
],
"searchContext": {
"query": "AI agents",
"resultCount": 10
}
}Endpoint
Quality
Full OpenAPI 3.1.0 schema with complete request/response definitions, clear pricing ($0.02/request), detailed guidance documentation, and documented two-step workflow pattern. The probe returned 405 because the endpoint is POST-only, which is expected. No live 402 challenge was captured for this specific endpoint, but the OpenAPI spec confirms payment info and the platform root returns 200.
Warnings
- —Probe returned 405 on HEAD/GET because this is a POST-only endpoint — not an indication of downtime.
- —No direct 402 challenge was captured for this specific endpoint during probing; payment info is inferred from the OpenAPI spec's x-payment-info field.
Citations
- —Reddit Search endpoint price is $0.02 per requesthttps://stableenrich.dev
- —Selftext is truncated to 500 chars; posts with selftextTruncated: true have more content available via /api/reddit/post-commentshttps://stableenrich.dev
- —Payments are processed on Base mainnet (eip155:8453), Solana, or Tempohttps://stableenrich.dev
- —On server errors (5xx), payments are not settledhttps://stableenrich.dev
- —Sort options: relevance, new, top, comment_count; timeframe options: all, day, week, month, year; maxResults 1-25https://stableenrich.dev