Search TikTok Targeting
Search TikTok targeting options for campaign creation and ad group management.
IMPORTANT: Call this tool to find valid targeting IDs BEFORE creating campaigns or ad groups.
Covers ALL targeting types:
- interest_categories: Browse all interest categories (fashion, gaming, food, etc.) — returns IDs for interest_category_ids
- interest_keywords: Search interest keywords by a seed keyword (e.g., “fitness”) — returns keyword IDs for interest_keyword_ids
- regions: Get available locations (countries, provinces, cities) — returns location IDs for location_ids/target_locations
- languages: Get available language codes — returns codes for languages targeting
- action_categories: Get app event categories — for conversion tracking
- carriers: Get mobile carrier names — for carrier targeting
- device_models: Get device models — for device targeting
Common usage patterns:
- Before create_tiktok_campaign: search regions + interest_categories to set targeting
- Before add_tiktok_ad_group: search interest_keywords for new audience segments
- Before update_tiktok_ad_group: search regions to expand/narrow location targeting
Parameters:
- targeting_type: REQUIRED — which type to search (see above)
- keyword: REQUIRED for interest_keywords — seed keyword to search
- level_range: For regions — TO_COUNTRY (default), TO_PROVINCE, TO_CITY, TO_DISTRICT
- language: Display language for results (default: en)
Authorizations
API key from https://adspirer.ai/keys. Prefix sk_live_. Treat as a secret — never commit.
Headers
Client-generated UUID to make writes idempotent. Strongly recommended for write tools. A repeat call with the same key returns the cached result instead of re-executing. Example: 550e8400-e29b-41d4-a716-446655440000
Body
All tool arguments are wrapped in an arguments object. The fields accepted inside arguments are listed below — required fields are marked with a red asterisk.
Input for searching TikTok targeting options
Response
Tool executed successfully. data.text carries the human-readable result (markdown-friendly). data.quota shows your current usage against the plan limit. data.structured appears when the tool emits machine-parseable structured content. data.content appears for tools that return non-text blocks (images, resources).
Returned on HTTP 200. data.text is the primary human-readable output. data.quota is always present for billable calls. data.structured is set only when the tool emits machine-parseable structured content. data.content is set only when the tool emits non-text content blocks.