{"uid":"cap_xt2jTcYo3BKtIZ8yzE5-8","slug":"reddit-search-scrape-api-c5feae26","name":"Reddit Search & Scrape API","description":"Pay-per-call structured web data. Failed or empty runs are not charged.","url":"https://api.scrapeforagents.tech/v1/reddit-search?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"sort":{"enum":["relevance","hot","top","new","comments"],"type":"string","default":"relevance","description":"Global archive order. New uses creation time; top and comments use archived counts. Relevance and hot currently use newest order."},"urls":{"type":"array","description":"Optional post, search, subreddit, or user-submitted URLs. These take priority over queries and subredditName."},"dateTo":{"type":"string","description":"Keep posts on or before this UTC date (YYYY-MM-DD) or ISO timestamp."},"queries":{"type":"array","description":"Search phrases across public Reddit posts. Ignored when urls are supplied."},"dateFrom":{"type":"string","description":"Keep posts on or after this UTC date (YYYY-MM-DD) or ISO timestamp."},"maxItems":{"type":"integer","default":0,"minimum":0,"description":"Hard cap across posts and comments. Zero means no total cap."},"maxPosts":{"type":"integer","default":100,"minimum":1,"description":"Maximum posts per target. Community archive currently exposes at most 100 per target."},"timeframe":{"enum":["all","year","month","week","day","hour"],"type":"string","default":"all","description":"Reddit's time window for global searches."},"includeNsfw":{"type":"boolean","default":false,"description":"Include posts marked as adult content."},"maxComments":{"type":"integer","default":100,"minimum":1,"description":"Maximum comments from the initial public thread response for each post."},"commentDateTo":{"type":"string","description":"Keep comments on or before this UTC date or ISO timestamp."},"subredditName":{"type":"string","description":"Optional community name without r/. With no subredditKeywords, collect its newest posts."},"subredditSort":{"enum":["relevance","hot","top","new","comments"],"type":"string","default":"relevance","description":"Order the returned community archive page: newest for relevance/new, archived score for top/hot, or archived comment count for comments."},"scrapeComments":{"type":"boolean","default":false,"description":"Collect public comments from each saved post."},"commentDateFrom":{"type":"string","description":"Keep comments on or after this UTC date or ISO timestamp."},"strictTokenFilter":{"type":"boolean","default":false,"description":"Keep a post only when every query word appears in its title, body, or outbound URL."},"subredditKeywords":{"type":"array","description":"Search phrases to run within subredditName. Leave empty for the newest feed."},"subredditTimeframe":{"enum":["all","year","month","week","day","hour"],"type":"string","default":"all","description":"Client-side time window applied to returned community archive posts."}}},"responseSchema":{"type":"json","example":{"count":1,"items":[{"id":null,"body":null,"kind":null,"query":null,"score":null,"title":null,"author":null,"subreddit":null}],"product":"reddit-search"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.025","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.025/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.025","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.025","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_JwqFJLKNOp3II7ACMR4CR","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.025","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Searches and scrapes structured data from public Reddit posts, comments, subreddits, and user profiles via keyword queries or direct URLs","exampleAgentPrompt":"Search Reddit for posts about 'mechanical keyboards' sorted by top posts from the past month, grab up to 50 posts with their top 100 comments each, and exclude NSFW content.","exampleUseCases":[{"title":"Brand sentiment monitoring on Reddit","prompt":"Find all Reddit posts mentioning 'Notion app' from the last week sorted by relevance, get up to 100 posts with their comments, and skip any NSFW results — I want to see what people are saying about it."},{"title":"Competitor research from subreddit","prompt":"Scrape the newest 100 posts from the r/solotravel subreddit sorted by hot, including up to 50 comments per post, so I can understand what topics are trending in that community."},{"title":"Extracting discussion from a specific thread","prompt":"Pull all the comments from this Reddit thread — https://www.reddit.com/r/investing/comments/abc123 — up to 100 comments, so I can analyze what users are saying about the stock."}],"resultDescription":"Returns a JSON object with a count of results and an array of items, each containing post/comment id, body text, kind (post or comment), search query used, score, title, author username, and subreddit name.","failureModes":["Empty result set if query matches no public Reddit posts (not charged)","Rate limiting or timeout if too many targets are requested simultaneously","Invalid date format returns a validation error","Subreddit name not found returns empty results","URLs pointing to private or deleted Reddit content return no items"],"whenToPreferThis":"Choose this endpoint when you need structured, pay-per-call Reddit data without building your own scraper — especially useful when querying by keyword, subreddit, or direct post URL with flexible date filtering and sort options. Prefer it over raw HTTP Reddit scraping when you want clean JSON output and only pay for successful, non-empty runs.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T00:47:08.894Z","isFirstParty":false,"canonicalSlug":"reddit-search-scrape-api-c5feae26"}