搜索其他兴趣分类
您可以使用本接口搜索其他兴趣分类。你需要传入一个或多个种子关键词，系统会对该种子关键词进行匹配，然后获取一组相关的其他兴趣分类。
返回中 status 为 EFFECTIVE 的其他兴趣分类（keyword_id）可在调用 /adgroup/create/ 创建广告组时传入 interest_keyword_ids 字段。指定的其他兴趣分类将在广告组中用于定向受众。
注意
推荐您使用兴趣和行为合并 API（/targeting/search/）搜索或列举和兴趣与行为相关的定向分类和话题标签。此接口可高效获取并整合必要的定向信息。
v1.2与v1.3版本对比
以下表格概括了 v1.2与v1.3接口的变化。
``xtable
|变化内容{23%}|v1.2{40%}|v1.3{37%}|
|---|---|---|
|接口路径|/v1.2/tools/interest_keyword/recommend/|/v1.3/tool/interest_keyword/recommend/|
|请求参数类型 |advertiser_id: number|advertiser_id: string|
|请求参数名称和类型 |keywords: string[]|keyword: string|
|新增请求参数 |/ |audience_type<br>keywords|
|返回参数名称和类型 |id: number|keyword_id: string |
|新增返回参数 |/ |input_keyword`|
## 请求
**地址** https://business-api.tiktok.com/open_api/v1.3/tool/interest_keyword/recommend/
**方法** GET
**Header**
```xtable
|字段|类型|描述|
|---|---|---|
|Access-Token {必填}|string|授权访问令牌。可以通过[获取访问令牌](https://ads.tiktok.com/marketing_api/docs?id=1738373164380162)接口获取。|
参数
|字段|类型|描述|
|---|---|---|
|advertiser_id {必填}|string| 广告主ID。 |
| keywords {+条件必填} | string[] |<ul><li> `keywords`和`keyword`必填其一。 </li><li>若同时传入`keywords` 和`keyword`，将忽略 `keyword`。</li></ul> <br>种子关键词列表，用来搜索其他兴趣分类。<br>列表中的每个种子关键词都将单独用于生成对应的其他兴趣分类。 <br> <br> 最大数量：10。 |
| keyword {+条件必填} | string|<ul><li> `keywords`和`keyword`必填其一。 </li><li>若同时传入`keywords` 和`keyword`，将忽略 `keyword`。</li></ul> <br>单个种子关键词，用来搜索其他兴趣分类。 |
|mode|string|搜索模式。<br><br>枚举值: `FUZZ_MATCH`(模糊匹配)，`SEMANTIC_RECOMMEND`(相似搜索)。<br>默认值: `FUZZ_MATCH`。|
|language|string| 关键词语言。<br> <br>枚举值：`fr`, `id`, `it`, `ja`, `ms`, `ar`, `vi`, `en`, `ru`, `es`, `th`, `tr`, `hi`, `zh`, `de`, `ko`。<br>默认: `en` (英语)。 <br><br>需要注意的是，定向受众语言不受关键词语言限制。例如，定向非英语地区受众可以使用英语分类。|
|limit|number| 你想获得的推荐的其他兴趣分类数。<br><br>默认值: 50。<br><br>取值范围: 1-50。|
|audience_type|string| 受众类型。<br><br>枚举值: <ul><li> `GENERAL_INTEREST`: 大众兴趣。受众对某类别视频拥有长期兴趣。</li><li> `PURCHASE_INTENTION`（已废弃）: 购买意向。受众近期行为表明他们可能会购买某内容类别相关产品。 </li></ul><br>默认值:`GENERAL_INTEREST`。|
示例
(code cURL HTTP)
curl --location --request GET 'https://business-api.tiktok.com/open_api/v1.3/tool/interest_keyword/recommend/' \
--header 'Access-Token: xxxx' \
--header 'Content-Type: application/json' \
--data-raw '{
"advertiser_id": "1234567886354716677",
"keyword": "test",
}'
(/code)
返回
|字段|类型|描述|
|---|---|---|
|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[]|其他兴趣分类列表。|
##| input_keyword | string | 仅当请求中传入 `keywords` 且 `keywords` 中包含多个关键词时返回。<br><br>其他兴趣分类对应的种子关键词。<br><br>例如，若种子关键词为"test"，对应的推荐兴趣关键词为"Tester"，则返回的`input_keyword` 将为`"test"`，`keyword` 将为 `"Tester"`。 |
##|keyword|string|其他兴趣分类。|
##|keyword_id|string| 其他兴趣分类 ID。|
##|language|string|其他兴趣分类语言。<br> <br>枚举值：`fr`, `id`, `it`, `ja`, `ms`, `ar`, `vi`, `en`, `ru`, `es`, `th`, `tr`, `hi`, `zh`, `de`, `ko`。|
##|status|string|其他兴趣分类状态，即分类是否有效。<br><br>枚举值: <ul><li>`EFFECTIVE`：有效。有效其他兴趣分类指一个分类能覆盖的受众人数足够大。</li><li>`INEFFECTIVE`：无效。无效其他兴趣分类指一个分类能覆盖的受众人数太少。</li></ul> <br><p><span style="color:darkred"><b>注意</b></span>: 仅有效状态的其他兴趣分类可在广告组中用于定向受众。|
示例
(code Success-Response http)
HTTPS/1.1 200 OK
{
"code": 0,
"message": "OK",
"request_id": "202207011538040102452421060C18B592",
"data": {
"recommended_keywords": [
{
"status": "EFFECTIVE",
"language": "1",
"keyword": "Testament",
"keyword_id": "1915651459"
},
{
"status": "EFFECTIVE",
"language": "1",
"keyword": "Tester",
"keyword_id": "1916254642"
},
{
"status": "EFFECTIVE",
"language": "1",
"keyword": "Brain test",
"keyword_id": "2027741302"
},
{
"status": "EFFECTIVE",
"language": "1",
"keyword": "Test",
"keyword_id": "2027749623"
},
{
"status": "EFFECTIVE",
"language": "1",
"keyword": "Test drive",
"keyword_id": "2027768725"
},
...
]
}
}
(/code);