List the comments on a Reddit post

POST/v1/tools/reddit.post.comments/callsNeeds an API key

Returns the comments on a Reddit post, with author, score and replies in thread order. Use it to read how a community reacts to a post.

Tool reddit.post.comments on Reddit. Contract version 1, released 2026-10-30.

Over REST, send the input in the body. Over MCP, pass the same input to call_tool.

Both return the full response: the call's ID, status and cost, with this tool's result in output.

Input

urlstringRequired

Address of the post, https://www.reddit.com/r/<subreddit>/comments/<post id>/, as the url of a post from reddit.search.posts. reddit.com, old.reddit.com and new.reddit.com work too, over http or https, with or without the title slug, trailing slash, query string or fragment. A redd.it short link does not.

Format uri.

Matches ^https?://(?:(?:www|old|new)\.)?reddit\.com/r/([A-Za-z0-9_]{2,21})/comments/([a-z0-9]{1,20})(?:/[A-Za-z0-9_-]*)?/?(?:[?#]\S*)?$.

sortstring

Order of the comments: best (Reddit's ranking), top (highest score), new, controversial or old. Left out, the order the post's subreddit suggests.

best

top

new

controversial

old

include_repliesboolean· default true

Whether replies come too, each after the comment it answers. False returns top-level comments only. Either way, Reddit leaves out the branches it collapses on a large thread.

next_page_tokenstring

Fetches the next page. Take it from pagination.next_page_token of the previous page, and send the same url, sort and include_replies.

Output

A successful call returns these blocks in its output. A field not marked required can be null.

`comments`

A list of rows. Always present, possibly empty. The post's comments in thread order.

idstringRequired

Reddit's full name of the comment, t1_ followed by its id.

urlstring

Address of the comment on www.reddit.com.

Format uri.

textstring

What the comment says, in Markdown.

htmlstring

What the comment says, as HTML.

published_atstring

When the comment was posted, in ISO 8601.

author_idstring

Reddit's full name of the author's account, t2_ followed by its id.

author_usernamestring

The author's username, without u/.

scoreinteger

Upvotes minus downvotes, as Reddit shows it. Reddit fuzzes it slightly.

depthinteger

0 for a comment on the post, 1 for a reply to one, and so on.

parent_idstring

Full name of the comment this one replies to. Null for a top-level comment.

`pagination`

One object. Can be null. How to fetch the next page. Null on the last page.

next_page_tokenstringRequired

Send as next_page_token to fetch the next page.

curl https://api.voxoria.ai/v1/tools/reddit.post.comments/calls \
  -H "Authorization: Bearer $VOXORIA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input":{"url":"https://www.reddit.com/r/Python/comments/1xbnrhi/litellm_11070_on_pypi_is_compromised/"}}'

import os

import httpx

response = httpx.post(
    "https://api.voxoria.ai/v1/tools/reddit.post.comments/calls",
    headers={"Authorization": f"Bearer {os.environ['VOXORIA_API_KEY']}"},
    json={
        "input": {
            "url": "https://www.reddit.com/r/Python/comments/1xbnrhi/litellm_11070_on_pypi_is_compromised/",
        },
    },
    timeout=60,
)
print(response.json())

const response = await fetch("https://api.voxoria.ai/v1/tools/reddit.post.comments/calls", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.VOXORIA_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "input": {
      "url": "https://www.reddit.com/r/Python/comments/1xbnrhi/litellm_11070_on_pypi_is_compromised/",
    },
  }),
});
console.log(await response.json());

{
  "name": "call_tool",
  "arguments": {
    "tool": "reddit.post.comments",
    "input": {
      "url": "https://www.reddit.com/r/Python/comments/1xbnrhi/litellm_11070_on_pypi_is_compromised/"
    }
  }
}

200 OKoutputapplication/json

{
  "comments": [
    {
      "id": "t1_19rfr1194cckj",
      "url": "https://www.reddit.com/r/Python/comments/1xbnrhi/litellm_11070_on_pypi_is_compromised/19rfr1194cckj/",
      "text": "litellm again....!",
      "html": "<!-- SC_OFF --><div class=\"md\"><p>litellm again....!</p> </div><!-- SC_ON -->",
      "published_at": null,
      "author_id": null,
      "author_username": "Nice_Mix_1021",
      "score": null,
      "depth": null,
      "parent_id": null
    },
    {
      "id": "t1_19rfs64yjyzdx",
      "url": "https://www.reddit.com/r/Python/comments/1xbnrhi/litellm_11070_on_pypi_is_compromised/19rfs64yjyzdx/",
      "text": "Litellm is a vibe code piece of shit btw",
      "html": "<!-- SC_OFF --><div class=\"md\"><p>Litellm is a vibe code piece of shit btw </p> </div><!-- SC_ON -->",
      "published_at": null,
      "author_id": null,
      "author_username": "Jmc_da_boss",
      "score": null,
      "depth": null,
      "parent_id": null
    },
    {
      "id": "t1_19rfwew7ohacg",
      "url": "https://www.reddit.com/r/Python/comments/1xbnrhi/litellm_11070_on_pypi_is_compromised/19rfwew7ohacg/",
      "text": "I contributed to it once and holy shit their git flow was confusing, no idea how a human could even follow what is happening there",
      "html": "<!-- SC_OFF --><div class=\"md\"><p>I contributed to it once and holy shit their git flow was confusing, no idea how a human could even follow what is happening there</p> </div><!-- SC_ON -->",
      "published_at": null,
      "author_id": null,
      "author_username": "JoNike",
      "score": null,
      "depth": null,
      "parent_id": null
    }
  ],
  "pagination": null
}

The output of a real call, each list cut to 3 items.