Search public Reddit posts

Posts matching a query across Reddit, or within the communities named in subreddit or subreddits. Reddit's search covers post titles and bodies only — it does not search comment text; to find mentions in comments, read a community's comment stream with GET /v1/reddit/subreddits/{name}/comments or watch it with a subreddit_comments monitor.

To list a community without a keyword, use GET /v1/reddit/subreddits/{name}/posts. NSFW posts are excluded unless includeNsfw is true.

post/v1/reddit/search

Request

Base URL: https://api.weirapp.io
URL: https://api.weirapp.io/v1/reddit/search
Auth: HTTP bearer

Request body

querystring required

Reddit search syntax: words, "exact phrases", OR, -exclusions, and field operators such as title:, author:, flair:, site:example.com, url:, self:yes.

subredditstring

Restrict the search to one community, by name without r/.

subredditsstring[]

Restrict the search to several communities at once (up to 25).

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

new is arrival order; comments ranks by comment count.

Only posts created within this window.

includeNsfwboolean

Include results marked NSFW. Off by default; what it removes is reported in meta.omittedNsfw.

limitinteger

cursorstring

meta.nextCursor from the previous page, unchanged. Opaque, signed, and bound to the other parameters: change any of them and start again without a cursor.

Example request

{
  "query": "\"churn\" pricing",
  "subreddit": "saas",
  "subreddits": [
    "saas",
    "startups"
  ],
  "limit": 25
}

Response

Reddit posts, in Reddit's own field names.

Changes

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