价格与运行时
- 当前价格
- 每次运行 25 Credits
- 超时上限
- 最长 1800 秒
- 品牌上下文
- 可选——传入 brand_context_id
价格按真实运行成本校准、可能调整——以创建运行时返回的 credit_cost 为准。
输入参数
以 input 对象传入 POST /api/v1/runs。
| 键 | 类型 | 必填 | 标签与说明 |
|---|---|---|---|
| brand_words | long_text | 必填 | 品牌词每行填写一个品牌词，也可以用英文逗号分隔。 |
| category_words | long_text | 可选 | 品类词每行填写一个品类词，也可以用英文逗号分隔。 |
| competitor_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，默认 50）。 |
| max_comments_per_post | number | 可选 | 每帖评论上限每帖评论上限（0-20，默认 5）。评论也是提及。 |
| 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-mention-report",
"input": {
"brand_words": "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 天）。