# Comment replies API

> 11 endpoints on 11 platforms return comment replies as the same Comment object. The replies under one top-level comment, a page at a time: each reply’s text, who wrote it, when, and how many likes…

Canonical page: https://okdata.online/roles/comments-replies-list/

11 endpoints on 11 platforms return comment replies as the same Comment object. The replies under one top-level comment, a page at a time: each reply’s text, who wrote it, when, and how many likes it got. A call costs from $0.002 to $0.02, each endpoint at its own price; a failed call is free.

## on each platform

| Platform | Endpoint | Path | A page | Price |
|---|---|---|---|---|
| Instagram | [Instagram comment replies](https://okdata.online/apis/instagram/comments/replies/list/) | `GET /v1/instagram/comments/replies/list` | 15 | $0.004 per call · about 15 comments per page |
| Kuaishou | [Kuaishou comment replies](https://okdata.online/apis/kuaishou/comments/replies/list/) | `GET /v1/kuaishou/comments/replies/list` | 20 | $0.002 per call · about 20 comments per page |
| Zhihu | [Zhihu comment replies](https://okdata.online/apis/zhihu/comments/replies/list/) (coming soon) | `GET /v1/zhihu/comments/replies/list` | 20 | $0.002 per call · about 20 comments per page |
| WeChat Channels | [WeChat Channels comment replies](https://okdata.online/apis/wechat_channels/comments/replies/list/) | `GET /v1/wechat_channels/comments/replies/list` | 20 | $0.015 per call · about 20 comments per page |
| Douyin | [Douyin comment replies](https://okdata.online/apis/douyin/comments/replies/list/) | `GET /v1/douyin/comments/replies/list` | 20 | $0.002 per call · about 20 comments per page |
| Xiaohongshu (RedNote) | [Xiaohongshu comment replies](https://okdata.online/apis/xiaohongshu/comments/replies/list/) | `GET /v1/xiaohongshu/comments/replies/list` | 5 | $0.02 per call · about 5 comments per page |
| Weibo | [Weibo comment replies](https://okdata.online/apis/weibo/comments/replies/list/) | `GET /v1/weibo/comments/replies/list` | 20 | $0.002 per call · about 20 comments per page |
| Bilibili | [Bilibili comment replies](https://okdata.online/apis/bilibili/comments/replies/list/) | `GET /v1/bilibili/comments/replies/list` | 20 | $0.002 per call · about 20 comments per page |
| WeChat Official Accounts | [Official Account comment replies](https://okdata.online/apis/wechat_mp/comments/replies/list/) | `GET /v1/wechat_mp/comments/replies/list` | 3 | $0.02 per call · about 3 comments per page |
| YouTube | [YouTube comment replies](https://okdata.online/apis/youtube/comments/replies/list/) | `GET /v1/youtube/comments/replies/list` | 10 | $0.002 per call · about 10 comments per page |
| TikTok | [TikTok comment replies](https://okdata.online/apis/tiktok/comments/replies/list/) | `GET /v1/tiktok/comments/replies/list` | 20 | $0.002 per call · about 20 comments per page |

## The object it returns: [Comment](https://okdata.online/docs/objects/comment/)

Every endpoint above returns these fields with the same names and types. A field a platform does not show comes back null and is named in meta.unavailable.

| Field | Type | Meaning |
|---|---|---|
| `id` | `string` | Comment ID. |
| `post_id` | `string` | ID of the post it is under. |
| `parent_id` | `string \| null` | The comment it replies to; null for top-level comments. |
| `text` | `string` | Comment text. |
| `published_at` | `string` | When it was posted, ISO 8601 in UTC. |
| `author` | `AccountRef` | Who wrote it. |
| `likes` | `integer \| null` | Likes on the comment. |
| `replies` | `integer \| null` | Replies under it. |
| `ip_location` | `string \| null` | Region label the platform shows next to the comment, if any. |
| `ext` | `object` | Platform-specific extras. Only returned with view=full. |

## The same call on two platforms

Same parameters, same paging, same response shape. Only the path changes.

```bash
# Instagram
curl -G "https://api.okdata.online/v1/instagram/comments/replies/list" \
  -H "Authorization: Bearer $OKDATA_API_KEY" \
  --data-urlencode 'id=17968670751170878' \
  --data-urlencode 'post_id=DeCPVhERA8e'

# Kuaishou
curl -G "https://api.okdata.online/v1/kuaishou/comments/replies/list" \
  -H "Authorization: Bearer $OKDATA_API_KEY" \
  --data-urlencode 'id=908850553827' \
  --data-urlencode 'post_id=3xgarycnydawq3g'
```

## What people use it for

- Read the whole argument under a comment that drew dozens of replies, not just the comment itself.
- See whether a brand’s answer to a complaint settled it or set off more complaints.
- Collect the follow-up questions buyers ask under a popular comment.

## Questions

### What do I need to call it?

The comment’s id and the post_id of the post it sits under, both from the comments endpoint of the same platform. On Instagram, post_id is the post’s shortcode; on WeChat, it is the article’s link.

### Which comments are worth opening?

Every top-level comment comes with a replies count. Sort by it and open only the comments above zero, because each page of replies is one call.

### What about platforms that are not in the table?

There the comments endpoint still gives each comment’s replies count, but the reply text is not available here until a replies endpoint for that platform is added to the table.

## Other data types

- [Comments API](https://okdata.online/roles/posts-comments-list/)
- [Trending topics API](https://okdata.online/roles/trends-list/)
- [Hashtag posts API](https://okdata.online/roles/topics-posts-list/)
- [Profile API](https://okdata.online/roles/accounts-get/)
- [Account posts API](https://okdata.online/roles/accounts-posts-list/)
- [Post detail API](https://okdata.online/roles/posts-get/)
- [Post search API](https://okdata.online/roles/posts-search/)
- [Trending posts API](https://okdata.online/roles/posts-trending/)
- [Account search API](https://okdata.online/roles/accounts-search/)
- [Post metrics API](https://okdata.online/roles/posts-metrics/)
- [Community posts API](https://okdata.online/roles/communities-posts-list/)
- [Ad detail API](https://okdata.online/roles/ads-get/)
- [Advertiser ads API](https://okdata.online/roles/advertisers-ads-list/)
- [Ad search API](https://okdata.online/roles/ads-search/)
- [Transcript API](https://okdata.online/roles/transcripts-get/)
- [Followers list API](https://okdata.online/roles/accounts-followers-list/)
- [Product detail API](https://okdata.online/roles/products-get/)
- [Product reviews API](https://okdata.online/roles/products-reviews-list/)
- [Product search API](https://okdata.online/roles/products-search/)
- [Creator search API](https://okdata.online/roles/creators-search/)
- [Creator profile API](https://okdata.online/roles/creators-get/)
- [Creator audience API](https://okdata.online/roles/creators-audience-get/)
