工具 API

targeting_search

Searches targeting categories and hashtags for interests and behaviors from seed keywords, or lists all available categories and hashtag bundles when no seed keywords are provided. Use this endpoint to discover values for interest-, purchase-intention-, and action-based targeting. Returned IDs are used later when creating ad groups via `/adgroup/create/`.

ecommerceOAuth1 积分

调用信息

工具标识
tiktok-ads.targeting_search
服务提供方
TikTok 广告
平均响应
0 ms
近 7 天调用
0

输入参数

advertiser_id必填

Advertiser ID.

filtering

Filtering conditions.

language

Language of the seed keywords. Default is `en`. If `sub_targeting_types` includes `HASHTAG_INTERACTION` and `search_keywords` contains one or more non-English keywords, hashtags in multiple languages may still be returned even when `language` is specified, because hashtag search is not restricted to a single language.

search_keywords

Seed keywords used to search for targeting categories or hashtags. Maximum 10 keywords, and each keyword can be up to 100 characters. If you pass multiple keywords, `sub_targeting_types` may include only `ADDITIONAL_INTEREST` and `HASHTAG_INTERACTION`. If `sub_targeting_types` includes `HASHTAG_INTERACTION` and you pass `search_keywords`, the endpoint returns only hashtags in `hashtag_interaction.search_result`; hashtag bundle search is not supported. To retrieve hashtag bundles, include `HASHTAG_INTERACTION` in `sub_targeting_types` and omit `search_keywords`.

sub_targeting_types

Secondary targeting types. Required when `targeting_type` is `INTEREST_AND_BEHAVIOR` and `search_keywords` contains multiple keywords. Allowed values depend on `search_keywords`: if `search_keywords` is omitted, allowed values are `GENERAL_INTEREST`, `PURCHASE_INTENTION`, `VIDEO_INTERACTION`, `CREATOR_INTERACTION`, `HASHTAG_INTERACTION`, and if omitted the default is `["GENERAL_INTEREST","PURCHASE_INTENTION","VIDEO_INTERACTION","CREATOR_INTERACTION","HASHTAG_INTERACTION"]`; if `search_keywords` contains one keyword, allowed values are `GENERAL_INTEREST`, `ADDITIONAL_INTEREST`, `PURCHASE_INTENTION`, `VIDEO_INTERACTION`, `CREATOR_INTERACTION`, `HASHTAG_INTERACTION`, and if omitted the default is `["GENERAL_INTEREST","ADDITIONAL_INTEREST","PURCHASE_INTENTION","VIDEO_INTERACTION","CREATOR_INTERACTION","HASHTAG_INTERACTION"]`; if `search_keywords` contains more than one keyword, allowed values are only `ADDITIONAL_INTEREST` and `HASHTAG_INTERACTION`, and you must pass this field manually.

targeting_type必填

Primary targeting type. Must be `INTEREST_AND_BEHAVIOR` for this endpoint.