{"uid":"cap_9iYAr5NvaWzN-EHuhnHsc","slug":"reddit-trending-posts-4bfb1fce","name":"Reddit Trending Posts","description":"Get the posts trending across Reddit right now, from r/popular (worldwide or one country's) or r/all.","url":"https://x402.apidirect.io/v1/reddit/trending?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":[],"properties":{"feed":{"enum":["popular","all"],"type":"string","description":"popular (r/popular: the most active posts in public, non-NSFW communities) or all (r/all: every community) (default: popular)"},"pages":{"type":"integer","default":1,"maximum":20,"minimum":1,"description":"Number of pages to fetch, 1-20 (default: 1). Each page returns up to 25 posts."},"country":{"enum":["AR","AU","BG","CA","CL","CO","CZ","DE","ES","FI","FR","GB","GR","HR","HU","IE","IN","IS","IT","JP","MX","MY","NZ","PH","PL","PR","PT","RO","RS","SE","SG","TH","TR","TW","US"],"type":"string","description":"One country's r/popular, as on reddit.com: AR, AU, BG, CA, CL, CO, CZ, DE, ES, FI, FR, GB, GR, HR, HU, IE, IN, IS, IT, JP, MX, MY, NZ, PH, PL, PR, PT, RO, RS, SE, SG, TH, TR, TW or US (default: worldwide). Only with feed=popular."},"sort_by":{"enum":["hot","most_recent","top","rising","controversial"],"type":"string","default":"hot","description":"Sort order: hot, most_recent, top, rising, or controversial (default: hot)"},"posted_ago":{"enum":["1h","24h","7d","30d","12m","all"],"type":"string","description":"Time window for sort_by=top or sort_by=controversial: 1h, 24h, 7d, 30d, 12m, or all (default: 24h). Rejected with any other sort_by."},"get_sentiment":{"type":"boolean","default":false,"description":"Set to true to add AI emotion analysis to each post (returned in the `posts` array). Adds a `sentiment` object containing `emotions` (joy, trust, fear, surprise, sadness, disgust, anger and anticipation, each scored 0-100), `dominant_emotion`, `emotional_intensity` (0-10), and `polarity` (positive, "}}}},"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_i1ljra9WY9KwKXy4xUgiQ","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":"Fetches the top trending posts from Reddit's r/popular or r/all feeds, with optional country filtering, sort order, and AI sentiment analysis.","exampleAgentPrompt":"What's trending on Reddit right now? Grab 2 pages of the hottest posts from r/popular in the US, sorted by hot, and include sentiment analysis for each post.","exampleUseCases":[{"title":"Daily viral content briefing","prompt":"Give me a quick briefing on what's blowing up on Reddit today — pull 2 pages from r/popular worldwide sorted by hot and tell me the top stories."},{"title":"Country-specific trend monitoring","prompt":"What are people in Canada talking about on Reddit right now? Fetch the top trending posts from r/popular for Canada, sorted by most recent."},{"title":"Controversial content sentiment report","prompt":"Pull the most controversial Reddit posts from the past 7 days from r/all and include AI sentiment analysis for each one so I can see the emotional tone."}],"resultDescription":"Returns an array of trending Reddit posts from r/popular or r/all, each including post title, subreddit, upvote count, URL, author, and metadata. When get_sentiment=true, each post also includes a sentiment object with joy, trust, fear, surprise, sadness, disgust, anger, and anticipation scores (0-100), a dominant_emotion, emotional_intensity (0-10), and polarity (positive/negative/neutral). Each page returns up to 25 posts.","failureModes":["Invalid country code returns an error — only supported ISO codes are accepted","posted_ago parameter rejected if sort_by is not 'top' or 'controversial'","country parameter only valid when feed=popular, ignored or errored with feed=all","pages exceeding maximum of 20 returns a validation error","Payment failure (402) if USDC balance is insufficient or x402 payment not properly configured","Rate limiting or Reddit API downtime may cause transient failures"],"whenToPreferThis":"Use this endpoint when you need real-time trending content from Reddit across one or multiple countries, with flexible sort options (hot, rising, controversial, top) and optional emotional sentiment scoring per post. Prefer this over manual Reddit scraping or the Reddit API when you need a clean, pay-per-call interface with built-in AI sentiment enrichment. Choose r/popular for mainstream trending content or r/all for the broadest cross-community coverage.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-30T19:08:04.551Z","isFirstParty":false,"canonicalSlug":"reddit-trending-posts-4bfb1fce"}