Reddit Popular Posts API

Reddit Popular Posts API — get the posts trending on r/popular, worldwide or for one country, sorted by hot, new, top, or rising. JSON, $0.01 per call.

POST/v1/reddit/popular

$0.01/call

The Reddit Popular Posts API returns what's trending on Reddit right now — the r/popular feed. Pass country to get a country's version of r/popular (for example GB or DE), and sort to switch between hot, new, top, and rising. Use it for trend monitoring, content ideas, or daily digests.

Usage

const res = await fetch('https://api.yepapi.com/v1/reddit/popular', {
  method: 'POST',
  headers: {
    'x-api-key': 'YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({"country": "GB"}),
});
const { data } = await res.json();
console.log(data);

curl -X POST https://api.yepapi.com/v1/reddit/popular \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"country": "GB"}'

import requests

res = requests.post(
    "https://api.yepapi.com/v1/reddit/popular",
    headers={"x-api-key": "YOUR_API_KEY"},
    json={"country": "GB"},
)
print(res.json()["data"])

Request Body

Parameter	Type	Required	Description	Default
`sort`	`string`	No	One of: `hot`, `new`, `top`, `rising`	`hot`
`time`	`string`	No	Time window, only used with `sort: "top"`. One of: `hour`, `day`, `week`, `month`, `year`, `all`	`day`
`country`	`string`	No	Two-letter country code, e.g. `GB`, for that country's r/popular. Not available with `sort: "rising"`	—
`cursor`	`string`	No	`cursor` from the previous response, to fetch the next page	—

Response

{
  "ok": true,
  "data": {
    "cursor": "t3_1xjmbmn",
    "posts": [
      {
        "author": "vaultofechoes",
        "created_at": null,
        "created_utc": null,
        "domain": null,
        "flair": null,
        "id": "t3_1xjrnee",
        "images": [],
        "is_self": false,
        "is_video": false,
        "locked": false,
        "name": null,
        "num_comments": null,
        "num_crossposts": null,
        "over_18": false,
        "permalink": "https://www.reddit.com/r/TheTraitors/comments/1xjrnee/the_celebrity_traitors_s02e10_finale_postepisode/",
        "score": null,
        "selftext": null,
        "spoiler": false,
        "stickied": false,
        "subreddit": "TheTraitors",
        "thumbnail": null,
        "title": "The Celebrity Traitors S02E10 [FINALE] Post-Episode Discussion Thread",
        "upvote_ratio": null,
        "url": null,
        "video_url": null
      },
      {
        "author": "AfcWimbledon_",
        "created_at": null,
        "created_utc": null,
        "domain": null,
        "flair": null,
        "id": "t3_1xjqn08",
        "images": [],
        "is_self": false,
        "is_video": false,
        "locked": false,
        "name": null,
        "num_comments": null,
        "num_crossposts": null,
        "over_18": false,
        "permalink": "https://www.reddit.com/r/bigbrotheruk/comments/1xjqn08/big_brother_2026_episode_42_friday_30th_october/",
        "score": null,
        "selftext": null,
        "spoiler": false,
        "stickied": false,
        "subreddit": "bigbrotheruk",
        "thumbnail": null,
        "title": "Big Brother 2026 - Episode 42 (Friday 30th October)",
        "upvote_ratio": null,
        "url": null,
        "video_url": null
      }
    ]
  }
}

Response Fields

Field	Type	Description
`ok`	`boolean`	Whether the request succeeded
`data.posts`	`object[]`	Popular posts
`data.posts[].id`	`string`	Post ID (base36)
`data.posts[].name`	`string`	Fullname, `t3_` + ID — the same value Reddit uses in cursors
`data.posts[].title`	`string`	Post title
`data.posts[].author`	`string`	Author username
`data.posts[].subreddit`	`string`	Subreddit name without `r/`
`data.posts[].permalink`	`string`	Full reddit.com URL of the post — pass it to `/v1/reddit/post` or `/v1/reddit/post-comments`
`data.posts[].url`	`string`	Link target: the external URL, image, or the post itself for text posts
`data.posts[].domain`	`string`	Domain of `url` (`self.<subreddit>` for text posts)
`data.posts[].selftext`	`string`	Body of a text post in Markdown (empty for link posts)
`data.posts[].score`	`number`	Net upvotes
`data.posts[].upvote_ratio`	`number`	Share of upvotes, 0–1
`data.posts[].num_comments`	`number`	Comment count
`data.posts[].num_crossposts`	`number`	Crosspost count
`data.posts[].created_utc`	`number`	Unix timestamp (seconds)
`data.posts[].created_at`	`string`	ISO 8601 timestamp
`data.posts[].flair`	`string \| null`	Post flair text
`data.posts[].is_self`	`boolean`	Text post (no external link)
`data.posts[].is_video`	`boolean`	Reddit-hosted video
`data.posts[].over_18`	`boolean`	Marked NSFW
`data.posts[].spoiler`	`boolean`	Marked as spoiler
`data.posts[].stickied`	`boolean`	Pinned by moderators
`data.posts[].locked`	`boolean`	Comments locked
`data.posts[].thumbnail`	`string \| null`	Thumbnail image URL
`data.posts[].images`	`string[]`	Full-size image URLs (preview images and gallery items)
`data.posts[].video_url`	`string \| null`	MP4 URL for Reddit-hosted videos
`data.cursor`	`string \| null`	Cursor for the next page

Pagination

Each response includes a cursor. Send the same request again with that value in cursor to get the next page. When cursor is null, there are no more results. A query with no matches returns 200 with an empty list and cursor: null. Every page is a separate $0.01 call.

Caching

Responses are cached for 15 minutes.

Errors

Status	Code	When
`400`	`VALIDATION_ERROR`	`sort`, `time`, or `country` is invalid, or `country` is combined with `rising`
`429`	`RATE_LIMITED_UPSTREAM`	Too many requests in a short burst — retry after a few seconds
`502`	`UPSTREAM_ERROR`	Temporary problem fetching data from Reddit — retry

Failed calls are not charged.

Popular Subreddits — the most popular and newest communities
Reddit Comments API — comments on any trending post
Reddit Search API — search posts by keyword

Reddit Popular Posts API

On this page