获取推荐搜索关键词

您可以使用本接口获取搜索广告推广系列可用的推荐搜索关键词列表，以及关键词对应的预测月搜索量。

请求

地址 https://business-api.tiktok.com/open_api/v1.3/tool/search_keyword/recommend/

方法 GET

Header

|字段{30%}|类型{15%}|描述{55%}|
|---|---|---|
|Access-Token {必填}|string|授权访问令牌。<br>可以通过[获取访问令牌](1738373164380162.html)接口获取。|

参数

|字段{30%}|类型{15%}|描述{55%}|
|---|---|---|
|advertiser_id {必填}|string|广告主 ID。|
|search_queries  {+条件必填}|string[]| 需要根据搜索词获取推荐的搜索关键词时，本字段必填。<br>仅支持指定`search_queries`、`ad_ids`和`landing_page_urls` 中的其中一个字段。<br><br>搜索词列表。<br><br>您可以指定商品、服务或品牌名称作为搜索词。<br><br>最大数量：5。<br>每个搜索词的长度限制：80 个字符。<br><br><ul><li>仅支持英文单词。</li><li>不支持表情符号以及特殊字符（例如 #）。</li></ul> |
| ad_ids {+条件必填} | string[] | 需要根据特定广告获取推荐的搜索关键词时，本字段必填。<br>仅支持指定`search_queries`、`ad_ids`和`landing_page_urls` 中的其中一个字段。<br><br>广告 ID 列表。<br><br>最大数量：1。<br><br><br><p><span style="color:darkred"><b>注意</b></span>: 基于特定广告获取推荐搜索关键词的功能目前为白名单功能。如需使用此功能，请联系您的 TikTok 销售代表。 |
| landing_page_urls {+条件必填} | string[] | 需要根据 URL 获取推荐的搜索关键词时，本字段必填。<br>仅支持指定`search_queries`、`ad_ids`和`landing_page_urls` 中的其中一个字段。<br><br>落地页 URL 列表。<br><br>最大数量：5。<br>单个 URL 的长度不受限制。<br><br><br><p><span style="color:darkred"><b>注意</b></span>: 基于 URL 获取推荐搜索关键词目前为白名单功能。如需使用此功能，请联系您的 TikTok 销售代表。 |
|regions {必填}|string[]|国家或地区代码列表。<br><br>目前，仅支持值 `US`。|
|order_field|string|排序逻辑。<br><br>枚举值：<ul><li>`RELEVANCE`：按照相关性排序。</li><li>`MONTHLY_SEARCHES`：按照返回参数 `monthly_searches` 的值排序。</li></ul><br>指定了`search_queries`时的默认值：`RELEVANCE`。<br><br><br><p><span style="color:darkred"><b>注意</b></span>: 若指定了 `ad_ids` 或 `landing_page_urls`，仅支持将本字段设置为 `MONTHLY_SEARCHES`。 |
|order_type|string|仅当 `order_field` 为 `MONTHLY_SEARCHES` 时生效。<br><br>排序顺序。<br><br>枚举值：<ul><li>`ASC`：升序。</li><li>`DESC`：降序。</li></ul><br>默认值：`DESC`。<br><br><p><span style="color:darkred"><b>注意</b></span>: 若指定了 `ad_ids` 或 `landing_page_urls`，仅支持将本字段设置为 `DESC`。 |
|total_size|number|要返回的推荐关键词的数量。<br><br>取值范围：1-1,000。<br>默认值：1,000。|
|page|number|当前页数。<br><br>取值范围：≥1。<br>默认值： 1。|
|page_size|number|分页大小。<br><br>取值范围：1-1,000。<br>默认值：50。|

示例

(code curl http)
curl --location --request GET 'https://business-api.tiktok.com/open_api/v1.3/tool/search_keyword/recommend/?advertiser_id={{advertiser_id}}&search_queries=["TikTok"]&regions=["US"]&order_field=MONTHLY_SEARCHES&order_type=DESC' \
--header 'Access-Token: {{Access-Token}}'
(/code)

|字段{30%}|类型{15%}|描述{55%}|
|---|---|---|
|code |number| 返回码。完整返回码列表及描述，参见[附录 - 返回码](https://ads.tiktok.com/marketing_api/docs?id=1737172488964097)。|
|message |string| 返回信息。更多信息参见[附录 - 返回码](https://ads.tiktok.com/marketing_api/docs?id=1737172488964097)。 |
|request_id |string| 请求的日志 ID，唯一标识一个请求。 |
|data |object| 返回数据。 |
#|recommended_keywords|object[]|推荐的搜索关键词列表。|
##|recommended_keyword|string|推荐的搜索关键词。|
##|monthly_searches|integer|预测月搜索量。<br>预测以历史数据为基础，仅供参考。|
#|page_info|object|分页信息。|
##|page|number|当前页数。|
##|page_size|number|分页大小。|
##|total_number|number|总结果数。|
##|total_page|number|总页数。|

示例

(code Success-Response http)
HTTPS/1.1 200 OK
{
    "code": 0,
    "message": "OK",
    "request_id": "{{request_id}}",
    "data": {
        "page_info": {
            "page": 1,
            "page_size": 50,
            "total_number": 897,
            "total_page": 18
        },
        "recommended_keywords": [
            {
                "monthly_searches": 22063,
                "recommended_keyword": "messytiktok"
            },
            ...
            {
                "monthly_searches": 9747,
                "recommended_keyword": "funny relatable tiktoks"
            }
        ]
    }
}
(/code)