{"uid":"cap_Tmjy1TL_AdxS-7ubbMLn8","slug":"api-direct-reddit-post-search-408e371a","name":"API Direct – Reddit Post Search","description":"Search for Reddit posts by keyword across all subreddits.","url":"https://x402.apidirect.io/v1/reddit/posts?utm_source=zero.xyz","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","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","required":["query"],"properties":{"page":{"type":"integer","default":1,"maximum":12,"minimum":1,"description":"Page number for pagination (1-12). Each page returns up to 20 posts."},"query":{"type":"string","maxLength":500,"description":"Search query (max 500 characters). Reddit search operators are supported, including AND, OR, NOT, exclusion with -, grouping with ( ), and fields such as subreddit: and author:."},"sort_by":{"enum":["most_recent","relevance","hot","top","most_commented"],"type":"string","default":"most_recent","description":"Sort order for results"},"subreddit":{"type":"string","maxLength":25,"description":"Only return posts from this subreddit, with or without r/ (e.g. Python). Any name that isn't 2-21 letters, digits or underscores returns 400."},"posted_ago":{"enum":["1h","24h","7d","30d","12m","all"],"type":"string","description":"Only return posts from this period: 1h (past hour), 24h (past day), 7d (past week), 30d (past month), 12m (past year) or all (all time, the default). Works with every sort_by, e.g. sort_by=relevance with posted_ago=24h returns the most relevant posts of the past day. Any other value returns 400."},"include_nsfw":{"type":"boolean","default":false,"description":"Set to true to include posts marked NSFW. They are left out by default."},"get_sentiment":{"type":"boolean","default":false,"description":"Set to true to add AI emotion analysis to each post. Adds a `sentiment` object containing `emotions` (joy, trust, fear, surprise, sadness, disgust, anger and anticipation, each scored 0-100), `dominant_emotion`, `emotional_intensity` (0-10), and `polarity` (positive, negative or neutral). Any post t"}}}},"additionalProperties":false}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.004","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.004/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.004","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.004","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Z-EkgK5AkBdJcCLAXP1F1","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.004","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Search Reddit posts by keyword across all subreddits or within a specific subreddit, with optional sentiment analysis.","exampleAgentPrompt":"Search Reddit for posts mentioning 'ChatGPT jailbreak' from the past 7 days, sorted by most recent, and include AI sentiment analysis on each post.","exampleUseCases":[{"title":"Brand reputation monitoring on Reddit","prompt":"Search Reddit for posts mentioning 'Robinhood app' from the past 30 days sorted by relevance — I want to see what people are saying and get sentiment analysis so I can understand the emotional tone."},{"title":"Finding niche community discussions","prompt":"Find the top posts in r/investing about 'index funds vs ETFs' from the past year, sorted by most commented, first page only."},{"title":"Competitive research on Reddit","prompt":"Search Reddit for posts about 'Notion vs Obsidian' from the past week, sorted by hot, and include NSFW posts too so I get the full picture."}],"resultDescription":"Returns a paginated list of up to 20 Reddit posts per page matching the query, including post title, body, author, subreddit, upvotes, comment count, URL, and timestamp. If sentiment analysis is enabled, each post also includes an emotions breakdown (joy, trust, fear, surprise, sadness, disgust, anger, anticipation scored 0–100), dominant emotion, emotional intensity (0–10), and polarity (positive/negative/neutral).","failureModes":["Invalid subreddit name (non-alphanumeric characters or wrong length) returns HTTP 400","Invalid posted_ago value returns HTTP 400","Query exceeding 500 characters returns 400","Empty or no results for niche queries returns empty list","Reddit rate limiting or availability issues may cause intermittent failures","Page number out of range (>12) returns 400"],"whenToPreferThis":"Use this endpoint when you need to search Reddit specifically — across all subreddits or within one — with flexible sorting, time filtering, and optional AI sentiment analysis. Prefer this over generic web search when you want structured Reddit post data with upvote/comment counts and subreddit attribution. Choose the sentiment flag when you need emotional tone analysis on community discussions rather than just raw text.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-30T19:08:07.242Z","isFirstParty":false,"canonicalSlug":"api-direct-reddit-post-search-408e371a"}