reddit

Reddit Post Search

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.

get/v1/reddit/search

Request

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

Query parameters

qstring required

Search text. Reddit operators allowed.

subredditstring

Limit to one subreddit, e.g. SaaS.

sort'relevance' | 'new' | 'hot' | 'top' | 'comments'

Result order. top and comments rank the relevant results by score or comment count; new is the freshest.

time'hour' | 'day' | 'week' | 'month' | 'year' | 'all'

Time window.

boolean
OR
string

Include adult posts. true needs the 18+ setting and is billed as reddit.nsfw_search.

limitinteger

Max rows to return (1-100). Reddit pages hold about 25 rows; larger values still return one page.

cursorstring

Opaque cursor from the previous response's page.nextCursor.

Response

Success

requestIdstring required
cachedboolean required

Example response

{
  "requestId": "req_01JA7Q3V8K2N4P5R6S7T8V"
}

Changes

No recorded changes to this operation across all 1 revision of this API.