{"uid":"cap_x9kKDIFQ8PIKNN9b2s4S4","slug":"reddit-search-scraper-x402-bbbdc022","name":"Reddit Search Scraper (x402)","description":"Pay-per-call structured web data. Failed or empty runs are not charged.","url":"https://x402.186-241-26-229.sslip.io/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_xa7QozTSFp-0-fYuLJGhZ","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 retrieves structured Reddit posts and comments by keyword, subreddit, URL, or date range, with pay-per-call billing via x402.","exampleAgentPrompt":"Search Reddit for the top 50 posts mentioning 'AI agents' from the past month sorted by relevance, and include up to 20 comments per post — skip any NSFW content.","exampleUseCases":[{"title":"Brand sentiment monitoring on Reddit","prompt":"Search Reddit for any posts mentioning 'Notion AI' from the last week, sorted by top score, and give me up to 30 posts with their comments so I can see what users are saying about it."},{"title":"Subreddit topic research","prompt":"Pull the 100 newest posts from the r/personalfinance subreddit and include up to 50 comments each — I want to see what financial questions people are asking right now."},{"title":"Competitive product feedback gathering","prompt":"Find Reddit discussions about 'Figma vs Sketch' posted between 2024-01-01 and 2024-06-30, sorted by relevance, and return up to 40 posts with comments so I can analyze user opinions."}],"resultDescription":"Returns a JSON object with a count and an array of items, each containing post ID, title, body, author, subreddit, score, kind, and the originating query. Comments are nested within posts up to the maxComments limit.","failureModes":["Empty result set if queries return no matching posts (not charged)","Invalid date format for dateFrom/dateTo causes rejection","Subreddit name not found or private returns empty results","maxPosts or maxComments exceeding platform limits silently capped at 100","NSFW posts excluded by default unless includeNsfw is set to true","Network timeout on large comment fetches for high-activity threads"],"whenToPreferThis":"Choose this endpoint when you need structured Reddit data (posts + comments) programmatically without managing Reddit API credentials or rate limits. Ideal for agents doing sentiment analysis, trend research, or competitive intelligence on Reddit. Pay-per-call x402 billing means no subscription cost — only pay for successful, non-empty runs. Prefer over raw Reddit API when you want normalized JSON output and date filtering out of the box.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T00:47:07.155Z","isFirstParty":false,"canonicalSlug":"reddit-search-scraper-x402-bbbdc022"}