Comment object

23 endpoints on 13 platforms return the Comment object with the same 13 fields, so code written for one platform reads the others unchanged. A call costs $0.0020 to $0.0200.

Stable object · Updated 2026-10-17Open in ChatGPTOpen in Claude

A Comment is what someone wrote under a post: its text, who wrote it, when, and its likes and reply count. A reply to a comment is a comment too, read with each platform's replies endpoint.

post_id is the post it is under; parent_id is the comment it answers directly and root_id the top-level comment of its thread, both null on a top-level comment. It shares these fields and author, text and metrics with Post, so an X (Twitter) reply, which comes back as a post, reads as a comment too; a buyer's review of a product is a Review, not a comment.

Fields

A field the platform cannot give is left out of the item and named in meta.unavailable. It is never filled with a guess or a zero.

id text

ID

url link

Link that opens the comment

text text

Text

published_at time

When it was posted

author object

Commenter

author.id text

Commenter's account ID

author.username text

Commenter's handle

author.name text

Commenter's display name

author.avatar_url link standard

Commenter's avatar

metrics object

Engagement counts

metrics.likes integer

Likes

metrics.comments integer

Replies

post_id text

ID of the post it is under

parent_id text

ID of the comment it replies to directly; null for a top-level comment

root_id text

ID of the top-level comment of its thread; null for a top-level comment

Where each number comes from

The same field name does not always mean the same act on every platform. This table says which of the platform's own numbers goes into the field.

FieldWhat it holds thereOn
metrics.likesLikes; from a thousand up the platform shows a rounded numberYouTube
All reactions together (like, love, haha and the rest)Facebook

What a platform cannot give

A platform stands against a field when none of its endpoints gives it.

FieldNot available on
urlTikTokYouTubeInstagramDouyinXiaohongshu (RedNote)FacebookWeChat Official AccountsWeChat ChannelsBilibiliWeiboKuaishouZhihu
published_atYouTube
author.usernameFacebookWeChat Official AccountsWeChat ChannelsWeiboKuaishou
author.nameInstagramReddit
metrics.likesReddit
metrics.commentsInstagramWeChat ChannelsKuaishou
post_idYouTubeInstagramWeChat Official AccountsKuaishouZhihu
parent_idFacebook
root_idFacebook
One endpoint may still leave out a field another gives: each endpoint's page lists what it cannot give, and every answer says so in meta.unavailable.

Endpoints that return Comment

The number beside each platform is how many of its endpoints return it.

EndpointPathPrice
TikTok comment repliesGET/v1/tiktok/comments/replies/list$0.0020
TikTok video commentsGET/v1/tiktok/videos/comments/list$0.0020
YouTube comment repliesGET/v1/youtube/comments/replies/list$0.0020
YouTube video commentsGET/v1/youtube/videos/comments/list$0.0020
Instagram comment repliesGET/v1/instagram/comments/replies/list$0.0020
Instagram post commentsGET/v1/instagram/posts/comments/list$0.0020
Douyin comment repliesGET/v1/douyin/comments/replies/list$0.0020
Douyin video commentsGET/v1/douyin/videos/comments/list$0.0020
Xiaohongshu comment repliesGET/v1/xiaohongshu/comments/replies/list$0.0200
Xiaohongshu note commentsGET/v1/xiaohongshu/notes/comments/list$0.0200
Reddit post commentsGET/v1/reddit/posts/comments/list$0.0020
Facebook post commentsGET/v1/facebook/posts/comments/list$0.0020
WeChat Official Account article commentsGET/v1/wechat_mp/articles/comments/list$0.0200
WeChat Official Account comment repliesGET/v1/wechat_mp/comments/replies/list$0.0200
WeChat Channels video commentsGET/v1/wechat_channels/videos/comments/list$0.0200
Bilibili comment repliesGET/v1/bilibili/comments/replies/list$0.0020
Bilibili video commentsGET/v1/bilibili/videos/comments/list$0.0020
Weibo comment repliesGET/v1/weibo/comments/replies/list$0.0020
Weibo post commentsGET/v1/weibo/posts/comments/list$0.0020
Kuaishou comment repliesGET/v1/kuaishou/comments/replies/list$0.0020
Kuaishou video commentsGET/v1/kuaishou/videos/comments/list$0.0020
Zhihu answer commentsGET/v1/zhihu/answers/comments/list$0.0020
Zhihu comment repliesGET/v1/zhihu/comments/replies/list$0.0020

Example

One item from tiktok.comments.replies.list, as recorded 2026-10-12 18:45 UTC. Names, text, IDs and links are examples; the figures are as recorded.

Comment · tiktok.comments.replies.list
{
  "id": "7644787390529913037",
  "text": "Watched this twice, so calm.",
  "published_at": "2026-10-08T14:25:18.000Z",
  "author": {
    "id": "6105018514602246534",
    "username": "priya.reads",
    "name": "Priya R.",
    "avatar_url": "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/597f67debd958121cee2~c5_100x100.jpeg"
  },
  "metrics": { "likes": 12 },
  "post_id": "7509942111396641514",
  "parent_id": "7634441392518202098",
  "root_id": "7616357043440017458"
}

The whole response is on the endpoint's page →

Related

Other objects