Reddit Posts, Comments & Community Data APIs

Pass the full URL of one public Reddit discussion in url. The response contains meta.status, meta.totalComments, body.post, and body.post_comments. Observed post fields include id, title, author, subreddit, selftext, created_utc, score, ups, upvote_ratio, num_comments, permalink, and url. Each returned comment node uses id, author, content, up_votes, score, created_utc, and a replies array that can contain further comment nodes. Some numeric-looking fields in nested replies were strings, so normalize types before calculations. The checked historical discussion returned post p0esdp in wallstreetbets, meta.totalComments=194, and 76 top-level comment objects plus nested replies. Reported totals and top-level array length are different measurements; neither establishes that every comment is available. This endpoint has no cursor parameter and does not provide a documented way to expand missing comments. Text can be empty or unavailable for some posts; treat voting fields as a snapshot rather than a fixed score.

Pass a full subreddit URL in url. Choose filter=hot, new, or top; hot is the documented default. Omit cursor for the first request, then use the returned meta.cursor with the same URL and filter when another page is available. The response contains meta.status, meta.total, meta.cursor, and a body array. Observed post rows include id, name, title, author, subreddit, selftext, created_utc, score, ups, num_comments, permalink, and url. created_utc is a Unix timestamp in seconds, and selftext can be empty. A live filter=new request for AskReddit returned 25 posts, including one created seconds before the request. That observation does not establish a fixed page size or delivery-time guarantee, and hot/top sorting was not live-tested. The checked nonexistent subreddit returned meta.status=200, meta.total=0, meta.cursor=null, and body=[]. Handle that clean empty result without displaying unrelated posts or assuming it describes every inaccessible-community case. Cursor listings do not promise a complete historical archive.

Pass a bare community name such as AskReddit in subreddit, without r/ or a URL. Omit cursor initially and reuse the returned meta.cursor for continuation within the same community. The observed response contains meta.status, meta.subreddit, meta.cursor, and a body array of comment records. Rows include id, name, author, body, body_html, created_utc, subreddit, score, ups, parent_id, link_id, link_title, link_permalink, and permalink. Use body for a comment's text and created_utc for its Unix creation time in seconds. The checked AskReddit feed returned 25 recent comments, including one created seconds before the request. This is a cross-thread comment listing, not a complete reply tree: replies was an empty string in observed feed records. Use link_permalink to retrieve selected discussion context with post-details. Neither a guaranteed delivery interval nor complete subreddit comment history is established. Keyword matching, alerts, and sentiment labels require client-side processing.

Pass a bare subreddit name such as AskReddit. The observed response contains meta.status, meta.subreddit, and a body object with name, title, public_description, description, subscribers, created_utc, subreddit_type, over18, lang, url, icon_img, community_icon, banner_img, and banner_background_image. The checked AskReddit result identified a public community with creation timestamp 1201233135 and URL /r/AskReddit/. Use public_description for a short introduction and description for longer community text. Subscriber counts and image URLs can change; image fields may be empty or unavailable for other communities. subscribers is not an active-user count, and this response is not a history of subscriber growth. Calculate community age or count deltas locally from stored timestamps and snapshots. Treat fields such as lang as returned metadata rather than inferring the language of every discussion. This read does not require a Reddit account session or modify the community.

Request the documented popular-community listing without any required inputs. cursor is the only optional parameter: omit it initially, then use an actual returned continuation value if one is available. This endpoint has not been live-validated, so verify its current response envelope, ordering, and pagination before depending on it. The supplied documentation sample shows a body array of community objects with display_name, display_name_prefixed, id, name, title, description, public_description, subscribers, created_utc, subreddit_type, url, and image fields such as icon_img and community_icon. Short descriptions and artwork can be empty. The popular label is not proof of subscriber-count ranking, fastest growth, or a measured trend score. Use subreddit-info to inspect selected communities individually; compute historical comparisons only from snapshots you save yourself.

Request the documented new-community listing with no required inputs. cursor is an optional continuation value and should be omitted on the first request. This endpoint has not been live-validated; confirm the current response envelope, cursor behavior, and meaning of its ordering before using it for time-sensitive discovery. The supplied documentation sample shows a body array containing community objects with display_name, display_name_prefixed, id, name, title, description, public_description, created_utc, subscribers, subreddit_type, url, and optional image fields. The sample includes a restricted community with a small subscriber count, so a listed entry is not proof of open access, an established audience, or active discussion. Use creation timestamps and your own collection times as separate values, and inspect candidates with subreddit-info rather than assuming an exhaustive or strictly newest-first community catalog.

Pass a bare Reddit username such as spez, without u/ or a profile URL. The observed response contains meta.status, meta.username, and a body object with name, total_karma, link_karma, comment_karma, awardee_karma, awarder_karma, created_utc, is_gold, is_mod, verified, and profile. profile includes icon_img and a subreddit object containing public profile fields such as display_name, public_description, title, and url. The checked spez account returned creation timestamp 1118030400 and a public profile URL of /user/spez/. Karma values and public profile text are snapshots and can change. Calculate account age from created_utc in your own application. The returned verified, is_mod, and is_gold flags are account metadata, not an independent determination of identity, authenticity, or trustworthiness. This endpoint does not return the user's posts or comments; use user-data for the separately documented activity listing, whose live behavior has not been validated.

Request the documented public activity listing for a bare username. filter selects comments or posts, sortType selects new, hot, or top, and cursor is an optional continuation value. The configured defaults are filter=comments and sortType=new. This endpoint has not been live-validated; its filtering, sorting, pagination, and current availability need validation before production use. The supplied documentation's comment sample has a body array with id, name, author, body, body_html, created_utc, subreddit, parent_id, link_id, link_title, link_permalink, permalink, and score. That sample describes comment records, not a verified schema for every mode. Do not assume post rows use the same text field or that every documented option returns the expected entity type. Follow only actual returned continuation values and treat the result as a bounded public activity sample, not a complete account archive or access to private activity.