套餐
API 总览

品牌上下文

brand-context

调研品牌官网并生成可复用的品牌上下文文档:定位、受众、竞品、语气,以及搜索与 AI 可见性画像。

价格与运行时

当前价格
每次运行 5 Credits
超时上限
最长 1500 秒
品牌上下文
该 App 不支持

价格按真实运行成本校准、可能调整——以创建运行时返回的 credit_cost 为准。

输入参数

以 input 对象传入 POST /api/v1/runs。

键类型必填标签与说明
domainshort_text必填域名只填裸域名,例如 example.com。
report_languageselect必填报告语言控制最终报告的输出语言。可选值:英文, 中文
target_marketslong_text可选目标市场每行填写一个市场,也可以用英文逗号分隔。
languageslong_text可选网站语言每行填写一个语言,也可以用英文逗号分隔。
known_competitorslong_text可选已知竞品每行填写一个竞品域名,也可以用英文逗号分隔。
off_limitslong_text可选禁提内容报告中需要避免的话题、说法或竞品。
extra_noteslong_text可选补充说明关于这个品牌,调研时需要了解的其他背景。

请求示例

示例覆盖全部必填字段,可选字段按同样方式传入。

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": "brand-context",
  "input": {
    "domain": "example text",
    "report_language": "option-id"
  }
}'

返回内容

201 响应返回 run_no、credit_cost、stream_url 与 result_url(相对路径)。从 stream_url 订阅进度,从 result_url 取回终态结果(summary 与 output)。结果在 App 的保留窗口内可取(默认 30 天)。