{"uid":"cap_xb6e9dMRS586gipELhUFL","slug":"reddit-posts-comments-scraper-908f23c4","name":"Reddit Posts & Comments Scraper","description":"Pay-per-call structured web data. Failed or empty runs are not charged.","url":"https://api.scrapeforagents.tech/v1/reddit-posts?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"sort":{"enum":["best","top","new","old","controversial","qa"],"type":"string","default":"best","description":"Order comments from the scanned archive records. Best uses score as an approximation; Q&A puts original-poster comments first."},"filter":{"enum":["","answered","unanswered"],"type":"string","default":"","description":"Keep only threads answered by the original poster or only unanswered threads. Applies to scanned comments."},"postUrl":{"type":"string","description":"One public Reddit post URL, redd.it link, or post ID."},"queries":{"type":"array","items":{"type":"string"},"default":[],"description":"Find archived public posts by keyword when no URLs are supplied."},"maxItems":{"type":"integer","default":0,"minimum":0,"description":"Maximum combined post and comment rows. Set 0 for no output cap."},"postUrls":{"type":"array","items":{"type":"string"},"default":[],"description":"Multiple public post URLs or IDs to collect in one run."},"postUrlsFile":{"type":"string","description":"HTTPS URL of a TXT file with one post per line or CSV with a url or permalink column, up to 5 MB."},"maxScanPerPost":{"type":"integer","default":1000,"maximum":10000,"minimum":100,"description":"Maximum comments to scan per post before sorting; extended scan raises this to at least 10,000."},"maxPostsPerQuery":{"type":"integer","default":25,"maximum":1000,"minimum":1,"description":"Maximum matching posts to collect for each search keyword."},"expandAllComments":{"type":"boolean","default":false,"description":"Scan up to 10,000 archived comments per post before sorting and filtering. This cannot recover comments absent from the archive."},"maxCommentsPerPost":{"type":"integer","default":200,"minimum":0,"description":"Maximum comment rows per post. Set 0 to keep all scanned comments."}}},"responseSchema":{"type":"json","example":{"count":1,"items":[{"id":null,"_type":null,"title":null,"author":null,"_status":null,"postUrl":null,"_post_id":null,"subreddit":null}],"product":"reddit-posts"}},"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_9FJQ98lPxsF9JI1wfBXp1","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":"Fetches structured Reddit post and comment data by URL, post ID, or keyword search query","exampleAgentPrompt":"Search Reddit for posts about 'mechanical keyboards' sorted by top, collect up to 25 posts per query and return up to 200 comments per post — only threads answered by the original poster.","exampleUseCases":[{"title":"Competitor sentiment research from Reddit","prompt":"Search Reddit for posts mentioning 'Notion vs Obsidian', sort by best, pull up to 50 posts per query and show me up to 300 comments per post so I can understand what real users prefer."},{"title":"Fetch comments from a specific Reddit thread","prompt":"Grab all comments from this Reddit thread — https://www.reddit.com/r/personalfinance/comments/abc123/ — sorted by top, with a max of 500 comments, and only show me replies that the original poster responded to."},{"title":"Bulk scrape Reddit posts from a keyword list","prompt":"Collect Reddit posts for each of these search terms: 'best protein powder', 'whey vs plant protein', and 'protein powder side effects' — get 20 posts per keyword sorted by top and limit output to 100 comments per post."}],"resultDescription":"A JSON object containing a count of items and an array of post and comment rows, each with fields including post ID, type, title, author, status, post URL, internal post ID, and subreddit name.","failureModes":["Private or deleted Reddit posts return empty results and are not charged","Invalid or malformed post URLs result in an error or empty item list","Keyword queries with no matching archived posts return zero items","Posts with very few archived comments may return less than the requested maxCommentsPerPost","Rate limits or scraping restrictions on Reddit archives may cause partial results","TXT/CSV file URL over 5 MB is rejected","maxScanPerPost below 100 is rejected due to schema minimum constraint"],"whenToPreferThis":"Choose this endpoint when you need structured, pay-per-result Reddit data without paying for failed runs. It is well-suited for bulk collection across multiple post URLs or keyword searches in a single call, and supports sorting and filtering comments (e.g. only OP-answered threads). Prefer this over general web scrapers when you specifically need Reddit post and comment structure with minimal setup.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T00:46:59.978Z","isFirstParty":false,"canonicalSlug":"reddit-posts-comments-scraper-908f23c4"}