Find TikTok targeting ids
Turns names into the ids TikTok targets by: places into location ids, interest names into interest category ids (interest_category_ids), keyword phrases into additional interest ids (interest_keyword_ids), languages into language codes, and lists the device and network enums verbatim. Use when: the user names any place, interest or language the ads should target — always before tiktok_create_video_campaign, tiktok_add_ad_group or tiktok_update_ad_group. Those tools take ids only, check them against TikTok's lists, and refuse anything that looks like a name. Do not guess an id, reuse one from another ad platform, or pass a place name into a write. A wrong location id spends real money in the wrong country and TikTok will not warn you. Do not pass a country together with a region or city inside it: TikTok refuses overlapping locations in one ad group. Which locations exist depends on the campaign objective, so pass objective when it is known. Do not resolve sensitive categories (health conditions, sexual orientation, religion, politics): TikTok restricts them and Adako will not target them. If the user asks for one, say why not and offer a behavioural interest instead. Returns every match with whatever distinguishes them — a location's level and country, an interest's depth in the taxonomy. When several matches look plausible, show them and ask the user which they mean rather than taking the first. Costs nothing, so resolve every name the user mentions, one type per call.
Request
- Base URL: https://adako.ai
- URL: https://adako.ai/api/v1/tools/tiktok_search_targeting/execute
- Auth: HTTP bearer
Headers
Optional 8-128 character key. A successful envelope is cached for 24 hours; replaying the key with the same arguments returns it again with Idempotent-Replayed: true, and replaying it with different arguments answers 409.
Request body
Response
The tool ran. A write returns proposal_id and approve_url while the change waits for approval.
Changes
No recorded changes to this operation across all 1 revision of this API.