Reddit Trending Posts
Get the posts trending across Reddit right now, from r/popular (worldwide or one country's) or r/all. Sort by hot, new, top, rising or controversial, with a time window (past hour to all time) for top and controversial. Returns title, text, subreddit, author, date, score, upvote ratio, comment count, flair, shared link and video/gallery links for each post, 25 per page, up to about 500 posts. Supports fetching multiple pages in a single API call (billed per page).
Price: $0.003 per page. Free tier: 50 requests/month.
Request
- Base URL: https://apidirect.io
- URL: https://apidirect.io/v1/reddit/trending
- Auth: API key in header X-API-Key
Query parameters
Sort order: hot, most_recent, top, rising, or controversial (default: hot)
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.
popular (r/popular: the most active posts in public, non-NSFW communities) or all (r/all: every community) (default: popular)
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.
Number of pages to fetch, 1-20 (default: 1). Each page returns up to 25 posts.
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, negative or neutral). Any post that cannot be scored returns sentiment: null.
Response
Successful response
Changes
No recorded changes to this operation across all 1 revision of this API.