{"uid":"cap_YnaL0B0vZZZvNhpDLEq7z","slug":"reddit-posts-subreddit-search-a06e38e6","name":"Reddit Posts & Subreddit Search","description":"Reddit Posts & Subreddit Search: search public Reddit posts by keyword, within one subreddit, or list a subreddit's newest posts. Per post the title, text, subreddit, author, upvotes, comment count, linked URL, time and permalink in the shared social schema; next_cursor gives the next page. Forum research and social listening. Bad input is free; not found or no match is not charged.","url":"https://social.duoleads.com/v1/reddit/search?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":[],"properties":{"q":{"type":"string","maxLength":200,"description":"Search text (1-200 characters). Give q, subreddit or both."},"cursor":{"type":"string","maxLength":512,"description":"next_cursor of the previous page."},"subreddit":{"type":"string","maxLength":24,"description":"Limit to one community: a subreddit name: 2 to 21 letters, digits or underscores, with or without r/. Alone it returns the subreddit's newest posts."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"as_of":"2026-10-15T12:00:00.000Z","items":[{"id":"synp001","url":"https://www.reddit.com/r/SynthTech/comments/synp001/synthetic_post/","lang":null,"text":null,"type":"post","title":"Is synthwidget worth it?","author":{"handle":"synth_redditor_1","verified":null,"followers":null,"display_name":null},"metrics":{"likes":2204,"views":null,"replies":124,"reposts":null},"link_url":null,"platform":"reddit","community":"SynthTech","parent_id":null,"created_at":"2026-10-14T00:00:00.000Z","media_urls":[]},{"id":"synp002","url":"https://www.reddit.com/r/SynthTech/comments/synp002/synthetic_post/","lang":null,"text":null,"type":"post","title":"synthwidget 2.0 first impressions","author":{"handle":"synth_redditor_2","verified":null,"followers":null,"display_name":null},"metrics":{"likes":45,"views":null,"replies":12,"reposts":null},"link_url":null,"platform":"reddit","community":"SynthTech","parent_id":null,"created_at":"2026-10-14T01:00:00.000Z","media_urls":[]}],"query":{"q":"synthetic widgets","cursor":null,"subreddit":null},"source":"public data via third-party provider; not affiliated with the platform","complete":true,"platform":"reddit","disclaimer":"Public data via third-party providers; not affiliated with or endorsed by any platform. Do not use to profile, target or train AI on individuals.","request_id":"01KEXAMPLE0000000000000000","next_cursor":"t3_synp002"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","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.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_nJfwg99UC1wWl5juf3mRy","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Search public Reddit posts by keyword, within a specific subreddit, or list a subreddit's newest posts, returning paginated results with post metadata.","exampleAgentPrompt":"Search Reddit for posts mentioning 'mechanical keyboards' in the r/MechanicalKeyboards subreddit and show me the top results with their upvotes and comment counts.","exampleUseCases":[{"title":"Brand sentiment research on Reddit","prompt":"Search Reddit for any posts mentioning 'Notion AI' and tell me what people are saying — grab the titles, upvotes, and comment counts so I can get a sense of the sentiment."},{"title":"Browse newest posts in a niche subreddit","prompt":"Show me the latest posts from r/solotravel — I want to see what topics people are discussing right now."},{"title":"Competitive product research via Reddit","prompt":"Find Reddit posts talking about 'Arc browser vs Chrome' so I can see how people compare these two browsers in discussions."}],"resultDescription":"A paginated JSON list of Reddit posts, each containing the post ID, title, body text, subreddit/community name, author handle, upvote count, comment count, any linked URL, creation timestamp, and a direct permalink. Also includes a next_cursor field for fetching additional pages, the original query parameters, and a platform disclaimer.","failureModes":["Invalid or nonexistent subreddit name returns not-found (no charge)","Malformed or empty query string returns bad input response (no charge)","No posts matching the search keyword returns empty items array (no charge)","Expired or invalid cursor returns pagination error","Rate limiting or upstream Reddit data unavailability may cause temporary failures"],"whenToPreferThis":"Use this endpoint when you need to search Reddit specifically — by keyword, subreddit, or both — and want structured post metadata (upvotes, comments, author, timestamp). Prefer this over the cross-platform Social Search endpoint when you only need Reddit data and want more control (subreddit filtering, pagination). Choose the Reddit Post Comments endpoint instead when you already have a post ID and need its comment thread.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-29T00:33:41.126Z","isFirstParty":false,"canonicalSlug":"reddit-posts-subreddit-search-a06e38e6"}