价格与运行时
- 当前价格
- 每次运行 11 Credits
- 超时上限
- 最长 600 秒
- 品牌上下文
- 可选——传入 brand_context_id
价格按真实运行成本校准、可能调整——以创建运行时返回的 credit_cost 为准。
输入参数
以 input 对象传入 POST /api/v1/runs。
| 键 | 类型 | 必填 | 标签与说明 |
|---|---|---|---|
| domain | short_text | 必填 | 域名只填裸域名，例如 example.com。 |
| keywords | long_text | 可选 | 关键词每行填写一个关键词，也可以用英文逗号分隔。 |
| ai_queries | long_text | 可选 | AI 查询每行填写一个AI 查询，也可以用英文逗号分隔。 |
| market | short_text | 可选 | 市场搜索数据对应的国家或地区，请填英文国家名。 |
| language | short_text | 可选 | 语言排名数据的搜索语言。 |
| previous_snapshot | long_text | 可选 | 上次快照 JSON可选。粘贴上一次排名快照运行的 data 内容，即可获得对比。 |
请求示例
示例覆盖全部必填字段，可选字段按同样方式传入。
curl -X POST https://api.TODO-APP-DOMAIN/api/v1/runs \
-H "Authorization: Bearer $SUPAMARKETERS_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"app_slug": "rank-snapshot",
"input": {
"domain": "example text"
}
}'返回内容
201 响应返回 run_no、credit_cost、stream_url 与 result_url（相对路径）。从 stream_url 订阅进度，从 result_url 取回终态结果（summary 与 output）。结果在 App 的保留窗口内可取（默认 30 天）。