reddit

Subreddit Posts

List a subreddit's posts by hot, new, top, rising, controversial or best. Returns post objects with score, comment count and link. Costs 2 credits per page. Tip: sort=top with time=week shows what that community rewards; sort=new is the freshest feed. Costs 2 credits.

get/v1/reddit/subreddits/{name}/posts

Request

  • Base URL: https://chatterapi.com
  • URL: https://chatterapi.com/v1/reddit/subreddits/{name}/posts
  • Auth: HTTP bearer

Path parameters

namestring required

Subreddit name, r/name or URL, e.g. SaaS.

Query parameters

sort'hot' | 'new' | 'top' | 'rising' | 'controversial' | 'best'

Feed order.

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

Used when sort is top or controversial.

boolean
OR
string

When false, NSFW posts are removed.

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.