Endpoints by data type
Comments API
11 endpoints on 11 platforms return comments as the same Comment object. The comments under one post, video or note, a page at a time: the text, who wrote it, when, its likes and how many replies it has. A call costs from $0.002 to $0.02, each endpoint at its own price; a failed call is free.
Comments · on each platform
| Platform | Endpoint | Path | A page | Price |
|---|---|---|---|---|
| Douyin | Douyin video comments | GET /v1/douyin/videos/comments/list | 20 | $0.002 per call · about 20 comments per page |
| Xiaohongshu (RedNote) | Xiaohongshu note comments | GET /v1/xiaohongshu/notes/comments/list | 10 | $0.02 per call · about 10 comments per page |
| Bilibili | Bilibili video comments | GET /v1/bilibili/videos/comments/list | 20 | $0.002 per call · about 20 comments per page |
| TikTok | TikTok video comments | GET /v1/tiktok/videos/comments/list | 50 | $0.002 per call · about 50 comments per page |
| YouTube | YouTube video comments | GET /v1/youtube/videos/comments/list | 20 | $0.002 per call · about 20 comments per page |
| Instagram post comments | GET /v1/instagram/posts/comments/list | 15 | $0.004 per call · about 15 comments per page | |
| Reddit post comments | GET /v1/reddit/posts/comments/list | 10 | $0.002 per call · about 10 comments per page | |
| Kuaishou | Kuaishou video comments | GET /v1/kuaishou/videos/comments/list | 10 | $0.002 per call · about 10 comments per page |
| WeChat Channels | WeChat Channels video comments | GET /v1/wechat_channels/videos/comments/list | 25 | $0.015 per call · about 25 comments per page |
| Weibo post comments | GET /v1/weibo/posts/comments/list | 20 | $0.002 per call · about 20 comments per page | |
| WeChat Official Accounts | Official Account article comments | GET /v1/wechat_mp/articles/comments/list | 20 | $0.02 per call · about 20 comments per page |
from $0.002 to $0.02 a call, each endpoint at its own price. A call that fails costs nothing.
The object it returns: 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.
# Douyin
curl -G "https://api.okdata.online/v1/douyin/videos/comments/list" \
-H "Authorization: Bearer $OKDATA_API_KEY" \
--data-urlencode 'id=7301234567890123456'
# Xiaohongshu (RedNote)
curl -G "https://api.okdata.online/v1/xiaohongshu/notes/comments/list" \
-H "Authorization: Bearer $OKDATA_API_KEY" \
--data-urlencode 'id=6650a1b2000000001e00abcd'What people use it for
- Read what buyers praise and complain about under a competitor’s launch video.
- Feed a week of comments to a model for sentiment and recurring pain points.
- Check whether a creator’s comment section looks like real people before you book them.
Questions
- Do I get every comment on a post?
- You get what the platform shows publicly, page by page: send page.next_cursor back as cursor until page.has_more is false. Platforms fold or hide some comments, so a total can be a little lower than the count on the post.
- Are replies to comments included?
- Top-level comments come back with a replies count. Where a platform has a replies endpoint, it is listed on the comment replies page; otherwise reply text is not available.
- What does a page of comments cost?
- Each page is one call at that endpoint’s price, shown in the table above. A call that fails, or a post that no longer exists, costs nothing.