核心接口
微博评论 API
微博评论接口(comments):每次成功调用 0.2 credits,支持 HTTP 与 Remote MCP,输入、数据来源和计费规则清晰。
01 / 核心接口
一次请求
成功或空结果每次 0.2 credits,失败不计费。
把 PASTE_PUBLIC 占位符换成受支持的公开标识。这是请求模板,不会自动执行。
请求模板
curl --request POST 'https://api.socialtoai.com/v1/comments' \
--header "X-API-Key: $SOCIALTOAI_API_KEY" \
--header 'Content-Type: application/json' \
--header 'Idempotency-Key: REPLACE_WITH_A_UNIQUE_REQUEST_ID' \
--data '{"platform":"weibo","url_or_id":"PASTE_PUBLIC_ITEM_URL_OR_ID"}'02 / 核心接口
原生支持
结果类型:item。翻页:使用返回的不透明 cursor。
回复分支:支持。
以上取值来自参考卡。用户查找或特定内容类型可能还有额外限制。请以响应里的 applied_params 和 warnings 为准,不要假定不支持的筛选已生效。
03 / 核心接口
经过结构校验的示例
示意结果,只含一条虚构数据和示例试用余额,用来展示响应结构,不是实时结果,也不代表线上可用率。
示意 JSON · 非实时
{
"request_id": "example_only_not_a_live_call",
"schema_version": "v1",
"fetched_at": "2026-09-05T00:00:00Z",
"status": "ok",
"applied_params": {},
"warnings": [],
"items": [
{
"kind": "item",
"id": "EXAMPLE_ITEM_ID",
"author": {
"name": "example_author"
},
"published_at": "2026-09-01T08:30:00Z",
"metrics": {
"likes": 412,
"comments": 96
},
"text": "Illustrative comment, not real content."
}
],
"platform": "weibo",
"billing": {
"cost": 0.2,
"balance": 1.8,
"unit": "credits",
"pricing": "standard"
}
}04 / 核心接口
平台限制
不支持的热度排序回退为综合排序;文字类型回退为全部。图片或视频搜索无法单独应用非综合排序。
源端不提供翻页信号时,搜索可能一直翻到空页为止。请查看 warnings 并设置翻页预算。
热搜不含置顶条目,返回原生排名 1–50。
内容请使用数字微博 ID 或标准微博链接;账号请使用数字 UID 或标准主页链接。
常见问题
这个调用多少钱?
成功或空结果每次 0.2 credits,失败不扣费。
可以翻页吗?
只使用返回的不透明 cursor,并保持平台和查询不变。请检查 has_more 和剩余预算。
平台的所有功能都覆盖了吗?
不支持的热度排序回退为综合排序;文字类型回退为全部。图片或视频搜索无法单独应用非综合排序。源端不提供翻页信号时,搜索可能一直翻到空页为止。请查看 warnings 并设置翻页预算。热搜不含置顶条目,返回原生排名 1–50。内容请使用数字微博 ID 或标准微博链接;账号请使用数字 UID 或标准主页链接。