{"uid":"cap_egANjvuIz6zncTDt5-iLV","slug":"socialfetch-reddit-search-3a727a2e","name":"SocialFetch Reddit Search","description":"Search Reddit posts site-wide by keyword (not scoped to one subreddit — use reddit.subreddit.search.list for that).","url":"https://api.socialfetch.dev/v1/reddit/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":["query"],"properties":{"trim":{"anyOf":[{"type":"boolean"},{"enum":["0","1","true","false"],"type":"string"}],"description":"Whether to request a smaller response shape when available."},"query":{"type":"string","maxLength":512,"minLength":1,"description":"Search query text for public Reddit posts."},"cursor":{"type":"string","minLength":1,"description":"Opaque pagination cursor returned by a previous response."},"sortBy":{"enum":["relevance","new","top"],"type":"string","description":"Optional sort order for search results."},"timeframe":{"enum":["all","day","week","month","year"],"type":"string","description":"Optional time range filter for search results."}}}},"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":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"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_6evhZ2fbnzyPUT__6wnJ7","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 public Reddit posts by keyword with optional sorting and time filtering, returning paginated results.","exampleAgentPrompt":"Search Reddit for posts about 'AI agent frameworks', sorted by top results from the past month, and show me what people are saying.","exampleUseCases":null,"resultDescription":"A paginated list of public Reddit posts matching the search query, including post titles, body text, subreddit, author, upvote count, comment count, and post URL. A cursor is returned for fetching the next page of results.","failureModes":["Missing required 'query' parameter returns a validation error","Query exceeding 512 characters is rejected","Invalid enum value for sortBy or timeframe returns a schema error","Expired or invalid pagination cursor returns an error","Reddit API rate limits or downtime may cause upstream failures","No results found for the query returns an empty list"],"whenToPreferThis":"Use this endpoint when you need to programmatically search Reddit posts by keyword across all of Reddit, with control over sort order (relevance, new, top) and time range. Prefer this over manual scraping or Reddit's own API when you need a simple paid-per-call REST interface without OAuth setup.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T06:43:13.674Z","isFirstParty":false}