List subreddit posts (v1)
List a subreddit's posts with title, score, upvote ratio, comment count, awards, media, flair and author identity per post — plus a cursor for the next page. Requires subreddit.
Authorization
ApiKeyAuth In: header
Query Parameters
Community name, e.g. technology. Accepts r/technology or a reddit.com URL. 2-21 letters, digits or underscores. An unknown community returns an empty feed, not an error.
length <= 300Feed order: best (default), hot, new, top, rising or controversial. Other values are rejected. top and controversial also accept time.
"best"Value in
- "best"
- "hot"
- "new"
- "top"
- "rising"
- "controversial"
Time window for sort=top or sort=controversial: HOUR, DAY, WEEK, MONTH, YEAR or ALL (default). Ignored by other sorts. WEEK can reach older posts; filter on created_at if you need exactly seven days.
Value in
- "HOUR"
- "DAY"
- "WEEK"
- "MONTH"
- "YEAR"
- "ALL"
next_cursor from the previous response; omit for the top of the feed. A post id (1vay198) or fullname (t3_1vay198) also works. Cursors don't expire.
length <= 200curl -X GET "https://example.com/v1/reddit/subreddit-posts?subreddit=technology" \ -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": 24, "subreddit": "technology", "sort": "best", "next_cursor": "dDNfMXZheTE5OA==", "end_of_feed": false, "usage_note": "One Reddit page, ~24 posts. Pass `next_cursor` as `after` for the next page; `end_of_feed` means the feed ran out. `next_cursor` is not an opaque server token: it is base64('t3_' + the last post's id), so `after` will also accept that bare post id." }, "details": { "reason": "no_results", "message": "string" }}