{"uid":"cap_R0u52DyrYvNYChlMXvlKn","slug":"socialfetch-reddit-subreddit-posts-6e65c12e","name":"SocialFetch Reddit Subreddit Posts","description":"List posts from a specific subreddit.","url":"https://api.socialfetch.dev/v1/reddit/subreddits/:subreddit/posts","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"},"pathParams":{"type":"object","required":["subreddit"],"properties":{"subreddit":{"type":"string","maxLength":256,"minLength":1,"description":"Subreddit name, optional `r/` prefix, or Reddit subreddit URL. Must match Reddit's exact casing. Lists posts for this subreddit."}}},"queryParams":{"type":"object","properties":{"sort":{"enum":["best","hot","new","top","rising"],"type":"string","description":"Optional sort order for the returned posts."},"cursor":{"type":"string","minLength":1,"description":"Opaque pagination cursor from a previous response."},"timeframe":{"enum":["all","day","week","month","year"],"type":"string","description":"Optional timeframe used only when `sort` is `top`. Ignored/rejected for other sorts."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.014","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.014/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.014","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.014","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_A7EBTWtJsNtTKKKcpWC9D","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.014","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Lists posts from a specific Reddit subreddit with optional sorting, timeframe, and pagination.","exampleAgentPrompt":"Can you pull the top posts from r/MachineLearning from the past week, sorted by top?","exampleUseCases":[{"title":"Monitor industry news in tech communities","prompt":"Show me the newest posts from r/technology and r/programming from today so I can catch up on what's trending"},{"title":"Research trending discussions in niche forums","prompt":"What are the best posts from r/worldnews this month? I want to see what people are actually talking about"},{"title":"Track community sentiment on specific topics","prompt":"Can you fetch the rising posts from r/MachineLearning right now? I'm curious what's getting attention in the AI community"}],"resultDescription":"A list of Reddit posts from the specified subreddit including post metadata (titles, scores, authors, URLs, etc.) along with a pagination cursor for fetching subsequent pages.","failureModes":["Invalid or misspelled subreddit name returns empty results or error","Subreddit is private or banned — access denied","Invalid sort/timeframe combination may yield unexpected results","Expired or malformed pagination cursor causes pagination failure","Rate limits or payment issues return 402 or 429 errors"],"whenToPreferThis":"Use this endpoint when you need to retrieve a list of posts from a specific Reddit subreddit, optionally filtered by sort order (hot, new, top, rising, best) and timeframe. Prefer this over generic web scraping when you need structured Reddit post data with pagination support.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:44:37.244Z","isFirstParty":false}