Reddit

Search posts within one subreddit

Posts matching a query inside the community in the path. The body cannot widen the search beyond it. To find communities rather than posts, use POST /v1/reddit/search/subreddits.

post/v1/reddit/subreddits/{name}/search

Request

  • Base URL: https://api.weirapp.io
  • URL: https://api.weirapp.io/v1/reddit/subreddits/{name}/search
  • Auth: HTTP bearer

Path parameters

namestring required

Community name without the r/ prefix: 3-21 letters, digits, or underscores starting with a letter or digit, or a two-letter language community such as de.

Example:saas

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.

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

new is arrival order; comments ranks by comment count.

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

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",
  "limit": 25
}

Response

Reddit posts restricted to the named subreddit.

Changes

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