搜索或列举和兴趣与行为相关的定向分类和话题标签
您可以使用本接口基于种子关键词搜索和兴趣与行为相关的定向分类和话题标签，或不使用种子关键词、直接列举所有可用的和兴趣与行为相关的定向分类和话题标签。
请求
地址 https://business-api.tiktok.com/open_api/v1.3/targeting/search/
方法 GET
Header
|字段{30%}|类型{15%}|描述{55%}|
|---|---|---|
|Access-Token {必填}|string|授权访问令牌。可以通过[获取访问令牌](https://ads.tiktok.com/marketing_api/docs?id=1738373164380162)接口获取。|
参数
|字段{30%}|类型{15%}|描述{55%}|
|---|---|---|
| advertiser_id {必填} | string | 广告主 ID。 |
| targeting_type{必填} | string | 一级定向类型。<br><br>枚举值：`INTEREST_AND_BEHAVIOR` （兴趣与行为）。 |
| sub_targeting_types {+条件必填} | string[] | 当 `targeting_type` 为 `INTEREST_AND_BEHAVIOR` 且 `search_keywords` 中传入多个关键词时必填。<br><br>二级定向类型。 <br><br>枚举值：<ul><li>`GENERAL_INTEREST`：一般兴趣。</li><li>`ADDITIONAL_INTEREST`：其他兴趣。</li><li>`PURCHASE_INTENTION`：购买意向。</li><li>`VIDEO_INTERACTION`：视频互动。</li><li>`CREATOR_INTERACTION`：创作者互动。</li><li>`HASHTAG_INTERACTION`：话题互动。 </li></ul><br><ul><li>若未传入 `search_keywords`，本字段支持的值为：`GENERAL_INTEREST`，`PURCHASE_INTENTION`，`VIDEO_INTERACTION`， `CREATOR_INTERACTION`，`HASHTAG_INTERACTION`。 <ul><li>若您此时不传入`sub_targeting_types`，`sub_targeting_types` 的值将默认为 `["GENERAL_INTEREST","PURCHASE_INTENTION","VIDEO_INTERACTION", "CREATOR_INTERACTION", "HASHTAG_INTERACTION"]`。</li></ul></li><li>若传入 `search_keywords` 且其中仅包含一个关键词，本字段支持的值为： `GENERAL_INTEREST`，`ADDITIONAL_INTEREST`，`PURCHASE_INTENTION`，`VIDEO_INTERACTION`，`CREATOR_INTERACTION`，`HASHTAG_INTERACTION`。 <ul><li>若您此时不传入 `sub_targeting_types`，`sub_targeting_types` 的值将默认为`["GENERAL_INTEREST", "ADDITIONAL_INTEREST", "PURCHASE_INTENTION", "VIDEO_INTERACTION", "CREATOR_INTERACTION", "HASHTAG_INTERACTION"]`。</li></ul></li><li>若传入 `search_keywords` 且其中包含多个关键词，本字段支持的值为 `ADDITIONAL_INTEREST`，`HASHTAG_INTERACTION`。 <ul><li>此时，您需手动传入`sub_targeting_types`。</li></ul></li></ul>|
| search_keywords | string[] | 种子关键词列表，用于搜索定向分类或话题标签。<br><br>最大数量：10。每个关键词的长度限制为 100 字符。<br><br>若您为本字段传入多个种子关键词，您需确保`sub_targeting_types`的值仅包含 `ADDITIONAL_INTEREST` 和`HASHTAG_INTERACTION`。 <br><br><p><span style="color:darkred"><b>注意</b></span>：不支持搜索话题包。因此，若您在 `sub_targeting_types` 的值中包含 `HASHTAG_INTERACTION` 且传入了`search_keywords`，您仅可通过返回的`hashtag_interaction` 对象中的`search_result` 获取话题标签。若想获取话题包，您需在 `sub_targeting_types` 的值中包含 `HASHTAG_INTERACTION`且不传入`search_keywords` 。 |
| language | string | 种子关键词的语言。 <br><br>默认值：`en`。<br><br>若想获取可选值，请查看<a href="#item-link-language 可选值"> `language`可选值</a>。<br><br><p><span style="color:darkred"><b>注意</b></span>：若 `sub_targeting_types` 的值中包含 `HASHTAG_INTERACTION` 且您在`search_keywords` 中指定了一个或多个非英 语的种子关键词，无论您是否指定`language`，都有可能会返回多种语言的话题标签。这是因为不支持按单个语言搜索话题标签，且某些字符或字母是多种语言所共用的。 |
| filtering | object | 筛选条件。 |
#| special_industries | string[] | 特殊广告分类。<br>为推广系列选择住房、就业或信贷分类，即表示您保证不会利用 TikTok 在与住房、就业或信贷相关的广告中歧视具有受保护特征的人群，且遵守[TikTok 的特殊广告分类政策](https://ads.tiktok.com/help/article/housing-employment-credit-hec-ad-policy?redirected=2&lang=zh)。 <br><br>枚举值：<ul><li> `HOUSING`：房地产，房屋保险，抵押贷款或相关的广告。</li><li>`EMPLOYMENT`：工作机会，实习机会，职业认证项目或相关的广告。 </li><li>`CREDIT`：信用卡申请，汽车贷款，长期融资或相关的广告。</li></ul><br>默认值：`[]`。默认不筛选特殊广告分类。 <br><br>若您为本字段传入多个广告分类，返回中将包括支持任一指定的广告分类的定向分类或话题标签。 |
language 可选值
| 值{20%} | 描述{60%} |
|---|---|
| `ar` | 阿拉伯语 |
| `cs` | 捷克语 |
| `de` | 德语 |
| `en` | 英语 |
| `es` | 西班牙语 |
| `fr` | 法语 |
| `id` | 印尼语 |
| `it` | 意大利语 |
| `ja` | 日语 |
| `ko` | 韩语 |
| `ms` | 马来语 |
| `pl` | 波兰语 |
| `pt` | 葡萄牙语 |
| `ru` | 俄语 |
| `sv` | 瑞典语 |
| `th` | 泰语 |
| `tr` | 土耳其语 |
| `vi` | 越南语 |
| `zh` | 中文 |
示例
(code curl http)
curl --location --request GET 'https://business-api.tiktok.com/open_api/v1.3/targeting/search/?advertiser_id={{advertiser_id}}&targeting_type=INTEREST_AND_BEHAVIOR' \
--header 'Access-Token: {{Access-Token}}' \
(/code)
返回
|字段{30%}|类型{17%}|描述{53%}|
|---|---|---|
|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| 返回数据。 |
#| general_interest | object | 一般兴趣分类列表。 |
##| list_result | object[] | 所有可用的一般兴趣分类列表。<br><br>若指定了 `search_keywords`且`sub_targeting_types` 的值包含`GENERAL_INTEREST`，本字段的值将为 null。 |
###| sub_targeting_type | string | 二级定向分类。<br><br>枚举值： `GENERAL_INTEREST` （一般兴趣）。 |
###| id | string | 一般兴趣分类 ID。 <br><br>通过[/adgroup/create/](1739499616346114.html)创建广告组时，您可将本字段的值传入`interest_category_ids`。 |
###| name | string | 一般兴趣分类名称。 |
###| supported_special_industries | string[] | 支持与该一般兴趣分类同时使用的特殊广告分类。 <br><br>枚举值：<ul><li>`HOUSING`：房地产，房屋保险，抵押贷款或相关的广告。</li><li> `EMPLOYMENT`：工作机会，实习机会，职业认证项目或相关的广告。</li><li> `CREDIT`：信用卡申请，汽车贷款，长期融资或相关的广告。</li></ul>|
###| level | integer | 该一般兴趣分类的层级。 |
###| children_ids | string[] | 该一般兴趣分类的子分类的 ID 列表。 |
###| hashtag_type| string | 话题标签类型。 <br><br>本字段值将为 null，因为话题标签类型仅适用话题互动场景。 |
##| search_result | map(string<>object[]) | 基于所指定的种子关键词（`search_keywords`）生成的一般兴趣分类列表。<br><br><ul><li>键：请求中 `search_keywords` 指定的一个种子关键词。<ul><li>示例：`"child"`。 </li></ul></li><li>值：代表生成的一般兴趣分类列表的对象数组，结构与`list_result`相同。<ul><li>示例：`[{"sub_targeting_type": "GENERAL_INTEREST", "id": "10100","name": "Early Childhood & Preschool Education", "supported_special_industries": ["HOUSING","EMPLOYMENT","CREDIT"],"children_ids": null,"level": null, "hashtag_type": null}]` </li></ul></li></ul>通过[/adgroup/create/](1739499616346114.html)创建广告组时，您可将 `id` 字段的值传入`interest_category_ids`。 |
#| additional_interest | object | 其他兴趣分类列表。 <br><br>若请求中未传入`search_keywords` ，本字段值将为 null。 |
##| search_result | map(string<>object[]) | 基于所指定的种子关键词（`search_keywords`）生成的其他兴趣分类列表。 <br><br><ul><li>键：请求中 `search_keywords` 指定的一个种子关键词。<ul><li>示例：`"child"`。 </li></ul></li><li>值：代表生成的其他兴趣分类列表的对象数组，结构与`general_interest`对象中的`list_result`相同。<ul><li>示例：`[{"sub_targeting_type": "ADDITIONAL_INTEREST", "id": "1915593069","name": "Childhood", "supported_special_industries": [],"children_ids": null,"level": null, "hashtag_type": null}]` </li></ul></li></ul>通过[/adgroup/create/](1739499616346114.html)创建广告组时，您可将 `id` 字段的值传入`interest_keyword_ids`。 |
#| purchase_intention | object | 购买意向分类列表。 |
##| list_result | object[] | 所有可用的购买意向分类列表。<br><br>若指定了 `search_keywords`且`sub_targeting_types`的值包含`PURCHASE_INTENTION`，本字段的值将为 null。 |
###|sub_targeting_type | string | 二级定向分类。<br><br>枚举值： `PURCHASE_INTENTION`（购买意向）。 |
###| id | string | 购买意向分类 ID。<br><br>通过[/adgroup/create/](1739499616346114.html)创建广告组时，您可将本字段的值传入`purchase_intention_keyword_ids`。 |
###| name | string | 购买意向分类名称。 |
###| supported_special_industries | string[] | 支持与该购买意向分类同时使用的特殊广告分类。 <br><br>枚举值：<ul><li>`HOUSING`：房地产，房屋保险，抵押贷款或相关的广告。</li><li> `EMPLOYMENT`：工作机会，实习机会，职业认证项目或相关的广告。</li><li> `CREDIT`：信用卡申请，汽车贷款，长期融资或相关的广告。</li></ul>|
###| level | integer | 该购买意向分类的层级。 |
###| children_ids | string[] | 该购买意向分类的子分类的 ID 列表。 |
###| hashtag_type| string | 话题标签类型。 <br><br>本字段值将为 null，因为话题标签类型仅适用话题互动场景。 |
##| search_result| map(string<>object[]) | 基于所指定的种子关键词（`search_keywords`）生成的购买意向分类列表。<br><br><ul><li>键：请求中 `search_keywords` 指定的一个种子关键词。<ul><li>示例：`"child"`。</li></ul></li><li>值：代表生成的购买意向分类列表的对象数组，结构与`list_result`相同。<ul><li>示例：`[{ "sub_targeting_type": "PURCHASE_INTENTION", "id": "12109","name": "Children's Apparel", "supported_special_industries": [],"children_ids": null, "level": null, "hashtag_type": null }]`。</li></ul></li></ul>通过[/adgroup/create/](1739499616346114.html)创建广告组时，您可将 `id` 字段的值传入`purchase_intention_keyword_ids`。 |
#| video_interaction | object | 视频互动分类列表。 |
##| list_result | object[] | 所有可用的视频互动分类列表。<br><br>若指定了 `search_keywords`且`sub_targeting_types` 的值包含`VIDEO_INTERACTION`，本字段的值将为 null。 |
###| sub_targeting_type | string | 二级定向分类。 <br><br>枚举值： `VIDEO_INTERACTION`（视频互动）。 |
###| id | string | 视频互动分类 ID。 <br><br>通过[/adgroup/create/](1739499616346114.html)创建广告组且 `action_scene` 设置为 `VIDEO_RELATED` 时，您可将本字段的值传入 `action_category_ids`。 |
###| name | string | 视频互动分类名称。 |
###| supported_special_industries | string[] | 支持与该视频互动分类同时使用的特殊广告分类。 <br><br>枚举值：<ul><li>`HOUSING`：房地产，房屋保险，抵押贷款或相关的广告。</li><li> `EMPLOYMENT`：工作机会，实习机会，职业认证项目或相关的广告。</li><li> `CREDIT`：信用卡申请，汽车贷款，长期融资或相关的广告。</li></ul>|
###| level | integer | 该视频互动分类的层级。 |
###| children_ids | string[] | 该视频互动分类的子分类的 ID 列表。 |
###| hashtag_type | string | 话题标签类型。<br><br> 本字段值将为null，因为话题标签类型仅适用话题互动场景。 |
##| search_result| map(string<>object[]) | 基于所指定的种子关键词（`search_keywords`）生成的视频互动分类列表。 <br><br><ul> <li>键：请求中 `search_keywords` 指定的一个种子关键词。<ul><li>示例：`"fashion"`。 </li></ul></li><li>值：代表生成的视频互动分类列表的对象数组，结构与`list_result`相同。<ul><li>示例：`[{ "sub_targeting_type": "VIDEO_INTERACTION", "id": "1612","name": "Other Fashion", "supported_special_industries": ["HOUSING","EMPLOYMENT","CREDIT"],"children_ids": null,"level": null, "hashtag_type": null }]` 。</li></ul></li></ul>通过[/adgroup/create/](1739499616346114.html)创建广告组且 `action_scene` 设置为 `VIDEO_RELATED` 时，您 可将 `id` 字段的值传入 `action_category_ids`。 |
#| creator_interaction | object | 创作者互动分类列表。 |
##| list_result | object[] | 所有可用的创作者互动分类列表。 <br><br>若指定了 `search_keywords` 且 `sub_targeting_types` 的值包含`CREATOR_INTERACTION`，本字段的值将为 null。 |
###| sub_targeting_type | string | 二级定向分类。 <br><br>枚举值： `CREATOR_INTERACTION`（创作者互动）。 |
###| id | string | 创作者互动分类 ID。 <br><br>通过[/adgroup/create/](1739499616346114.html)创建广告组且 `action_scene` 设置为 `CREATOR_RELATED` 时， 您可将本字段的值传入`action_category_ids`。 |
###| name | string | 创作者互动分类名称。 |
###| supported_special_industries | string[] | 支持与该创作者互动分类同时使用的特殊广告分类。 <br><br>枚举值：<ul><li>`HOUSING`：房地产，房屋保险，抵押贷款或相关的广告。</li><li> `EMPLOYMENT`：工作机会，实习机会，职业认证项目或相关的广告。</li><li> `CREDIT`：信用卡申请，汽车贷款，长期融资或相关的广告。</li></ul>|
###| level | integer | 该创作者互动分类的层级。 |
###| children_ids | string[] | 该创作者互动分类的子分类的 ID 列表。 |
###| hashtag_type | string | 话题标签类型。 <br><br>本字段值将为 null，因为话题标签类型仅适用话题互动场景。 |
##| search_result | map(string<>object[]) | 基于所指定的种子关键词（`search_keywords`）生成的创作者互动分类列表。<br><br><ul><li>键：请求中 `search_keywords` 指定的一个种子关键词。<ul><li>示例：`"fashion"`。</li></ul></li><li><ul>值：代表生成的创作者互动分类列表的对象数组，结构与`list_result`相同。<li>示例：`[{ "sub_targeting_type": "CREATOR_INTERACTION", "id": "10","name": "Fashion & Beauty", "supported_special_industries":["HOUSING","EMPLOYMENT","CREDIT"],"children_ids": null, "level": null, "hashtag_type": null }]` 。</li></ul></li></ul>通过[/adgroup/create/](1739499616346114.html)创建广告组且 `action_scene` 设置为 `CREATOR_RELATED` 时， 您可将 `id`字段的值传入`action_category_ids`。 |
#| hashtag_interaction | object | 与话题互动有关的话题标签列表或话题包列表。 <br><br>若请求中` sub_targeting_types`的值包含 `HASHTAG_INTERACTION`：<ul><li>传入 `search_keywords`时，仅返回话题标签列表。</li><li>未传入 `search_keywords`时，仅返回话题包。</li></ul> |
##| list_result | object[] | 所有可用的话题包列表。<br><br>若指定了 `search_keywords` 且 `sub_targeting_types` 的值包含`HASHTAG_INTERACTION`，本字段值将为 null。 |
###| sub_targeting_type| string | 二级定向分类。<br><br> 枚举值： `HASHTAG_INTERACTION` （话题互动）。 |
###| id | string | 话题包 ID。<br><br>通过[/adgroup/create/](1739499616346114.html)创建广告组且 `action_scene` 设置为 `HASHTAG_RELATED` 时， 您可将本字段的值传入`action_category_ids`。 |
###| name | string | 话题包名称。 |
###| supported_special_industries | string[] | 支持与该话题包同时使用的特殊广告分类。 <br><br>枚举值：<ul><li>`HOUSING`：房地产，房屋保险，抵押贷款或相关的广告。</li><li> `EMPLOYMENT`：工作机会，实习机会，职业认证项目或相关的广告。</li><li> `CREDIT`：信用卡申请，汽车贷款，长期融资或相关的广告。</li></ul>|
###| level | integer | 该话题包的层级。 |
###| children_ids| string[] | 该话题包的子话题包的 ID 列表。 |
###| hashtag_type | string | 话题标签类型。 <br><br>枚举值：`HASHTAG_BUNDLE`（一个预定义的、某一主题或事件的话题标签组合。例如，"christmas" 话题包可用于定向与圣诞节相关的季节性话题标签）。 |
##| search_result| map(string<>object[]) | 基于所指定的种子关键词（`search_keywords`）生成的话题标签列表。<br><br><ul><li>键：请求中 `search_keywords` 指定的一个种子关键词。 <ul><li>示例：`"child"`。</li></ul></li><li>值：代表生成的话题标签列表的对象数组，结构与`list_result`相同。需注意`hashtag_type` 的值将始终为 `HASHTAG`（单个话题标签，可用于定向对该特定话题标签相关的内容感兴趣的用户）。<ul><li>示例：`[{ "sub_targeting_type": "HASHTAG_INTERACTION", "id": "67137517581","name": "#childbirtheducation", "supported_special_industries": [],"children_ids": null,"level": null, "hashtag_type": "HASHTAG"}]`。</li></ul></li></ul>通过[/adgroup/create/](1739499616346114.html)创建广告组且 `action_scene` 设置为 `HASHTAG_RELATED` 时， 您可将 `id` 字段的值传入`action_category_ids`。 |
示例
(code Success-Response http)
HTTPS/1.1 200 OK
{
"message": "OK",
"request_id": "{{request_id}}",
"data": {
"video_interaction": {
"list_result": [
{
"id": "1311100",
"sub_targeting_type": "VIDEO_INTERACTION",
"name": "Scenery & Plants",
"children_ids": [],
"level": 3,
"supported_special_industries": [
"HOUSING",
"EMPLOYMENT",
"CREDIT"
],
"hashtag_type": null
},
...
],
"search_result": null
},
"general_interest": {
"list_result": [
{
"id": "18110",
"sub_targeting_type": "GENERAL_INTEREST",
"name": "Cleaning Supplies",
"children_ids": [],
"level": 2,
"supported_special_industries": [],
"hashtag_type": null
},
...
],
"search_result": null
},
"creator_interaction": {
"list_result": [
{
"id": "11",
"sub_targeting_type": "CREATOR_INTERACTION",
"name": "DIY & Life Hacks",
"children_ids": [
"11001"
],
"level": 1,
"supported_special_industries": [
"HOUSING",
"EMPLOYMENT",
"CREDIT"
],
"hashtag_type": null
},
...
],
"search_result": null
},
"hashtag_interaction": {
"list_result": [
{
"id": "11",
"sub_targeting_type": "HASHTAG_INTERACTION",
"name": "cybermonday",
"children_ids": [],
"level": 1,
"supported_special_industries": [],
"hashtag_type": "HASHTAG_BUNDLE"
},
...
],
"search_result": null
},
"purchase_intention": {
"list_result": [
{
"id": "26101",
"sub_targeting_type": "PURCHASE_INTENTION",
"name": "Photography",
"children_ids": [],
"level": 2,
"supported_special_industries": [
"HOUSING",
"EMPLOYMENT",
"CREDIT"
],
"hashtag_type": null
},
...
],
"search_result": null
},
"additional_interest": null
},
"code": 0
}
(/code)