{"uid":"cap_w7_tqepSj5H0_uWFTvKUX","slug":"reddit-scraper-api-25cc5df9","name":"Reddit Scraper API","description":"Pay-per-call structured web data. Failed or empty runs are not charged.","url":"https://api.scrapeforagents.tech/v1/reddit?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"maxItems":{"type":"integer","default":100,"minimum":0,"description":"Hard cap on all dataset rows. Set 0 for no overall cap."},"searches":{"type":"array","items":{"type":"string"},"description":"Title and comment text queries. A community is required for keyword search."},"startUrls":{"type":"array","items":{"type":"object","required":["url"],"properties":{"url":{"type":"string","title":"URL","description":"Public Reddit URL."}}},"description":"Public Reddit community, post, or user URLs. Search terms are ignored when URLs are supplied."},"includeNSFW":{"type":"boolean","default":false,"description":"Include records marked as mature content."},"maxComments":{"type":"integer","default":100,"minimum":0,"description":"Maximum comment rows from each post URL, user comment URL, or search term."},"searchPosts":{"type":"boolean","default":true,"description":"Return matching post titles for each search term."},"searchUsers":{"type":"boolean","default":false,"description":"Look up a user whose name exactly matches each search term."},"maxPostCount":{"type":"integer","default":100,"minimum":0,"description":"Maximum post rows from each community or user URL or search term."},"maxUserCount":{"type":"integer","default":10,"minimum":0,"description":"Maximum exact user matches for a search term."},"skipComments":{"type":"boolean","default":false,"description":"Do not collect comments when a direct post URL is supplied."},"postDateLimit":{"type":"string","description":"Only return posts created on or after this ISO date or timestamp."},"skipCommunity":{"type":"boolean","default":false,"description":"Do not add a community metadata row when collecting a community URL."},"skipUserPosts":{"type":"boolean","default":false,"description":"Do not collect posts from a user URL."},"searchComments":{"type":"boolean","default":false,"description":"Return matching comment bodies for each search term."},"commentDateLimit":{"type":"string","description":"Only return comments created on or after this ISO date or timestamp."},"searchCommunities":{"type":"boolean","default":false,"description":"Look up a community whose name exactly matches each search term."},"maxCommunitiesCount":{"type":"integer","default":10,"minimum":0,"description":"Maximum exact community matches for a search term."},"searchCommunityName":{"type":"string","description":"Community to search, without r/. Required when using search terms."}}},"responseSchema":{"type":"json","example":{"count":1,"items":[{"id":null,"url":null,"title":null,"userId":null,"dataType":null,"parsedId":null,"username":null,"communityName":null}],"product":"reddit"}},"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_-YeAj2pPFiXKbDXpAzRBU","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":"Scrapes structured data from Reddit including posts, comments, users, and communities via search queries or direct URLs","exampleAgentPrompt":"Search Reddit for posts and comments mentioning 'electric vehicle charging' in the r/electricvehicles community, grab up to 50 posts and 100 comments each, and only include content from after January 1 2024 — skip NSFW results.","exampleUseCases":[{"title":"Brand sentiment monitoring on Reddit","prompt":"Scrape Reddit for all posts and comments mentioning 'Notion AI' across any subreddit, up to 200 posts and 50 comments per post, from the last 3 months — I want to understand what people are saying about the product."},{"title":"Subreddit research for market analysis","prompt":"Pull the top 100 posts from r/personalfinance along with their comments, posted after March 1 2024, so I can analyze what financial topics people are most concerned about right now."},{"title":"Thread deep-dive for competitive intelligence","prompt":"Grab all the comments from this Reddit thread — https://www.reddit.com/r/startups/comments/xyz123 — up to 200 comments, so I can read through the full discussion without missing anything."}],"resultDescription":"Returns a JSON object with a count and an array of items, each representing a Reddit entity (post, comment, user, or community) with fields including id, url, title, userId, dataType, parsedId, username, and communityName. Failed or empty runs are not billed.","failureModes":["Private or deleted subreddit/post returns empty results","Invalid URL format causes request rejection","Search without a specified community may return no results","Rate limiting or Reddit blocking may cause empty or partial results","Date filters that are too restrictive may return zero items","Malformed ISO date string in postDateLimit or commentDateLimit causes error"],"whenToPreferThis":"Choose this endpoint when you need structured, pay-per-call Reddit data extraction without managing a scraper infrastructure. It is well-suited for keyword searches within communities, full thread extraction, user profile scraping, and community-level post collection. Prefer it over general web scrapers when you specifically need Reddit-shaped data (posts, comments, users, communities) with granular controls like date filters, NSFW toggles, and per-entity row caps.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T00:47:37.301Z","isFirstParty":false,"canonicalSlug":"reddit-scraper-api-25cc5df9"}