{"uid":"cap_9C_0y0gM5sn7nefvWRNor","slug":"socialfetch-reddit-subreddit-post-search-20e48b8f","name":"SocialFetch Reddit Subreddit Post Search","description":"Search posts within one subreddit (not site-wide — use reddit.search.list for that).","url":"https://api.socialfetch.dev/v1/reddit/subreddits/search","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["subreddit"],"properties":{"sort":{"enum":["relevance","hot","top","new","comments"],"type":"string","description":"Sort order for search results. Default: `relevance`."},"query":{"type":"string","maxLength":512,"minLength":1,"description":"Search text to match against public subreddit posts."},"cursor":{"type":"string","minLength":1,"description":"Opaque pagination cursor returned by a previous response."},"subreddit":{"type":"string","maxLength":256,"minLength":1,"description":"Subreddit name, optional `r/` prefix, or Reddit subreddit URL. Must match Reddit's exact casing. Searches posts within this subreddit."},"timeframe":{"enum":["all","year","month","week","day","hour"],"type":"string","description":"Time range filter for search results. Default: `all`."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.014","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":1,"rating":{"score":"0.75","successRate":"1.00","reviews":1,"stars":"4.0","state":"rated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.014/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.014","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.014","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_OWl2cUt-qFLzhVvufu2BU","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.014","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Search posts within a specific subreddit by keyword, with optional sort order and time range filtering.","exampleAgentPrompt":"Search r/MachineLearning for posts mentioning 'diffusion models', sorted by top results from the past month.","exampleUseCases":null,"resultDescription":"A list of Reddit posts from the specified subreddit matching the search query, including post metadata such as title, author, score, URL, and content snippet, along with a pagination cursor for fetching the next page of results.","failureModes":["Invalid or non-existent subreddit name returns an error or empty results","Subreddit casing mismatch may fail to find the community (must match Reddit's exact casing)","Empty or missing query with no subreddit defaults may return unexpected results","Invalid cursor string causes pagination failure","Rate limiting or payment failure (x402) blocks the request","Private or banned subreddits are not accessible and return an error"],"whenToPreferThis":"Use this endpoint when you need to search posts within a single, known subreddit — not across all of Reddit. If you need site-wide Reddit search across all communities, use reddit.search.list instead. Ideal for monitoring a specific community, researching what a subreddit is saying about a topic, or building subreddit-specific content pipelines.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":6,"lastUsedAt":"2026-07-28T19:06:09.749Z","lastSuccessfullyRanAt":"2026-07-28T19:06:09.749Z","lastHealthCheckAt":"2026-09-15T00:44:07.576Z","isFirstParty":false}