{"uid":"cap_siw0ZiamlRzGQUK0OdR4i","slug":"agdata-reddit-search-subreddit-reader-c5d660ff","name":"agdata Reddit Search & Subreddit Reader","description":"Search Reddit or read a subreddit. Use mode hashtag with a subreddit name (no r/), profile with a username, or search with keywords, plus limit 1-20. Every record carries a normalized object with kind, title, body, author, subreddit, url, created_at, upvotes and comments_count. Comments are not fetched. upvotes and comments_count can be null, and subreddit mode may return the subreddit's own record (kind: community) with its description.","url":"https://agdata.shveik.dev/x402/reddit?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"mode":{"enum":["profile","hashtag","search"],"type":"string","description":"profile=user's posts, hashtag=subreddit's posts, search=keyword→posts"},"limit":{"type":"integer","default":5,"maximum":20,"minimum":1,"description":"max results returned (clamped to this range)"},"query":{"type":"string","description":"username (profile), subreddit without r/ (hashtag), or search keywords"}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.068","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.068/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.068","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.068","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_0Lb0g6nNHVJZsB3Mg0Mun","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.068","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Search Reddit by keyword, fetch posts from a subreddit, or retrieve a user's posts, returning normalized post records with metadata.","exampleAgentPrompt":"Search Reddit for the top 10 posts about 'mechanical keyboards' and show me the titles, authors, upvotes, and links.","exampleUseCases":[{"title":"Brand sentiment research on Reddit","prompt":"Search Reddit for the latest 15 posts mentioning 'Notion AI' and summarize what people are saying — include the titles, upvotes, and post URLs."},{"title":"Browse a specific subreddit's posts","prompt":"Fetch the 20 most recent posts from the r/personalfinance subreddit and list the titles with their upvote counts and links."},{"title":"Audit a Reddit user's post history","prompt":"Pull the last 10 posts made by Reddit user 'spez' and show me the titles, subreddits they posted in, and when each was posted."}],"resultDescription":"An array of up to 20 normalized post records, each containing: kind (post or community), title, body text, author username, subreddit name, URL, created_at timestamp, upvotes (nullable), and comments_count (nullable). In hashtag/subreddit mode, may also return a community record with the subreddit's description.","failureModes":["Invalid mode value — must be one of profile, hashtag, or search","Query string missing — required for all modes","Limit out of range — clamped to 1-20, defaults to 5","Private or banned subreddit returns no results or error","Suspended or nonexistent username returns empty result set","Reddit API rate limiting may cause partial or empty responses","upvotes and comments_count may be null for certain post types"],"whenToPreferThis":"Use this endpoint when you need structured Reddit post data — subreddit browsing, user post history, or keyword search — without needing comments. Ideal for agents that need normalized, consistent JSON output with metadata like upvotes and timestamps. Prefer over raw scraping when you need reliable field normalization across post types.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T18:31:10.212Z","isFirstParty":false,"canonicalSlug":"agdata-reddit-search-subreddit-reader-c5d660ff"}