---
title: "Get subreddit feed"
method: GET
path: "/v1/reddit/feed"
tags: ["Reddit Search"]
---

# Get subreddit feed

`GET /v1/reddit/feed`

Fetch posts from a subreddit feed. Supports sorting, time filtering, and cursor-based pagination.

## Query parameters

- `accountId` string, required
- `subreddit` string
- `sort` 'hot' | 'new' | 'top' | 'rising'
- `limit` integer
- `after` string
- `t` 'hour' | 'day' | 'week' | 'month' | 'year' | 'all'

## Response `200`

Feed items

- object
  - `items` RedditPost[]
    - `id` string — Reddit post ID (without type prefix)
    - `fullname` string — Reddit fullname (e.g. t3_abc123)
    - `title` string
    - `author` string
    - `subreddit` string
    - `url` string — Post URL (may be a gallery URL, external link, or self-post URL)
    - `permalink` string — Full permalink to the Reddit post
    - `selftext` string — Self-post body text (empty string for link posts)
    - `createdUtc` number — Unix timestamp of post creation
    - `score` integer
    - `numComments` integer
    - `over18` boolean — Whether the post is marked NSFW
    - `stickied` boolean
    - `flairText` string, nullable — Link flair text if set
    - `isGallery` boolean — Whether the post is a gallery with multiple images
    - `galleryImages` string[] — Individual image URLs for gallery posts (only present when isGallery is true)
  - `after` string, nullable
  - `before` string, nullable

## Other responses

- `400` — Invalid request
- `401` — Unauthorized
- `404` — No active Reddit account with this ID is available to the API key. It may have been disconnected or deleted, or it belongs to a profile the key cannot access. Re-connecting an account issues a NEW account ID, so an ID stored from before a reconnect will not resolve.
- `429` — The connected account's upstream platform quota is exhausted. Reddit rate-limits per connected Reddit user (1000 requests per 10-minute window), and that budget is shared by every operation using that account. Retry after the window resets rather than retrying immediately; repeated calls while exhausted do not succeed and keep the budget spent.

---

[API](https://skmtc.net/zernio/apis/zernio-api.md) · [All operations](https://skmtc.net/zernio/apis/zernio-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/zernio/zernio-api/versions/51932b099b2f/schema)