SocialToAI免费开始控制台

comments

POST /v1/comments 是“评论”动作：一条内容下的评论。目前在 14 个平台上开放（TikTok、Instagram、X、Reddit、YouTube、Facebook 等），平台是请求里的一个参数。每次调用 2 到 12 积分，因平台而异；失败的调用不扣。

POSThttps://api.socialtoai.com/v1/comments

请求

请求体是 JSON。下面这几项每个动作都一样，其余的参数因平台而异，见后文。

名称类型位置必填说明
platformstring请求体是要读的平台，取这个动作已开放的平台之一。
max_cost_creditsinteger请求体否这次调用最多花多少积分。超出时免费拒绝，并在返回里给出报价。
Idempotency-Keystring请求头否1 到 255 个可见 ASCII 字符。同一个键加同样的参数会返回第一次的结果，不会重复扣费。

平台与积分

每个平台收的参数不同。平台自己的页面上有完整的参数表、字段表和可以改的请求。

平台价格键积分必填可选每页
TikToktiktok.comments2id、url 里给一个–50
Instagraminstagram.comments2id、url 里给一个–15
Xx.comments2id–60
Redditreddit.comments2id、url 里给一个sort200
YouTubeyoutube.comments2id、url 里给一个sort20
Facebookfacebook.comments2id–10
小红书xiaohongshu.comments12id、url 里给一个–20
抖音douyin.comments2id–20
微博weibo.comments2id–20
公众号wechat.comments12url–20
B 站bilibili.comments2id–20
知乎zhihu.comments2id–20
快手kuaishou.comments2id–40
视频号wechat_channels.comments12id–30

有些平台的这个动作还有另一种取值，由某个参数选中，单独计价：

平台价格键积分由什么选中
TikToktiktok.comments:replies2reply_of
Instagraminstagram.comments:replies2reply_of
YouTubeyoutube.comments:replies2reply_of
小红书xiaohongshu.comments:replies12reply_of
抖音douyin.comments:replies2reply_of
B 站bilibili.comments:replies2reply_of
知乎zhihu.comments:replies2reply_of
快手kuaishou.comments:replies2reply_of

参数

名称类型说明哪些平台收
idstring视频编号，一串数字TikTok、Instagram、X、Reddit、YouTube、Facebook、小红书、抖音、微博、B 站、知乎、快手和视频号
urlstring视频的网页链接TikTok、Instagram、Reddit、YouTube、小红书和公众号
reply_ofstring评论编号，一串数字TikTok、Instagram、YouTube、小红书、抖音、B 站、知乎和快手
sortstring按 Reddit 的默认排序（best）、最新或最高分排取值因平台而异：best、latest、popularReddit和YouTube

示例

TikTok：一条视频下的评论：正文、点赞数、回复数和时间。

curl https://api.socialtoai.com/v1/comments \  -H "Authorization: Bearer $SOCIALTOAI_KEY" \  -H "Content-Type: application/json" \  -d '{    "platform": "tiktok",    "id": "7665840565958872333"  }'
import osimport requestsresponse = requests.post(    "https://api.socialtoai.com/v1/comments",    headers={"Authorization": f"Bearer {os.environ['SOCIALTOAI_KEY']}"},    json={        "platform": "tiktok",        "id": "7665840565958872333",    },)print(response.json())
返回200 OK2 积分
{  "request_id": "req_00000000-0000-4000-8000-000000000001",  "schema_version": "v1",  "fetched_at": "2026-10-12T18:45:47.000Z",  "action": "comments",  "platform": "tiktok",  "status": "ok",  "items": [    {      "platform": "tiktok",      "id": "…",      "ref": "…",      "approx": [],      "type": "comment",      "url": null,      "text": "…",      "published_at": "2026-10-08T14:20:19.000Z",      "author": {        "label": "anonymous_1"      },      "metrics": {        "likes": 1430      },      "reply_count": 37,      "content_id": "…",      "parent_id": null,      "root_id": null    }  ],  "unavailable": ["url"],  "page": {    "has_more": true,    "cursor": "cur_…",    "cursor_expires_at": "2026-10-12T19:15:47.000Z"  },  "warnings": [],  "applied_params": {    "id": "7665840565958872333"  },  "cost_credits": 2,  "billing": {    "cost_credits": 2,    "balance_credits": 98,    "today_spend_credits": 2,    "daily_limit_credits": null,    "daily_remaining_credits": null,    "display": "本次 2 积分，余额 98 积分"  },  "replayed": false}

示例数据：名字、链接和正文已换成占位符。

返回什么

返回外层结构，items 里是 comment 对象。一次调用返回一页，最多 50 条；每一页是一次调用。cursor 最长 30 分钟内有效。

失败的调用是 0 积分，并说明原因，见错误。

最近更新：