套餐
API 总览

客户研究

customer-research

把自有调研资料与社区真实信号,整合成按重要性排序的客户洞察和一手调研计划。

价格与运行时

当前价格
每次运行 25 Credits
超时上限
最长 1500 秒
品牌上下文
可选——传入 brand_context_id

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

输入参数

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

键类型必填标签与说明
product_descriptionshort_text必填产品产品是什么。
research_goalselect可选研究目标决定研究侧重。可选值:问题发现, 客户之声, 赢单丢单分析, ICP 细化
research_questionslong_text可选研究问题你要弄清什么,用想获得回答的问题来描述。
target_audienceshort_text可选目标受众客户是谁。
existing_assetslong_text可选自有材料你自己的访谈记录、问卷导出或评论导出。
online_miningselect可选社区信号挖掘启用后会挖掘公开社区信号。可选值:启用, 停用
interaction_languageselect可选报告语言控制最终报告的输出语言。可选值:英文, 中文

请求示例

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

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": "customer-research",
  "input": {
    "product_description": "example text"
  }
}'

返回内容

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