价格与运行时
- 当前价格
- 每次运行 25 Credits
- 超时上限
- 最长 1800 秒
- 品牌上下文
- 可选——传入 brand_context_id
价格按真实运行成本校准、可能调整——以创建运行时返回的 credit_cost 为准。
输入参数
以 input 对象传入 POST /api/v1/runs。
| 键 | 类型 | 必填 | 标签与说明 |
|---|---|---|---|
| category_words | long_text | 必填 | 品类词每行填写一个品类词,也可以用英文逗号分隔。 |
| brand_words | long_text | 可选 | 品牌词每行填写一个品牌词,也可以用英文逗号分隔。 |
| subreddits | long_text | 必填 | 目标社区每行填写一个社区,也可以用英文逗号分隔。 |
| date_from | short_text | 必填 | 开始日期分析窗口起始日,格式 YYYY-MM-DD。 |
| date_to | short_text | 必填 | 结束日期分析窗口结束日,格式 YYYY-MM-DD。 |
| max_posts | number | 可选 | 最大帖子数采集帖子上限(1-100,默认 60)。 |
| max_comments_per_post | number | 可选 | 每帖评论上限每帖评论上限(0-20,默认 10)。 |
| interaction_language | select | 可选 | 报告语言控制最终报告的输出语言。可选值:英文, 中文 |
请求示例
示例覆盖全部必填字段,可选字段按同样方式传入。
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": "reddit-hot-post-analysis",
"input": {
"category_words": "example text",
"subreddits": "example text",
"date_from": "example text",
"date_to": "example text"
}
}'返回内容
201 响应返回 run_no、credit_cost、stream_url 与 result_url(相对路径)。从 stream_url 订阅进度,从 result_url 取回终态结果(summary 与 output)。结果在 App 的保留窗口内可取(默认 30 天)。