Comment

Any endpoint that returns comments or replies returns them in this shape, whichever platform they came from. One parser reads comments from every platform that has them. This page describes schema 2, which every key gets from October 4, 2026; what changed is on Schema 2.

Where comments sit in data

A list also carries data.total (the platform's own total, not the size of this page) and data.truncated, true when the platform cut the thread short (Reddit's "more replies" threshold). Both are null when the platform does not say. The next page is in pagination.next_cursor.

Example

One row from /v1/twitter/tweet/replies, shortened:

{
  "success": true,
  "platform": "twitter",
  "endpoint": "/v1/twitter/tweet/replies",
  "schema_version": "2",
  "data": {
    "items": [
      {
        "comment": {
          "id": "2106150051978662105",
          "url": "https://x.com/bobcarter101/status/2106150051978662105",
          "parent_id": null,
          "post_id": "2106061652617568263",
          "text": "@NASA @Space_Station skills required; watching SpaceX’s live stream.",
          "author": {
            "id": null,
            "username": "bobcarter101",
            "display_name": "Bob Carter",
            "avatar_url": "https://pbs.twimg.com/profile_images/…",
            "verified": true
          },
          "engagement": { "likes": 3, "replies": 2 },
          "flags": { "pinned": null, "deleted": false },
          "published_at": "2026-10-02T22:31:17.000Z",
          "language": "en",
          "replies": null,
          "ext": { "author_followers": 4909, "quote_count": 0, "views": 681 }
        }
      }
    ],
    "total": null,
    "truncated": null
  },
  "pagination": { "next_cursor": "v2c.ouEEuPti…", "has_more": true, "page_size": 36 },
  "unavailable": ["items[].comment.author.id"],
  "credits_used": 10,
  "credits_remaining": 9990,
  "request_id": "req_48e49dfbad28",
  "cached": false,
  "idempotent_replay": false,
  "charge_reason": "miss",
  "free_call": false
}

X gives no author ID on replies, so every row has author.id: null and the response says so in unavailable.

Fields

Every field is always present; a value the platform does not give is null.

Fetching replies

Replies endpoints take the platform's own identifiers, which every comment carries:

Extension fields (ext)

Platform-specific extras. Each one appears only where the platform provides it, so treat every ext field as optional. ext is null when a comment has no extras. Keys are snake_case on every platform, _id values are strings and _at values are ISO 8601 UTC times. ext never carries our cursors or tokens.

Which platforms fill which fields

Every platform that returns comments uses this shape. id and flags.deleted are never null. The table covers the platforms the API launched with that return comments. The others return the same shape, and each response's unavailable list names the fields it could not fill. yes means the platform can fill the field (it may still be null on a given row); a blank means it never does.

parent_id is filled on replies only; top-level comments carry null everywhere. On Reddit, replies are nested in replies[] rather than counted. On Facebook, an opaque pfbid… profile ID goes to author.id, not author.username. On Reddit, the account's t2_ ID goes to author.id.

unavailable

When a field the platform normally fills is null on every comment in a response, the response lists its path in unavailable, for example "items[].comment.author.id". Fields a platform never shows are never listed: the comment url on TikTok, author.username on Facebook and author.display_name on Reddit.

Returned by

Endpoints that return a comment or a list of comments use this shape on:

Facebook · Instagram · LinkedIn · Reddit · Threads · TikTok · Twitter/X · YouTube

To see which native platform field feeds each unified field, read Field equivalence.