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

# Reddit Post Search

`GET /v1/reddit/search`

## Request

- Base URL: `https://chatterapi.com`
- URL: `https://chatterapi.com/v1/reddit/search`
- Auth: HTTP bearer

Search Reddit posts by keyword across all of Reddit or inside one subreddit. Returns posts with title, body, author, subreddit, score, comment count and URL, newest data within minutes. Costs 2 credits per page of up to 25 posts. Tip: Reddit operators work inside q, e.g. "exact phrase", OR, NOT, author:name. Costs 2 credits.

## Query parameters

- `q` string, required
- `subreddit` string
- `sort` 'relevance' | 'new' | 'hot' | 'top' | 'comments'
- `time` 'hour' | 'day' | 'week' | 'month' | 'year' | 'all'
- `nsfw` union
  - boolean
  - string
- `limit` integer
- `cursor` string

## Response `200`

Success

- object
  - `data` RedditPost[], required
    - `id` string, required
    - `fullname` string, required
    - `title` string, required
    - `body` string, required
    - `author` string, nullable, required
    - `subreddit` string, required
    - `permalink` string, required
    - `url` string, required
    - `externalUrl` string, nullable, required
    - `score` number, nullable, required
    - `numComments` number, nullable, required
    - `upvoteRatio` number, nullable, required
    - `createdAt` string, required: ISO 8601 UTC timestamp
    - `nsfw` boolean, required
    - `locked` boolean, nullable, required
    - `media` object, nullable, required
      - `type` 'image' | 'video' | 'gallery', required
      - `urls` string[], required
  - `page` PageInfo
    - `nextCursor` string, nullable, required
    - `hasMore` boolean, required
  - `credits` Credits, required
    - `charged` integer, required
    - `remaining` integer, required
  - `requestId` string, required
  - `cached` boolean, required
  - `warnings` Warning[]
    - `code` 'partial_data' | 'stale_data' | 'platform_unavailable' | 'source_unavailable', required
    - `platform` 'reddit' | 'x'
    - `source` string
    - `fields` string[]

## Other responses

- `400`: Bad request: invalid_input
- `401`: Unauthorized: missing_key, invalid_key, key_revoked
- `402`: Payment required: insufficient_credits
- `403`: Forbidden: account_suspended, scope_denied
- `404`: Not found: not_found
- `429`: Too many requests: rate_limited
- `500`: Internal error: internal
- `502`: Bad gateway: upstream_error
- `504`: Gateway timeout: upstream_timeout

---

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