Reddit API: List popular posts

1 credit / requestBilled only on success

Authorization

ApiKeyAuth

x-api-key<token>

In: header

Query Parameters

count?integer

How many distinct posts to return (max 200). r/popular repeats posts across pages, so duplicates are removed and more pages may be fetched; pages_fetched reports how many.

Range1 <= value <= 200

Default25

after?string

next_cursor from the previous response; omit for the top of the feed. A post id or t3_ fullname also works. The feed re-ranks between calls, so de-duplicate on id when collecting.

Lengthlength <= 200

curl -X GET "https://example.com/v1/reddit/popular-posts" \  -H "x-api-key: YOUR_API_KEY"

{  "data": {    "posts": [      {        "id": "1vay198",        "fullname": "t3_1vay198",        "permalink": "/r/technology/comments/1vay198/example_post_title/",        "url": "https://www.reddit.com/r/technology/comments/1vay198/example/",        "title": "Example post title",        "subreddit": "technology",        "subreddit_prefixed": "r/technology",        "subreddit_id": "t5_2qh16",        "author": "example_user",        "author_id": "t2_abc123",        "author_icon": null,        "created_at": "2026-08-17T09:14:22.000+0000",        "score": 1284,        "upvote_ratio": 0.94,        "comment_count": 213,        "award_count": 0,        "domain": "arstechnica.com",        "content_url": "https://arstechnica.com/example-article/",        "post_type": "link",        "flair": "Society",        "flair_url": "/r/technology/?f=flair_name%3A%22Society%22",        "thumbnail": "https://external-preview.redd.it/example.jpg",        "media": {          "kind": "image",          "url": "https://i.redd.it/example.jpeg",          "poster": null,          "preview": null,          "caption_url": null,          "items": null        },        "text": null,        "nsfw": null,        "spoiler": false,        "locked": false,        "archived": false,        "language": "en"      }    ],    "count": 25,    "requested_count": 25,    "next_cursor": "dDNfMXZheTE5OA==",    "end_of_feed": false,    "pages_fetched": 3,    "usage_note": "r/popular re-ranks between calls: two identical requests share about 23 of 25 posts and an 8-page walk returns roughly 155 distinct posts out of 200 rows. `count` here is DISTINCT posts, so a walk of this feed is about 25% less efficient than its page size suggests. Reddit ships no cursor for this feed, so `next_cursor` is base64('t3_' + the last post's id), built here; `after` will equally accept that bare post id."  }}