获取话题推荐搜索/Fetch hashtag suggestions

[中文]

用途:

• 获取抖音 App 中话题(挑战/标签)的推荐搜索结果。
• 根据输入的关键词，返回相关的话题建议列表，包含话题名称、浏览量等信息。

备注:

• 本接口可用于话题联想推荐场景，如输入关键词实时展示相关热门话题。
• 初次请求时 cursor 传入 0，search_id 传空字符串。

参数:

• keyword: 搜索关键词，如 "游戏"

请求体示例：

payload = {
    "keyword": "游戏"
}

返回（部分常用字段，实际返回字段更多，一切以实际响应为准）:

• sug_list[]: 推荐话题列表
  • cha_name: 话题名称（如 "#游戏"）
  • view_count: 话题总浏览量
  • cid: 话题ID
  • group_id: 话题关联的群组ID（可以用于跳转）
  • tag: 话题标签分类（0=普通话题，1=流量风向标）
• status_code: 状态码（0=成功）
• status_msg: 状态信息（通常为空）
• rid: 请求ID
• words_query_record:
  • info: 额外信息（目前为空）
  • words_source: 关键词来源（固定"sug"）
  • query_id: 查询ID（通常为空）
• extra:
  • now: 当前服务器时间戳
  • logid: 日志ID
  • fatal_item_ids: 错误项目ID列表（通常为空）
  • search_request_id: 搜索请求ID（通常为空）
• log_pb:
  • impr_id: 曝光ID（日志追踪用）

[English]

Purpose:

• Fetch hashtag/challenge suggestions from Douyin App based on the input keyword.
• Returns a list of related hashtags including name and view count.

Notes:

• Suitable for implementing keyword suggestion features in search bars.
• Set cursor to 0 and search_id to an empty string for the first request.

Parameters:

• keyword: Search keyword, e.g., "game"

Request Body Example:

payload = {
    "keyword": "game"
}

Response (common fields, actual response may contain more fields):

• sug_list[]: List of suggested hashtags
  • cha_name: Hashtag name (e.g., "#game")
  • view_count: Total view count
  • cid: Challenge ID
  • group_id: Associated group ID
  • tag: Tag category (0=normal, 1=hot trend)
• status_code: Status code (0=success)
• status_msg: Status message (usually empty)
• rid: Request ID
• words_query_record:
  • info: Additional info (currently empty)
  • words_source: Words source ("sug")
  • query_id: Query ID (usually empty)
• extra:
  • now: Server timestamp
  • logid: Log ID
  • fatal_item_ids: List of fatal item IDs (usually empty)
  • search_request_id: Search request ID (usually empty)
• log_pb:
  • impr_id: Impression ID (for logging)

Imported from a validated TikHub OpenAPI document. Pricing must be reviewed before enabling.