Read a reddit post and its comment tree from any reddit URL or id.

The primary tool: give it whatever the user pasted. Comments come back as an indented markdown tree; collapsed branches show as [+N more replies].

Caveat: Arctic Shift archives posts the moment they appear and backfills vote data after ~36h, so score and num_comments on anything newer than that are placeholders (usually 1 and 0) - never report them as real counts.

Look up posts in bulk by id.

Use when you already have post ids (for example from search_comments results) and want their titles, authors and scores.

Caveat: Arctic Shift archives posts the moment they appear and backfills vote data after ~36h, so score and num_comments on anything newer than that are placeholders (usually 1 and 0) - never report them as real counts.

Look up comments in bulk by id.

Use for the comment ids returned inside a [+N more replies] marker, or any comment permalink you already resolved.

Caveat: Arctic Shift archives posts the moment they appear and backfills vote data after ~36h, so score and num_comments on anything newer than that are placeholders (usually 1 and 0) - never report them as real counts.

Find posts by subreddit, author, keyword or date range.

Keyword parameters (query, title, selftext) are only accepted together with subreddit or author, and can still time out on very busy ones - a date range makes them reliable.

Caveat: Arctic Shift archives posts the moment they appear and backfills vote data after ~36h, so score and num_comments on anything newer than that are placeholders (usually 1 and 0) - never report them as real counts.

Find comments by subreddit, author, keyword, post or date range.

With author alone this doubles as user comment history. Comment keyword search is the slowest endpoint - pair body with a subreddit, an author or a date range.

Caveat: Arctic Shift archives posts the moment they appear and backfills vote data after ~36h, so score and num_comments on anything newer than that are placeholders (usually 1 and 0) - never report them as real counts.

Find subreddits by name, prefix, subscriber count or age.

Subreddit records are refreshed infrequently, so subscriber counts lag reality by more than the ~36h that applies to posts and comments.

Caveat: Arctic Shift archives posts the moment they appear and backfills vote data after ~36h, so score and num_comments on anything newer than that are placeholders (usually 1 and 0) - never report them as real counts.