Stream a Subreddit's Newest Comments
Stream the newest comments across an entire subreddit, not one post's thread. Poll it to catch comments as they are posted, with cursor pagination.
/api/reddit/sub/:name/comments$0.0015 / callThe subreddit new-comment stream: the newest comments across an entire
subreddit, not one post's thread. Same comment shape as
GET /api/reddit/user/:name/comments.
When to use this
Poll it to catch every new comment in a community as it is posted, live
moderation, keyword alerting, or building a real-time feed. Unlike
/api/reddit/comments, which returns one post's thread,
this spans the whole subreddit. Page backward through history with after.
Path Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
name | string | Yes | Subreddit name (no r/ prefix) |
A subreddit that does not exist returns 404. A real subreddit with no recent comments returns 200 with an empty list.
Query Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
limit | number | No | Number of comments to return, 1-100 (default 25) |
after | string | No | Pagination cursor. Pass back the after value from the previous response exactly as issued; it is opaque and carries your paging depth. See Pagination depth. |
Paging past Reddit's cap
Reddit closes a single listing near 1000 items and then stops issuing a
cursor, so listing_status: truncated is Reddit's limit rather than the end of
the data. Every distinct combination of parameters you send is a separate
listing with its own budget, so widen across listings rather than paging
deeper into one.
What you can vary here:
- This endpoint takes no
sortand no timeframe, so there is no parameter here that opens a second budget. Reach the rest through a different endpoint. - Search is a different listing again:
/api/reddit/searchwith a query scoped to the subreddit reaches posts a listing will not.
Example
curl -H "Authorization: Bearer $TOKEN" \
"https://api.redditapis.com/api/reddit/sub/programming/comments?limit=25"const response = await fetch(
"https://api.redditapis.com/api/reddit/sub/programming/comments?limit=25",
{ headers: { Authorization: "Bearer TOKEN" } }
);
const data = await response.json();import requests
response = requests.get(
"https://api.redditapis.com/api/reddit/sub/programming/comments",
params={"limit": 25},
headers={"Authorization": "Bearer TOKEN"},
)Response Shape
{
"comments": [
{
"id": "n1abc2d",
"author": "someuser",
"body": "This is the newest comment in the subreddit.",
"subreddit": "programming",
"upvotes": 12,
"permalink": "/r/programming/comments/abc123/title/n1abc2d/",
"url": "https://reddit.com/r/programming/comments/abc123/title/n1abc2d/",
"post_id": "abc123",
"parent_id": "t3_abc123",
"is_submitter": false,
"link_title": "The post this comment is on",
"link_url": "https://example.com/article",
"created": "2026-05-22T10:29:25.000Z"
}
],
"after": "t1_n1abc2d"
}Response Fields
| Field | Type | Notes |
|---|---|---|
id | string | Comment id (no prefix) |
author | string | Comment author (no u/ prefix) |
body | string | The comment text |
subreddit | string | Subreddit the comment is in (no r/ prefix) |
upvotes | number | null | Net vote count on the comment; null when hidden or unknown (see score_hidden) |
permalink | string | The comment's own path on reddit.com, e.g. /r/programming/comments/abc123/title/n1abc2d/. Same field a post row carries |
url | string | Full reddit.com URL that deep-links to the comment (permalink with the host prefixed) |
post_id | string | null | Id of the parent post (no prefix), for joining against GET /post/:id or GET /post/:id/comments |
parent_id | string | null | What this comment replies to, as Reddit names it: t3_<post id> for a top-level comment, t1_<comment id> for a reply to another comment. Rebuild a thread from it |
is_submitter | boolean | null | true when the commenter is the author of the post the comment is on; null when the page does not show it |
link_title | string | null | Title of the parent post the comment is on |
link_url | string | null | URL of the parent post (external link for link posts) |
created | string | ISO-8601 timestamp of the comment |
after | string | null | Cursor for the next page, or null when there is no next page to request. An empty cursor does not always mean you have every item, so read listing_status (below) to find out which. See Pagination depth. |
score_hidden | boolean or null | true while the subreddit hides fresh comment scores; null when the page did not show it. In both cases upvotes is null, never Reddit's placeholder 1. is_submitter can also be null when the page does not show it |
coverage | string | sampled when the page was rebuilt from the newest comments of the busiest threads (threads_read says how many); absent on a full read |
When after comes back empty
An empty cursor means there is no next page to ask for. It does not always mean
you have every comment: Reddit often stops serving a busy listing long before it
runs out. Paging r/all on 2026-08-14 stopped after 400 posts covering about a
minute of a feed that plainly holds more.
The response tells you which happened. When after is null it also carries
listing_status, which reads complete, truncated or unknown. Only
complete means you have everything; treat the other two as a partial answer
and widen your search rather than stopping. The full field list and what to do
about each answer is in Pagination depth.
Independent third-party API for developers and researchers. Not affiliated with, endorsed by, or sponsored by Reddit, Inc.
Top Posts
Get the top posts in any subreddit for a timeframe, day, week, month, year, or all-time. Alias for /api/reddit/posts with sort=top, with cursor pagination.
Subreddit About
Fetch a subreddit's public metadata by name: title, description, subscriber and active-user counts, creation date, type, and NSFW flag.
