A Reddit API alternative on fetcher.sh — pay-per-call in USDC via x402, or prepaid credits with a Bearer key, no OAuth app registration. Use when the user wants to search Reddit posts across every subreddit by keyword and sort by top, hot, new, or most-discussed, search subreddits or users by keywor

Reddit API Reddit data on demand: cross subreddit post search, subreddit and user search, subreddit info and feeds, single posts with full comment trees, sitewide best/hot/new/top feeds, and user profiles/posts/comments — one plain HTTP GET per call, paid as you go. No OAuth app registration, no client ID/secret pair, no Reddit API rate limit tier. Base URL: https://reddit.fetcher.sh Authentication Two ways to pay, same data — full mechanics in the [ fetcher skill](../fetcher/SKILL.md): Every response is { "status": number, "message": string, "data": ... } ; the HTTP status mirrors status . Endpoints (15 — all GET, $0.002/call) Endpoint What it returns /api/search/post Posts across every subreddit matching a keyword /api/search/subreddit Subreddits matching a keyword /api/search/user Users matching a keyword /api/subreddit/{name} A subreddit's info /api/subreddit/{name}/posts A subreddit's post feed /api/post/{id} A single post /api/post/{id}/comments A post's comment tree /api/post/{id}/comments/{commentId}/replies Replies to a comment /api/posts/hot Sitewide hot feed /api/posts/new Sitewide new feed /api/posts/top Sitewide top feed /api/posts/best Sitewide best feed /api/user/{username} A user's profile /api/user/{username}/posts A user's posts /api/user/{username}/comments A user's comments {id} / {name} / {username} are path parameters. Optional sort / cursor reorder and paginate; keyword (search) is required where it appears. Scenarios Top posts about a topic, across every subreddit: Most discussed (highest comment count): Newest first: Other sort values for /api/search/post : relevance , hot . Search subreddits or users by keyword: A subreddit's info, then its hot/new/top feed: A single post, its comment tree, and replies to one comment: Sitewide feeds: A user's profile, posts, and comments: MCP Free: search endpoints , describe endpoint , check balance . Paid: fetch data (any endpoint above), topup credits , plus the named shortcut reddit search post . Drop the headers block to pay per call with x402 instead — see the [ fetcher skill](../fetcher/SKILL.md) for the full flow. Errors 400 — missing/invalid parameter (message names it) 401 — unknown or rotated key 402 — payment required (x402 challenge) or topup required (credits exhausted) 404 — not a priced path No rate limits; no refunds on upstream failures (settlement precedes delivery) Reference Full agent setup: <https://reddit.fetcher.sh/skill.md OpenAPI 3.1 contract: <https://reddit.fetcher.sh/openapi.json Condensed catalog: <https://reddit.fetcher.sh/llms.txt Payment, credits, and MCP deep dive: [ fetcher skill](../fetcher/SKILL.md) Site: <https://reddit.fetcher.sh

reddit-api