获取查询建议/Get query suggestions

[中文]

用途:

• 获取广告搜索的热门查询建议
• 了解当前流行的广告搜索关键词和趋势
• 帮助发现新的广告创意方向和热点话题

参数:

• query: 输入关键词(可选)，传入后返回基于该输入的联想建议；不传则返回热门建议
• count: 返回的建议数量，默认50
• scenario: 场景类型，默认1
• country_code: 国家/地区代码，默认US

注意:

• 如果您应用了一个或多个筛选条件后没有返回任何结果，请尝试调整或移除部分筛选条件。TikTok 创作者数据集仅收录部分热门数据，不一定包含全量数据。

返回内容说明:

• query: 查询建议列表（字符串数组）

示例响应:

{
  "code": 200,
  "router": "/api/v1/tiktok/ads/get_query_suggestions",
  "params": {
    "count": "50",
    "scenario": "1"
  },
  "data": {
    "code": 0,
    "msg": "OK",
    "data": {
      "query": [
        "shop now",
        "50% off"
      ]
    }
  }
}

[English]

Purpose:

• Get popular query suggestions for ad search
• Understand current popular ad search keywords and trends
• Help discover new creative directions and hot topics

Parameters:

• query: Input keyword (optional), returns suggestions based on input; popular ones if omitted
• count: Number of suggestions to return, default 50
• scenario: Scenario type, default 1
• country_code: Country code, default US

Note:

• If you've applied one or more filters and there's no result returned, try adjusting or removing some of them. The TikTok Creator dataset only includes a selection of popular records and may not contain the complete set of data.

Return Description:

• query: Query suggestions list (string array)

Example Response:

{
  "code": 200,
  "router": "/api/v1/tiktok/ads/get_query_suggestions",
  "params": {
    "count": "50",
    "scenario": "1"
  },
  "data": {
    "code": 0,
    "msg": "OK",
    "data": {
      "query": [
        "shop now",
        "50% off"
      ]
    }
  }
}

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