Skip to main content
GET
Get Reddit post comments (live)

Authorizations

Authorization
string
header
required

XPOZ API access key, created from the dashboard or POST /api/tokens. Send as Authorization: Bearer <access key>.

Path Parameters

id
string
required

Reddit post ID.

Query Parameters

sort
enum<string>

Thread order. Defaults to best.

Available options:
best,
top,
new,
controversial,
old,
qa
fields
enum<string>[]

Reddit comment fields to return. Comma-separated. Allowed values: id, body, parentPostId, parentId, authorId, authorUsername, postSubredditName, postSubredditId, score, upvotes, downvotes, controversiality, depth, isSubmitter, stickied, collapsed, edited, distinguished, createdAt, createdAtTimestamp, createdAtDate, collapsedReasonCode, collapsedReason, removal, rank, topLevelRank.

Available options:
id,
body,
parentPostId,
parentId,
authorId,
authorUsername,
postSubredditName,
postSubredditId,
score,
upvotes,
downvotes,
controversiality,
depth,
isSubmitter,
stickied,
collapsed,
edited,
distinguished,
createdAt,
createdAtTimestamp,
createdAtDate,
collapsedReasonCode,
collapsedReason,
removal,
rank,
topLevelRank
limit
integer
default:100

Comments per page (1-500). Defaults to 100. Pages that expand a "load more" batch are capped at 100.

Required range: 1 <= x <= 500
tree
boolean
default:false

When true, replies are nested under their parent in a replies array (formatted with the same fields) instead of returned as a flat list.

cursor
string

Opaque cursor from next_page_cursor of the previous page.

Response

One page of results.

Envelope for on-demand /live endpoints: one provider page plus a cursor.

results
object[]
required
count
integer
required
dataSource
enum<string>
required

Where the results came from.

Available options:
database,
api,
hybrid
has_more
boolean
required
next_page_cursor
string | null
required