发现新关键词
此接口可用于发现新关键词并探索关键词建议，触达对你的业务感兴趣的用户。
请求
地址 https://business-api.tiktok.com/open_api/v1.3/tool/search_keyword/keyword_idea/
方法 GET
Header
|字段{30%}|类型{15%}|描述{55%}|
|---|---|---|
|Access-Token {必填}|string|授权访问令牌。可以通过[获取访问令牌](1738373164380162.html)接口获取。|
参数
|字段{30%}|类型{15%}|描述{55%}|
|---|---|---|
|advertiser_id {必填}|string|广告主 ID。|
|keywords {必填}|string[]|关键词列表。<br>你可以传入与你的业务密切相关的商品或服务。<br><br>最大数量：10。<br>每个关键词的长度限制：80 个字符。<br><br><ul><li>仅支持英文单词。</li><li>不支持表情符号和特殊符号（例如 #）。</li></ul><br><p><span style="color:darkred"><b>注意</b></span>：为获得最佳成效，输入小写字母的关键词。不建议输入大写字母的关键词。|
|order_field|string|排序逻辑。<br><br>枚举值：<ul><li>`AVG_MONTHLY_SEARCHES`：按月均搜索量范围（由返回参数 `avg_monthly_searches_lower` 和 `avg_monthly_searches_upper` 定义）对结果进行排序。</li><li>`THREE_MONTH_CHANGE`：按返回参数 `three_month_change` 对结果进行排序。</li><li>`YEAR_OVER_YEAR_CHANGE`：按返回参数 `year_over_year_change` 对结果进行排序。</li><li>`COMPETITION`：按返回参数 `competition` 对结果进行排序。</li></ul>默认值：`AVG_MONTHLY_SEARCHES`。|
|order_type|string|排序的顺序。<br><br>枚举值：<ul><li>`ASC`：升序。</li><li>`DESC`：降序。</li></ul>默认值：`DESC`。|
|brand_type|string|品牌类型。<br><br>枚举值：<ul><li>`BRAND`：品牌。</li><li>`NON_BRAND`：非品牌。</li><li>`ALL`：全部。</li></ul>默认值：`ALL`。<br><br><p><span style="color:darkred"><b>注意</b></span>：此筛选条件仅在 `country_codes` 设置为 `["US"]` 时可用。对于其他国家或地区，`ALL` 为默认值和唯一允许的值。</p>|
|country_codes|string[]|定向国家/地区的地域代码。<br><br>最大数量：1。<br><br>默认值：`US`。<br>枚举值参见 <a href="#item-link-country_codes 值列表">`country_codes` 值列表</a>。<br><br><p><span style="color:darkred"><b>注意</b></span>：在你所在国家/地区以外且受支持的非美国地区发现新关键词目前为白名单功能。如需使用此功能，请联系你的 TikTok 销售代表。</p>|
country_codes 值列表
|<code>country_codes</code> 值{30%}|描述{70%}|
|---|---|
|`AU`|澳大利亚|
|`BR`|巴西|
|`CA`|加拿大|
|`FR`|法国|
|`DE`|德国|
|`IT`|意大利|
|`MX`|墨西哥|
|`SA`|沙特阿拉伯|
|`ES`|西班牙|
|`AE`|阿拉伯联合酋长国|
|`GB`|英国|
|`US`|美国|
示例
(code curl http)
curl --location --request GET 'https://business-api.tiktok.com/open_api/v1.3/tool/search_keyword/keyword_idea/?advertiser_id={{advertiser_id}}&keywords=["{{keyword}}","{{keyword}}"]&order_field=AVG_MONTHLY_SEARCHES&order_type=DESC&brand_type=ALL&country_codes=["US"]' \
--header 'Access-Token: {{Access-Token}}'
(/code)
返回
|字段{30%}|类型{15%}|描述{55%}|
|---|---|---|
|code|number|返回码。完整返回码列表及描述参见[附录 - 返回码](1737172488964097.html)。|
|message|string|返回信息。更多信息参见[附录 - 返回码](1737172488964097.html)。|
|request_id|string|请求的日志 ID，唯一标识一个请求。|
|data|object|返回数据。|
#|total_search_volume_lower|number|所有建议关键词 (`keywords`) 的最低总搜索量。|
#|total_search_volume_upper|number|所有建议关键词 (`keywords`) 的最高总搜索量。|
#|keywords|object[]|基于传入的定向国家或地区 (`country_codes`)、与传入的一个或多个关键词相关的建议关键词列表。|
##|recommended_keyword|string|关键词。<br><br>与传入的一个或多个关键词相关的建议关键词。|
##|avg_monthly_searches_lower|number|月均搜索量（最低）。<br><br>根据传入的定向国家或地区，近 1 个月内某个关键词及其类似词的最低月均搜索量。|
##|avg_monthly_searches_upper|number|月均搜索量（最高）。<br><br>根据传入的定向国家或地区，近 1 个月内某个关键词及其类似词的最高月均搜索量。|
##|three_month_change|float|近 3 个月变化。<br><br>将近 1 个月的月搜索量与 2 个月前的月搜索量进行对比，得出此数据。|
##|year_over_year_change|float|同比变化。<br><br>将上月的月搜索量与去年同月的月搜索量进行对比，得出此数据。|
##|competition|string|竞争程度。<br><br>根据上月对某个关键词出价的去重广告主数量，表示该关键词的广告位竞争程度。<br><br>枚举值： <ul><li>`HIGH`：高。</li><li>`MEDIUM`：中。</li><li>`LOW`：低。</li></ul>|
##|estimated_cpc_lower|float|预估 CPC（最低），单位：USD。<br><br>上月广告主将该关键词投放在传入的定向国家/地区的搜索页面首个广告位所支付的最低 CPC。具体的关键词 CPC 可能因实际情况而异。|
##|estimated_cpc_upper|float|预估 CPC（最高），单位：USD。<br><br>上月广告主将该关键词投放在传入的定向国家/地区的搜索页面首个广告位所支付的最高 CPC。具体的关键词 CPC 可能因实际情况而异。|
示例
(code Success-Response http)
HTTPS/1.1 200 OK
{
"code": 0,
"message": "OK",
"request_id": "{{request_id}}",
"data": {
"keywords": [
{
"avg_monthly_searches_lower": 500000,
"avg_monthly_searches_upper": 1000000,
"competition": "HIGH",
"estimated_cpc_lower": 0.5062341041327454,
"estimated_cpc_upper": 0.6947784896270967,
"recommended_keyword": "shoes",
"three_month_change": -0.3566219295724846,
"year_over_year_change": -0.9556371579502115
},
{
"avg_monthly_searches_lower": 100000,
"avg_monthly_searches_upper": 250000,
"competition": "HIGH",
"estimated_cpc_lower": 0.6854101014434859,
"estimated_cpc_upper": 0.8316111534680811,
"recommended_keyword": "bear claw shoes",
"three_month_change": -0.000005560127215710696,
"year_over_year_change": 0.00040605635839757926
},
...
{
"avg_monthly_searches_lower": 1000,
"avg_monthly_searches_upper": 5000,
"competition": "MEDIUM",
"estimated_cpc_lower": 0,
"estimated_cpc_upper": 0,
"recommended_keyword": "mid dunks",
"three_month_change": -0.9375,
"year_over_year_change": -0.9999778408083673
},
{
"avg_monthly_searches_lower": 1000,
"avg_monthly_searches_upper": 5000,
"competition": "HIGH",
"estimated_cpc_lower": 0.0375,
"estimated_cpc_upper": 0.07250000000000001,
"recommended_keyword": "midnight ballerina shoes",
"three_month_change": -0.7937971500419112,
"year_over_year_change": -0.7861799217731421
}
],
"total_search_volume_lower": 2500000,
"total_search_volume_upper": 5000000
}
}
(/code)