---
title: "List Reddit subreddit posts"
method: GET
path: "/reddit/subreddit/{subreddit}/posts"
tags: ["Reddit"]
---

# List Reddit subreddit posts

`GET /reddit/subreddit/{subreddit}/posts`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/reddit/subreddit/{subreddit}/posts`
- Auth: API key in header `x-api-key`

Returns public posts from a subreddit. A `503` with a `Retry-After` header means Reddit is temporarily throttling the request; wait that many seconds and retry. If source.type is redlib, public fields and credit weights are preserved.

## Path parameters

- `subreddit` string, required

## Query parameters

- `sort` 'hot' | 'new' | 'top' | 'rising'
- `time` 'hour' | 'day' | 'week' | 'month' | 'year' | 'all'
- `limit` integer
- `after` string

## Headers

- `x-api-key` string, required

## Response `200`

OK

- RedditSubredditPostsResponseDoc
  - `code` integer
  - `data` RedditSubredditPostsResponse
    - `pagination` RedditPagination
      - `after` string: Cursor to pass as the `after` parameter to fetch the next page.
      - `limit` integer: Maximum number of items requested for this page.
    - `posts` RedditPost[]: Posts in the subreddit.
      - `author` RedditAuthor
        - `name` string: Reddit username of the author.
        - `profile_url` string: URL of the author's Reddit profile page.
      - `award_count` integer: Number of awards the post received. Set only when metrics are requested.
      - `comment_count` integer: Number of comments on the post. Set only when metrics are requested.
      - `created` string: Time the post was submitted, in UTC (RFC 3339).
      - `created_utc` integer: Time the post was submitted, in Unix seconds.
      - `domain` string: Domain of the linked content, or `self.<subreddit>` for text posts.
      - `estimated_downvotes` integer: Approximate downvote total worked out from the score and upvote ratio. Reddit does not publish exact counts.
      - `estimated_upvotes` integer: Approximate upvote total worked out from the score and upvote ratio. Reddit does not publish exact counts.
      - `flair` string: Flair text attached to the post.
      - `id` string: Reddit post id.
      - `is_self` boolean: Whether the post is a text post rather than a link.
      - `is_video` boolean: Whether the post is a video.
      - `locked` boolean: Whether the post is locked against new comments.
      - `name` string: Reddit full name of the post, the id prefixed with `t3_`.
      - `over_18` boolean: Whether the post is marked as 18+ content.
      - `permalink` string: Reddit URL of the post's comments page.
      - `score` integer: Net score of the post, upvotes minus downvotes as Reddit shows it. Set only when metrics are requested.
      - `selftext` string: Body text of a text post.
      - `source_feed_url` string: URL of the Reddit feed the post was read from.
      - `stickied` boolean: Whether the post is pinned to the top of its subreddit.
      - `subreddit` string: Name of the subreddit the post belongs to, without `r/`.
      - `thumbnail` string: URL of the post thumbnail image.
      - `title` string: Title of the post as submitted.
      - `upvote_ratio` number: Share of votes that are upvotes, from 0 to 1. Set only when metrics are requested.
      - `url` string: Reddit URL of the post.
      - `vote_counts_estimated` boolean: Whether `estimated_upvotes` and `estimated_downvotes` are estimates.
    - `sort` string: Sort order that was applied, for example `hot`.
    - `source` RedditSourceDetail
      - `type` string: Kind of Reddit source the data was read from.
      - `url` string: Reddit URL the data was read from.
    - `subreddit` string: Subreddit name, without `r/`.
    - `time` string: Time window that was applied, for example `week`.
  - `msg` string

## Other responses

- `400`: Bad Request
- `404`: Not Found
- `429`: Too Many Requests
- `503`: Service Unavailable

---

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