账号监测(account_watch)
POST /v1/tools/account_watch 运行账号监测:一个现成工具,返回一批账号最近发了什么,哪条明显比平时好。目前可读 15 个平台,9 积分起。带上 max_cost_credits,超出时会被免费拒绝,并返回报价。什么都没取到,不扣。
POST
https://api.socialtoai.com/v1/tools/account_watch想在网站上填写,或看看结果长什么样,打开账号监测。
请求
请求体是 JSON,放这个工具自己的输入。Key 和其他调用一样,放在 Authorization 请求头里。
| 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|
accounts | string[] | 是 | 1 到 20 个账号主页链接,可以混平台。 |
window | string | 否 | 看最近多久的新内容。取值:7d、30d(默认 7d). |
scale | string | 否 | 每个账号:small 约 20 条作品,medium 约 60 条,large 在 medium 之上加 2 条起量作品的评论。取值:small、medium、large(默认 small). |
max_cost_credits | integer | 否 | 这次最多花多少积分;超出则免费拒绝并返回报价。 |
confirm | boolean | 否 | true:不论多少积分都直接运行。false:只返回计划和报价,不运行。不填:价格高的和要在后台运行的先返回报价,其余直接运行。 |
curl https://api.socialtoai.com/v1/tools/account_watch \ -H "Authorization: Bearer $SOCIALTOAI_KEY" \ -H "Content-Type: application/json" \ -d '{ "accounts": ["https://x.com/NASA"], "window": "7d", "scale": "small" }'import osimport requestsresponse = requests.post( "https://api.socialtoai.com/v1/tools/account_watch", headers={"Authorization": f"Bearer {os.environ['SOCIALTOAI_KEY']}"}, json={ "accounts": ["https://x.com/NASA"], "window": "7d", "scale": "small", },)print(response.json())档位与积分
scale 选档位。同一档位在每个平台上是一个固定价格,运行前就会给出。
| 档位 | scale | 读多少 | 几积分起 | 怎么运行 | 用赠送的 100 积分 |
|---|---|---|---|---|---|
| 小 | small | 每个账号约 20 条作品。 | 9 | 当场出结果 | 可以 |
| 中 | medium | 每个账号约 60 条作品。 | 12 | 当场出结果 | 可以 |
| 大 | large | 每个账号约 60 条作品,另读 2 条起量作品的评论。 | 22 | 当场出结果 | 部分平台可以(10/12) |
各平台的积分
下表是一个账号的积分。给了多条链接时,以报价里的总价为准。
| 平台 | 小 | 中 | 大 |
|---|---|---|---|
| TikTok | 12 | 20 | 36 |
| 12 | 18 | 28 | |
| X | 9 | 13 | 29 |
| 10 | 14 | 24 | |
| 12 | 20 | 30 | |
| 12 | 20 | — | |
| Threads | 12 | 16 | — |
| Telegram | 10 | 14 | — |
| 小红书 | 30 | 54 | 84 |
| 抖音 | 10 | 14 | 24 |
| 公众号 | 42 | 90 | 120 |
| B 站 | 10 | 12 | 22 |
| 知乎 | 10 | 14 | 24 |
| 快手 | 30 | 54 | 70 |
| 视频号 | 42 | 66 | 96 |
结果里有什么
| 部分 | 内容 |
|---|---|
| 各账号的新内容 | 每个账号在时间范围内发了什么,带每条的数据。 |
| 起量的作品 | 明显好于这个账号平时水平的作品,以及好多少。 |
| 主要数字 | 起量作品数 |
先报价还是直接运行:confirm
同一个请求,要么直接运行,要么先返回报价。和工具输入放在一起的布尔参数 confirm 决定走哪一种:
| confirm | 返回什么 |
|---|---|
false | 总是返回报价。免费:不占用、不取数、不扣积分。 |
| 不带 | 价格不超过 100 积分、并且能在这次请求里答完时,直接运行。超过这个数,或者计划要在后台运行(quote.mode 是 background)时,先返回报价。 |
true | 直接运行,最多扣报价里写的积分。跑不了的运行会被免费拒绝(not_supported),不会用一份你没要的报价来代替。 |
运行的返回里带一个 handle:24 小时内可以凭它免费重读完整结果,细节见结果与句柄。带着同一个 Idempotency-Key 再发同样的请求,返回的是第一次运行的结果,不再扣费。
报价
报价是这一次请求的完整计划,以及运行它最多扣多少。报价本身不占用、不取数、不扣积分,status 是 quote。
| 字段 | 类型 | 说明 |
|---|---|---|
request_id | string | 这次请求的编号。 |
schema_version | "v1" | 返回格式的版本。 |
tool | string | 报价对应的工具。 |
scale | "small" | "medium" | "large" | null | 报价对应的档位;按行计价的工具为 null。 |
status | "quote" | quote:没有占用、没有取数、没有扣积分。 |
quote.credits | integer | 这次运行最多扣多少积分。 |
quote.parts.data_first | integer | 取数价格的前半段。 |
quote.parts.data_second | integer | 取数价格的后半段。读到的不到计划的一半时不扣。 |
quote.parts.analysis | integer | AI 分析的价格。交付的内容里至少九成分析成功才扣。 |
quote.mode | "sync" | "background" | sync:在这次请求里返回结果。background:先返回句柄,在后台分批运行。 |
quote.waves | integer | 后台运行分几波;在请求里直接返回的为 1。 |
quote.estimated_seconds | integer | 预计耗时(秒)。 |
quote.free_tier.runnable | boolean | 还没买过积分的账户能不能跑。 |
quote.free_tier.reasons | string[] | 不能跑时的原因:cost、duration 或 paid_only。 |
quote.plan | array | 按运行顺序列出每一步:平台、动作、多少个目标和多少页,或多少批分析,以及这一步的积分。 |
quote.price_version | string | 报价所依据的价格版本。 |
billing | object | 和每个返回里的一样,见积分与计费。 |
运行怎么扣费
- 先看到价格:运行前就给出总价,内容再多也不会涨。
- 什么都没取到,不扣:什么都没取到,这次不扣积分。中途停下,只按完成的部分扣。
- 每档一个价:同一档位在同一平台价格固定,内容比预想的少也不会减。先用小档,需要读得更多再加。
- 什么都没取到,不扣。取到了内容但被你设的条件筛光,只扣取数的前半段。中途停下只按完成的部分扣。
- 工具会用读到的部分继续跑,结果里写明读到了计划的多少。价格分三段:两段取数,一段 AI 分析。读到的不到计划的一半时,取数的后半段不扣;交付的内容里至少九成分析成功,分析那一段才扣。结果不确定的调用,我们不会自动重试。
通过 MCP
MCP 工具是 account_watch。输入和积分都一样。工具列表 里有你的 AI 拿到的描述。
最近更新: