{"uid":"cap_RTvgKinNfqztAGfEQVpch","slug":"reddit-subreddit-search-c705f795","name":"Reddit Subreddit Search","description":"Search subreddits by keyword.","url":"https://x402.apidirect.io/v1/reddit/subreddits?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","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","required":["query"],"properties":{"pages":{"type":"integer","default":1,"maximum":10,"minimum":1,"description":"Number of pages to fetch, 1-10 (default: 1). Each page returns up to 25 subreddits."},"query":{"type":"string","maxLength":500,"description":"Search keyword (max 500 characters)"}}}},"additionalProperties":false}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.004","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.004/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.004","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.004","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_GFvjVBxQUVc5Agd71vmZH","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.004","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Search Reddit subreddits by keyword, returning up to 25 results per page across up to 10 pages.","exampleAgentPrompt":"Can you find me subreddits related to 'personal finance'? Fetch 3 pages of results so I get a good variety of communities to explore.","exampleUseCases":[{"title":"Niche community discovery for marketing","prompt":"Find me subreddits about 'sustainable fashion' — pull 2 pages of results so I can identify the best Reddit communities to target for our brand outreach."},{"title":"Competitor brand monitoring","prompt":"Search for all subreddits related to 'electric vehicles' and give me 5 pages of results — I want to find every community where our competitors might be discussed."},{"title":"Content strategy research","prompt":"What subreddits exist around 'indie game development'? Get me 3 pages worth so I can figure out where to share our new game announcement."}],"resultDescription":"A paginated list of subreddits matching the search keyword, with each page returning up to 25 subreddits including subreddit names and associated metadata. Up to 10 pages (250 subreddits total) can be retrieved per query.","failureModes":["Empty results if no subreddits match the keyword","Query exceeds 500 character limit returning a validation error","Pages parameter outside 1-10 range returning a validation error","Reddit rate limiting or availability issues causing request failure","Payment failure if USDC balance is insufficient"],"whenToPreferThis":"Choose this endpoint when you need to discover or enumerate Reddit communities by topic keyword, particularly for market research, community monitoring, content strategy, or identifying niche audiences. Prefer it over Reddit user search when the goal is finding communities rather than individuals, and over post-search endpoints when you want to identify the communities themselves rather than specific content within them.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-30T19:07:59.549Z","isFirstParty":false,"canonicalSlug":"reddit-subreddit-search-c705f795"}