价格与运行时
- 当前价格
- 每次运行 25 Credits
- 超时上限
- 最长 2400 秒
- 品牌上下文
- 可选——传入 brand_context_id
价格按真实运行成本校准、可能调整——以创建运行时返回的 credit_cost 为准。
输入参数
以 input 对象传入 POST /api/v1/runs。
| 键 | 类型 | 必填 | 标签与说明 |
|---|---|---|---|
| app_identifier | short_text | 必填 | 应用应用名或商店 ID。 |
| platform | select | 可选 | 平台两个商店的排名机制不同。可选值:iOS(App Store), 安卓(Google Play), 双端 |
| category_and_competitors | long_text | 可选 | 品类与竞品品类与最多 5 个竞品应用。 |
| target_markets | short_text | 可选 | 目标市场要优化的商店地区。 |
| current_listing | long_text | 可选 | 当前素材方便的话粘贴标题/副标题/截图文案。 |
| goal | select | 可选 | 目标决定方案侧重。可选值:下载量, 页面转化率, 关键词排名, 评分 |
| baseline_export | long_text | 可选 | 后台基线数据可选的 28 天导出:曝光、浏览、下载、转化、留存。 |
| 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": "aso-growth",
"input": {
"app_identifier": "example text"
}
}'返回内容
201 响应返回 run_no、credit_cost、stream_url 与 result_url(相对路径)。从 stream_url 订阅进度,从 result_url 取回终态结果(summary 与 output)。结果在 App 的保留窗口内可取(默认 30 天)。