{"uid":"cap_JHZZdlQ4FGbQld1PLJHl0","slug":"fetcher-sh-reddit-top-posts-api-c1457352","name":"fetcher.sh Reddit Top Posts API","description":"fetcher.sh is an x402 web-data and scraping API: 111 endpoints for Twitter/X, YouTube, TikTok, Instagram, Reddit, Google, App Store, and Yelp — paid per call in USDC on Base, Polygon, Arbitrum, Monad or Solana, or with prepaid credits. Built for AI agents: no accounts, no OAuth, no subscriptions.","url":"https://fetcher.sh/api/reddit/posts/top","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"properties":{"type":"string"}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","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.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_qYS07WuoXVQG68n1Vmshh","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches the top posts from Reddit, returning trending/popular content ranked by score","exampleAgentPrompt":"Can you pull the top posts from r/technology on Reddit right now — I want to see what's trending today?","exampleUseCases":[{"title":"Trend monitoring for content team","prompt":"Grab the top 25 posts from r/programming on Reddit from the past week so I can see what topics are resonating with developers right now."},{"title":"Competitor brand mentions on Reddit","prompt":"Pull the top posts from r/startups on Reddit for this month — I need to see what companies people are talking about most."},{"title":"Research viral topics in a niche","prompt":"What are the top posts on r/MachineLearning on Reddit today? Show me the highest-scoring ones so I can understand what the AI research community is hyped about."}],"resultDescription":"Returns a list of top Reddit posts including post title, score/upvotes, URL, author username, comment count, subreddit, post body text, upvote ratio, and timestamp. Posts are sorted by score descending.","failureModes":["Subreddit does not exist or is private — returns 404 or empty result","Reddit rate limiting or availability issues — returns 5xx error","Invalid time period parameter — may return empty or default results","Payment not processed — returns 402 requiring USDC payment on Base","Subreddit is quarantined or banned — no posts returned"],"whenToPreferThis":"Choose this endpoint when you need structured top-post data from Reddit without managing OAuth credentials, Reddit API keys, or rate limit quotas. Ideal for AI agents that need one-off or periodic Reddit data with pay-per-call USDC billing — no account setup required. Prefer over direct Reddit API access when building autonomous agents that need frictionless data access.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:44:03.930Z","isFirstParty":false}