reddit

Subreddit

Returns posts from a subreddit, each with title, body, score, comment count, author, permalink, and creation timestamp.

Use it to read a community's feed, noting timeframe works only with sort=top, which is auto-selected when you omit sort; subreddit/search filters that same community by keyword.

10 credits per call.

Paginates by cursor: see Pagination.

get/v1/reddit/subreddit

Request

  • Base URL: https://api.insightsocial.app
  • URL: https://api.insightsocial.app/v1/reddit/subreddit
  • Auth: API key in header x-api-key

Query parameters

subredditstring required
Example:technology

Subreddit name without the r/ prefix

timeframe'all' | 'day' | 'week' | 'month' | 'year'

Timeframe to get posts from. Applied with sort=top (auto-selected when you omit sort).

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

Sort order

trimboolean

Set to true for a lighter record with fewer fields. This also skips the enrichment pass, so author.avatar_url, content.media_urls, flags.spoiler, post.url and the ext.* fields are omitted along with the rest of the trimmed leaves.

dry_run'1'

Set to 1 to get the price of this call without making it: data.dry_run carries credits_min and credits_max. Nothing is charged.

sincestring

Only rows published on or after this date: YYYY-MM-DD (midnight UTC) or an ISO 8601 timestamp. Rows older than it are left off the page, and the page that reaches one ends the walk: next_cursor is not returned and pagination.stopped_at is since. Sending it sets the newest-first sort shown in this endpoint's sort parameter (any other sort value is a free 400). The page still costs what a page costs, so you pay for the pages you walk and no more. A row with no date is kept.

untilstring

Only rows published on or before this date: YYYY-MM-DD (that whole UTC day is included) or an ISO 8601 timestamp. Newer rows are left off each page and the walk does not stop, so older pages follow. A row with no date is kept.

cursorstring

The pagination.next_cursor from the previous page, sent back unchanged. Omit it for the first page.

Response

Success.

successtrue required
platformstring required
endpointstring required
schema_version'2' required
unavailablestring[] required
credits_usedinteger required
credits_remaininginteger required
request_idstring required
cachedboolean required
idempotent_replayboolean required
charge_reasonstring required
free_callboolean required

Changes

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