Reddit · Schema

Reddit Comment

Represents a Reddit comment within a submission's comment tree, including its text content, author information, voting data, and position in the reply hierarchy.

AdvertisingCommunitiesContentSocial-MediaSocial News

Properties

Name Type Description
id string The unique ID36 identifier for the comment.
name string The fullname of the comment, with the t1_ prefix.
parent_id string The fullname of the parent thing (t1_ for a comment, t3_ for a submission).
link_id string The fullname of the submission this comment belongs to.
subreddit string The name of the subreddit this comment was posted in.
subreddit_id string The fullname of the subreddit.
author string The username of the comment author.
author_fullname string The fullname of the comment author.
body string The body text of the comment in markdown format.
body_html string The body text of the comment rendered as HTML.
score integer The net score (upvotes minus downvotes) of the comment.
ups integer The number of upvotes.
downs integer The number of downvotes.
created_utc number The Unix timestamp of when the comment was created.
edited numberboolean The Unix timestamp of the last edit, or false if never edited.
is_submitter boolean Whether the comment author is also the author of the parent submission.
stickied boolean Whether the comment is stickied (pinned) by a moderator.
locked boolean Whether the comment is locked from replies.
archived boolean Whether the comment is archived.
saved boolean Whether the comment is saved by the authenticated user.
distinguished stringnull Whether the comment has been distinguished by a moderator or admin.
author_flair_text stringnull The flair text of the comment author in this subreddit.
author_flair_css_class stringnull The CSS class of the author's flair.
permalink string The relative permalink URL of the comment.
depth integer The depth of the comment in the reply tree, starting at 0.
gilded integer The number of times this comment has been gilded.
replies objectstring The replies to this comment as a Listing object, or an empty string if there are no replies.
score_hidden boolean Whether the comment score is currently hidden.
controversiality integer Whether the comment is controversial (0 or 1).
View JSON Schema on GitHub

JSON Schema

reddit-comment-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://reddit.com/schemas/reddit/comment.json",
  "title": "Reddit Comment",
  "description": "Represents a Reddit comment within a submission's comment tree, including its text content, author information, voting data, and position in the reply hierarchy.",
  "type": "object",
  "required": ["id", "name", "body", "author", "link_id", "created_utc"],
  "properties": {
    "id": {
      "type": "string",
      "description": "The unique ID36 identifier for the comment."
    },
    "name": {
      "type": "string",
      "description": "The fullname of the comment, with the t1_ prefix.",
      "pattern": "^t1_[a-z0-9]+$"
    },
    "parent_id": {
      "type": "string",
      "description": "The fullname of the parent thing (t1_ for a comment, t3_ for a submission).",
      "pattern": "^t[13]_[a-z0-9]+$"
    },
    "link_id": {
      "type": "string",
      "description": "The fullname of the submission this comment belongs to.",
      "pattern": "^t3_[a-z0-9]+$"
    },
    "subreddit": {
      "type": "string",
      "description": "The name of the subreddit this comment was posted in."
    },
    "subreddit_id": {
      "type": "string",
      "description": "The fullname of the subreddit.",
      "pattern": "^t5_[a-z0-9]+$"
    },
    "author": {
      "type": "string",
      "description": "The username of the comment author."
    },
    "author_fullname": {
      "type": "string",
      "description": "The fullname of the comment author.",
      "pattern": "^t2_[a-z0-9]+$"
    },
    "body": {
      "type": "string",
      "description": "The body text of the comment in markdown format."
    },
    "body_html": {
      "type": "string",
      "description": "The body text of the comment rendered as HTML."
    },
    "score": {
      "type": "integer",
      "description": "The net score (upvotes minus downvotes) of the comment."
    },
    "ups": {
      "type": "integer",
      "description": "The number of upvotes."
    },
    "downs": {
      "type": "integer",
      "description": "The number of downvotes."
    },
    "created_utc": {
      "type": "number",
      "format": "double",
      "description": "The Unix timestamp of when the comment was created."
    },
    "edited": {
      "type": ["number", "boolean"],
      "description": "The Unix timestamp of the last edit, or false if never edited."
    },
    "is_submitter": {
      "type": "boolean",
      "description": "Whether the comment author is also the author of the parent submission."
    },
    "stickied": {
      "type": "boolean",
      "description": "Whether the comment is stickied (pinned) by a moderator."
    },
    "locked": {
      "type": "boolean",
      "description": "Whether the comment is locked from replies."
    },
    "archived": {
      "type": "boolean",
      "description": "Whether the comment is archived."
    },
    "saved": {
      "type": "boolean",
      "description": "Whether the comment is saved by the authenticated user."
    },
    "distinguished": {
      "type": ["string", "null"],
      "description": "Whether the comment has been distinguished by a moderator or admin.",
      "enum": [null, "moderator", "admin"]
    },
    "author_flair_text": {
      "type": ["string", "null"],
      "description": "The flair text of the comment author in this subreddit."
    },
    "author_flair_css_class": {
      "type": ["string", "null"],
      "description": "The CSS class of the author's flair."
    },
    "permalink": {
      "type": "string",
      "description": "The relative permalink URL of the comment."
    },
    "depth": {
      "type": "integer",
      "description": "The depth of the comment in the reply tree, starting at 0.",
      "minimum": 0
    },
    "gilded": {
      "type": "integer",
      "description": "The number of times this comment has been gilded.",
      "minimum": 0
    },
    "replies": {
      "type": ["object", "string"],
      "description": "The replies to this comment as a Listing object, or an empty string if there are no replies."
    },
    "score_hidden": {
      "type": "boolean",
      "description": "Whether the comment score is currently hidden."
    },
    "controversiality": {
      "type": "integer",
      "description": "Whether the comment is controversial (0 or 1).",
      "minimum": 0,
      "maximum": 1
    }
  }
}

Work with this as data

Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for schemas

4 MCP tools reach this
  • find_json_schemasBrowse and filter every JSON Schema in the catalog.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/reddit-comment"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.