M
MesmerTools
GET/v1/reddit/post/comments

Post comments API

Fetches both the original post and the recursive comment tree for any Reddit post URL. Each comment carries its own `replies: { items, more }` structure — `more.next_cursor` is a comma-separated list of comment ids you can pass back via `cursor` to expand deeper threads.

Authentication

Include x-api-key: <your_key> in your request headers
Requests without a valid key get a 401 Unauthorized. Revoked keys return 403 Forbidden.
Get a key

Parameters

urlRequired
string
Full Reddit post URL (or relative /r/sub/comments/id/...).
cursorOptional
string
Comma-separated comment ids (from a prior response's `more.next_cursor`) to expand more children.
trimOptional
boolean
Set to "true" to drop selftext_html from the post object.

Example request

curl "https://mesmer.tools/api/v1/reddit/post/comments?url=https%3A%2F%2Fwww.reddit.com%2Fr%2FPython%2Fcomments%2F1t8r5sf%2F" \
  -H "x-api-key: <YOUR_API_KEY>"

Try it now

Hits the live endpoint with your API key.

Saved locally in your browser. Mint a key in /admin/api-keys.

Response schema

Trimmed example — see Field reference for descriptions.

{
  "success": true,
  "credits_remaining": -1,
  "post": {
    "id": "1t8r5sf",
    "title": "Sunday Daily Thread: What's everyone working on this week?",
    "subreddit": "Python",
    "author": "AutoModerator",
    "ups": 6,
    "num_comments": 8,
    "selftext": "# Weekly Thread..."
  },
  "comments": [
    {
      "id": "n1xa7r2",
      "author": "some_user",
      "body": "Been finishing a CLI for log analysis. Used Typer + Rich.",
      "score": 12,
      "depth": 0,
      "permalink": "/r/Python/comments/1t8r5sf/.../n1xa7r2/",
      "created_at_iso": "2026-04-21T11:02:45.000Z",
      "replies": {
        "items": [
          {
            "id": "n1xb2p4",
            "author": "another_user",
            "body": "Mind sharing the repo?",
            "score": 3,
            "depth": 1,
            "replies": {
              "items": [],
              "more": {
                "has_more": false,
                "next_cursor": null
              }
            }
          }
        ],
        "more": {
          "has_more": false,
          "next_cursor": null
        }
      }
    },
    "...7 more top-level comments"
  ],
  "more": {
    "has_more": false,
    "next_cursor": null
  }
}

Field reference

Top-level response fields you'll most likely use.

post
object
The original post — same raw t3_* shape as /v1/reddit/subreddit posts.
comments[].id
string
Comment short-id (base36).
comments[].author
string
Commenter's username.
comments[].body
string
Comment Markdown source.
comments[].score
number
Net upvotes.
comments[].created_at_iso
string
ISO-8601 creation time.
comments[].depth
number
Tree depth — 0 is top-level.
comments[].permalink
string
Reddit-relative path to this exact comment.
comments[].replies
object
{ items: NormalizedComment[], more: { has_more, next_cursor } }.
more.next_cursor
string
Top-level continuation token for the next batch of root comments.
Previous
Reddit search
/v1/reddit/search
Next
Search companies
/v1/facebook/adLibrary/search/companies