---
title: "Reddit Trending Posts"
method: GET
path: "/v1/reddit/trending"
tags: ["Reddit"]
---

# Reddit Trending Posts

`GET /v1/reddit/trending`

## Request

- Base URL: `https://apidirect.io`
- URL: `https://apidirect.io/v1/reddit/trending`
- Auth: API key in header `X-API-Key`

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.

## Query parameters

- `sort_by` 'hot' | 'most_recent' | 'top' | 'rising' | 'controversial'
- `posted_ago` '1h' | '24h' | '7d' | '30d' | '12m' | 'all'
- `feed` 'popular' | 'all'
- `country` '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'
- `pages` integer
- `get_sentiment` boolean

## Response `200`

Successful response

- RedditTrendingResponse: Inferred from a live response. Any field can be null or absent, and new fields may be added at any time.
  - `posts` object[], nullable
    - `post_id` string, nullable
    - `title` string, nullable
    - `url` string, nullable
    - `date` string, nullable
    - `author` string, nullable
    - `author_url` string, nullable
    - `source` string, nullable
    - `domain` string, nullable
    - `snippet` string, nullable
    - `subreddit` string, nullable
    - `upvotes` number, nullable
    - `upvote_ratio` number, nullable
    - `comments` number, nullable
    - `crossposts` number, nullable
    - `flair` string, nullable
    - `link_url` string, nullable
    - `thumbnail` string, nullable
    - `is_video` boolean, nullable
    - `nsfw` boolean, nullable
    - `spoiler` boolean, nullable
    - `locked` boolean, nullable
    - `stickied` boolean, nullable
    - `video_url` string, nullable
    - `video_hls_url` string, nullable
    - `images` unknown[], nullable
      - unknown
  - `sort_by` string, nullable
  - `pages` number, nullable
  - `count` number, nullable

## Other responses

- `400`: Bad request: missing or invalid parameters
- `401`: Unauthorized: invalid or missing API key
- `402`: Free tier used up for this endpoint and no payment method on file (`payment_required`).
- `403`: Account blocked after a failed payment (`account_blocked`).
- `429`: Rate limit exceeded or too many concurrent requests
- `500`: Internal server error
- `502`: Temporary failure retrieving Reddit data. Please retry shortly.
- `503`: Service temporarily unavailable. Please retry shortly.
- `504`: The request timed out

---

[API](https://skmtc.dev/apidirect/apis/api-direct.md) · [All operations](https://skmtc.dev/apidirect/apis/api-direct/llms.txt) · [OpenAPI document](https://skmtc.dev/apidirect/apis/api-direct/revisions/fa8c68d70bd0?raw)