通过 ID 获取其他兴趣分类

您可以使用本接口通过 ID 获取相应的其他兴趣分类。

v1.2与v1.3版本对比

以下表格概括了 v1.2与v1.3接口的变化。 ``xtable |变化内容{23%}|v1.2{40%}|v1.3{37%}| |---|---|---| |接口路径|/v1.2/tools/interest_keyword/get/|/v1.3/tool/interest_keyword/get/| |请求参数类型 |advertiser_id: number|advertiser_id: string| |请求参数名称和类型 |id: number|keyword_id: string| |新增请求参数|/|filtering<br>audience_type| |返回参数名称和类型 |id: number|keyword_id`: string |

## 请求

**地址** https://business-api.tiktok.com/open_api/v1.3/tool/interest_keyword/get/

**方法** GET

**Header**

```xtable
|字段|类型|描述|
|---|---|---|
|Access-Token {必填}|string|授权访问令牌。可以通过[获取访问令牌](https://ads.tiktok.com/marketing_api/docs?id=1738373164380162)接口获取。|

参数

|字段|类型|描述|
|---|---|---|
|advertiser_id {必填}|string| 广告主ID。 |
|keyword_query|object[]|想要查询的其他兴趣分类信息。<br>最大数量：50。|
#|keyword_id {必填}|string|其他兴趣分类 ID。|
#|language|string|其他兴趣分类语言。默认值: `en` (英语)。 <br> 支持的语种：`fr`, `id`, `it`, `ja`, `ms`, `ar`, `vi`, `en`, `ru`, `es`, `th`, `tr`, `hi`, `zh`, `de`, `ko`。|
|filtering| object |筛选条件。|
#|audience_type| string|想要筛选的受众类型。枚举值：<ul><li>`GENERAL_INTEREST`:  大众兴趣。受众对某类别视频拥有长期兴趣。</li><li>`PURCHASE_INTENTION`: 购买意向。受众近期行为表明他们可能会购买某内容类别相关产品。</li></ul>默认值：`GENERAL_INTEREST`。|

示例

(code http curl)
curl --location --request GET 'https://business-api.tiktok.com/open_api/v1.3/tool/interest_keyword/get/?advertiser_id= {{ADVERTISER_ID}}&keyword_query=[{"keyword_id": "{{keyword_id}}"}]' \
--header 'Access-Token: {{Access-Token}}' \
(/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|返回数据。  |
#|keywords|object[]| 其他兴趣分类列表。|
##|keyword|string|其他兴趣分类。|
##|keyword_id|string| 其他兴趣分类 ID。|
##|status|string|其他兴趣分类状态，即其他兴趣分类是否有效。枚举值: `EFFECTIVE`(有效), `INEFFECTIVE`(无效) 。有效其他兴趣分类指一个分类能覆盖的受众人数足够大。无效关键词指一个分类能覆盖的受众人数太少。<br><p><span style="color:darkred"><b>注意</b></span>: 仅有效状态的分类可在广告组中用于定向受众。|

示例

(code Success-Response http)
HTTPS/1.1 200 OK
{
    "code": 0,
    "message": "OK",
    "request_id": "2021081206012901024503714416ABA90A",
    "data": {
        "keywords": [
            {
                "keyword_id": "2027755677",
                "status": "EFFECTIVE",
                "keyword": "movie app"
            }
        ]
    }
}
(/code);