---
title: "Search posts"
method: GET
path: "/v1/reddit/search"
tags: ["Reddit Search"]
---

# Search posts

`GET /v1/reddit/search`

Search Reddit posts using a connected account. Optionally scope to a specific subreddit.

## Query parameters

- `accountId` string, required
- `subreddit` string
- `q` string, required
- `restrict_sr` '0' | '1'
- `sort` 'relevance' | 'hot' | 'top' | 'new' | 'comments'
- `limit` integer
- `after` string

## Response `200`

Search results

- 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. Google Ads: writes and reports run on one developer token shared by every Google Ads account on Zernio. The token holds Standard access (no daily operations cap), so this only happens when Google throttles the token or your ad account. The envelope has `code: rate_limited`, `platform: google`, `details.quotaScope: DEVELOPER` (`ACCOUNT` when it is your own ad account's quota), `details.resetsAt` (ISO instant when Google accepts requests again) and `Retry-After` counting down to it. Retrying earlier cannot succeed.

## Changes

- **2026-09-25** `2c04683ce694` — 12 info
  - added the optional property `details/adAccountId` to the response with the `400` status
  - added the optional property `details/adAccountId` to the response with the `404` status
  - added the optional property `details/adAccountId` to the response with the `429` status
  - added the optional property `details/createdObjects` to the response with the `400` status
  - …8 more
- **2026-09-16** `3e6ddf2a99ea` — 3 info
  - added the optional property `details/budgetScope` to the response with the `400` status
  - added the optional property `details/budgetScope` to the response with the `404` status
  - added the optional property `details/budgetScope` to the response with the `429` status
- **2026-09-15** `0dba7d004d75` — 6 info
  - added the optional property `details/quotaExhausted` to the response with the `400` status
  - added the optional property `details/quotaExhausted` to the response with the `404` status
  - added the optional property `details/quotaExhausted` to the response with the `429` status
  - added the optional property `details/quotaScope` to the response with the `400` status
  - …2 more

[Change history](https://skmtc.dev/zernio/apis/zernio-api/changes/v1/reddit/search/get.md)

---

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