抖音获取多关键词热度趋势

# 工具说明：抖音获取多关键词热度趋势 ## 1. 工具简介 **工具名称**：抖音每日趋势搜索关键词 **功能描述**：输入一个关键词，查询该关键词在抖音平台最近 7 日的热度趋势数据。 该工具会自动以 **UTC+8 中国时区** 计算日期范围，查询包含当天在内的最近 7 个自然日数据，并返回 TikHub 抖音关键词热度趋势接口的原始业务结果。 --- ## 2. 适用场景 该工具适合用于以下场景： ### 2.1 内容选题分析 用于判断某个话题、产品、人物、事件或行业关键词在抖音上的近期热度变化。 示例： ```json { "keyword": "人工智能" } ``` 可用于判断“人工智能”在最近 7 天是否持续升温。 --- ### 2.2 短视频运营决策 适合短视频运营人员在发布内容前，评估关键词热度趋势，例如： - 美妆新品 - 旅游目的地 - 热门影视剧 - 节日活动 - 社会热点 - 品牌名称 --- ### 2.3 品牌与竞品监测 可用于监测品牌词或竞品词在抖音上的近期热度变化。 示例关键词： - 某品牌名称 - 某产品型号 - 竞品品牌 - 活动名称 --- ### 2.4 热点追踪与趋势判断 适合用于追踪突发热点、娱乐事件、社会话题等在抖音上的传播热度。 --- ### 2.5 数据分析与报表生成 可作为数据分析流程中的一个数据源，用于生成： - 抖音关键词趋势报告 - 周度热点分析 - 内容选题推荐 - 品牌声量趋势图 --- ## 3. 输入参数说明 ### 请求格式 ```json { "keyword": "人工智能" } ``` ### 参数说明 | 参数名 | 类型 | 是否必填 | 说明 | |---|---|---|---| | keyword | string | 是 | 需要查询抖音热度趋势的关键词 | ### 参数限制 | 限制项 | 说明 | |---|---| | 最小长度 | 1 个字符 | | 最大长度 | 100 个字符 | | 是否支持多个关键词 | 当前工具一次只接收一个关键词 | | 是否允许空字符串 | 不允许 | | 是否允许额外参数 | 不允许 | --- ## 4. 输出结果说明 ### 成功返回格式 ```json { "success": true, "status_code": 200, "keyword": "人工智能", "data": {}, "error": null } ``` ### 字段说明 | 字段名 | 类型 | 说明 | |---|---|---| | success | boolean | 是否调用成功。只有 HTTP 状态和业务状态均成功时才为 `true` | | status_code | integer | 上游 HTTP 状态码或工具生成的标准化状态码 | | keyword | string / null | 规范化后的查询关键词 | | data | any | TikHub 返回的原始热度趋势数据，失败时为 `null` | | error | object / null | 错误信息，成功时为 `null` | --- ## 5. 错误返回格式 当调用失败时，返回格式如下： ```json { "success": false, "status_code": 400, "keyword": null, "data": null, "error": { "code": "INVALID_KEYWORD", "message": "keyword 必须是非空字符串。" } } ``` ### 常见错误代码 | 错误代码 | 说明 | |---|---| | INVALID_INPUT | 输入 payload 不是合法 JSON 对象 | | INVALID_KEYWORD | keyword 为空或不是字符串 | | CREDENTIAL_BINDING_MISSING | 托管 API 凭据未正确绑定或已失效 | | PROXY_UPSTREAM_TIMEOUT | 上游接口请求超时 | | PROXY_RATE_LIMIT | 触发限流 | | PROXY_REQUEST_FAILED | 调用托管 API 失败 | | INVALID_PROXY_RESPONSE | 托管代理响应异常 | | UPSTREAM_METHOD_NOT_ALLOWED | 上游接口拒绝请求方法 | | UPSTREAM_HTTP_ERROR | 上游接口返回非 2xx HTTP 状态 | | UPSTREAM_API_ERROR | 上游业务接口返回失败 | | EMPTY_UPSTREAM_RESPONSE | 上游接口返回空响应 | --- ## 6. 使用步骤 ### 步骤 1：准备关键词 确定需要查询的抖音趋势关键词，例如： - 人工智能 - 低空经济 - 哈尔滨旅游 - 防晒霜 - 新能源汽车 --- ### 步骤 2：构造请求参数 请求体只需要传入一个字段：`keyword`。 示例： ```json { "keyword": "人工智能" } ``` --- ### 步骤 3：调用工具 将上述 JSON 作为工具输入调用。 工具会自动完成以下操作： 1. 校验 `keyword` 是否为非空字符串。 2. 去除关键词前后的空格。 3. 自动计算最近 7 日日期范围。 4. 调用 TikHub 抖音趋势接口。 5. 判断 HTTP 状态和业务状态。 6. 返回趋势数据或标准化错误信息。 --- ### 步骤 4：读取返回结果 如果返回： ```json { "success": true } ``` 表示调用成功，可从 `data` 字段中读取趋势结果。 如果返回： ```json { "success": false } ``` 表示调用失败，应查看： ```json error.code error.message error.details ``` 以判断失败原因。 --- ## 7. 使用示例 ### 示例 1：查询“人工智能”的抖音趋势 #### 输入 ```json { "keyword": "人工智能" } ``` #### 成功输出示例 ```json { "success": true, "status_code": 200, "keyword": "人工智能", "data": { "示例": "此处为 TikHub 返回的原始趋势数据" }, "error": null } ``` --- ### 示例 2：关键词为空 #### 输入 ```json { "keyword": "" } ``` #### 输出 ```json { "success": false, "status_code": 400, "keyword": null, "data": null, "error": { "code": "INVALID_KEYWORD", "message": "keyword 必须是非空字符串。" } } ``` --- ## 8. 工具限制 ### 8.1 仅支持单关键词查询 虽然上游接口名称中包含 `multi_keyword`，但当前封装工具一次只接收一个关键词。 不支持如下输入： ```json { "keyword": ["人工智能", "新能源汽车"] } ``` 也不建议在一个字符串中拼接多个关键词。 --- ### 8.2 仅查询最近 7 日 工具会自动查询 **包含当天在内的最近 7 日数据**，暂不支持自定义开始日期和结束日期。 --- ### 8.3 数据依赖上游接口 返回数据来自 TikHub 抖音接口，可能受以下因素影响： - 上游接口可用性 - 抖音数据更新频率 - 上游数据统计口径 - 接口限流 - 凭据状态 - 网络超时 --- ### 8.4 返回的 `data` 为原始业务数据 工具不会对 TikHub 返回的 `data` 做深度清洗、格式转换或趋势解读。 如果需要生成趋势结论，需要调用方自行解析 `data` 内容。 --- ### 8.5 不保证实时性 该工具查询的是上游可提供的趋势数据，实际数据可能存在一定延迟。 --- ## 9. 成功判断规则 工具只有在同时满足以下条件时，才会返回： ```json "success": true ``` 具体条件包括： 1. 托管代理返回有效 HTTP 状态码。 2. HTTP 状态码为 2xx。 3. 上游响应不为空。 4. 上游业务字段未显示失败。 5. 上游业务状态码不是失败状态。 如果 HTTP 成功但上游业务失败，工具仍会返回： ```json "success": false ``` 并将错误代码标记为： ```json "UPSTREAM_API_ERROR" ``` --- ## 10. 推荐使用方式 ### 查询前 - 使用明确、简短的关键词。 - 避免输入过长句子。 - 避免输入多个关键词。 - 尽量使用大众常用表达，而不是生僻词。 ### 查询后 建议结合返回数据进行： - 热度上升或下降判断 - 峰值日期识别 - 内容发布时间规划 - 关键词对比分析 - 热点生命周期判断 --- ## 11. 简要调用模板 ```json { "keyword": "你的关键词" } ``` 例如： ```json { "keyword": "新能源汽车" } ``` 返回结果中： - `success: true`：查看 `data` - `success: false`：查看 `error.code` 和 `error.message`

{
  "type": "object",
  "title": "抖音关键词热度趋势请求",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "keyword"
  ],
  "properties": {
    "days": {
      "type": "integer",
      "title": "近 X 天",
      "default": 3,
      "maximum": 30,
      "minimum": 1,
      "description": "查询包含当天在内的连续自然日数量，默认值为 3。"
    },
    "keyword": {
      "type": "string",
      "title": "搜索关键词",
      "maxLength": 100,
      "minLength": 1,
      "description": "需要查询的单个抖音关键词，例如华为。"
    }
  },
  "description": "输入一个关键词和查询天数，查询近 X 个 UTC+8 自然日的抖音热度趋势。",
  "additionalProperties": false
}

{
  "type": "object",
  "title": "抖音关键词热度趋势响应",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "success",
    "status_code",
    "keyword",
    "days",
    "data",
    "error"
  ],
  "properties": {
    "data": {
      "title": "上游原始数据"
    },
    "days": {
      "type": "integer",
      "title": "查询天数"
    },
    "error": {
      "title": "错误信息"
    },
    "keyword": {
      "type": "string",
      "title": "查询关键词"
    },
    "success": {
      "type": "boolean",
      "title": "是否成功"
    },
    "status_code": {
      "type": "integer",
      "title": "状态码"
    }
  },
  "description": "返回上游原始响应或标准化错误信息。动态字段保持宽松以兼容上游结构。",
  "additionalProperties": false
}