关键词研究

keyword-research

把种子主题扩展成带搜索量、意图和难度信号的聚类关键词清单。

价格与运行时

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

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

输入参数

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

键	类型	必填	标签与说明
seed_topics	long_text	必填	种子主题每行填写一个主题，也可以用英文逗号分隔。
market	short_text	可选	市场关键词数据对应的国家或地区，请填英文国家名。
language	short_text	可选	语言关键词数据的搜索语言。
max_keywords	number	可选	最大关键词数

请求示例

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

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

返回内容

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