API Reference › TikTok Ads › search_tiktok_targeting

search_tiktok_targeting

TikTok Ads Read

Search TikTok targeting options for campaign creation and ad group management

Endpoint

POST https://api.adspirer.ai/api/v1/tools/search_tiktok_targeting/execute

Headers

Description

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)

Request body

All tool arguments are wrapped in an arguments object.

FieldTypeDescription
targeting_typestring requiredType of targeting to search. Options: 'interest_categories' (browse all interest categories), 'interest_keywords' (search keywords by seed keyword — requires 'keyword'), 'regions' (available locations — countries, provinces, cities), 'languages' (available language codes), 'action_categories' (app event categories), 'carriers' (mobile carriers), 'device_models' (target device models).
keywordstring optionalSeed keyword for interest_keywords search. Required when targeting_type='interest_keywords'.
languagestring optionalLanguage for results. Default: 'en'. Options: en, zh, ja, de, es, fr, id, it, ko, ru, th, tr, vi, ar, pt, ms. default: "en"
limitinteger optionalMax results for interest_keywords (1-50). Default: 50. default: 50
modestring optionalSearch mode for interest_keywords: 'FUZZ_MATCH' (default) or 'SEMANTIC_RECOMMEND'. default: "FUZZ_MATCH"
audience_typestring optionalAudience type for interest_keywords: 'GENERAL_INTEREST' (default) or 'PURCHASE_INTENTION'. default: "GENERAL_INTEREST"
placementsarray optionalPlacements filter: ['PLACEMENT_TIKTOK'], ['PLACEMENT_PANGLE'], etc. Default: TikTok only.
objective_typestring optionalCampaign objective for regions lookup. Default: TRAFFIC. default: "TRAFFIC"
level_rangestring optionalRegion detail level: 'ALL', 'TO_COUNTRY', 'TO_PROVINCE', 'TO_CITY', 'TO_DISTRICT'. Default: TO_COUNTRY. default: "TO_COUNTRY"
operating_systemstring optionalOS filter for regions: 'ANDROID' or 'IOS'. Optional.
advertiser_idstring optionalTikTok advertiser ID (optional).

Example request

{
  "arguments": {
    "targeting_type": "string",
    "keyword": "string",
    "language": "en",
    "limit": 50,
    "mode": "FUZZ_MATCH",
    "audience_type": "GENERAL_INTEREST",
    "placements": [
      "string"
    ]
  }
}

Example responses

200 — Success

{
  "success": true,
  "data": {
    "text": "(tool-specific textual output for search_tiktok_targeting)",
    "quota": {
      "used": 42,
      "limit": 150,
      "tier": "plus",
      "period_end": "2026-05-01"
    }
  },
  "tool": "search_tiktok_targeting"
}

400 — Tool-level error (bad arguments / multi-account selection)

{
  "success": false,
  "error": "You have 25 meta_ads accounts connected. Please specify which account to use by passing the ad_account_id parameter:\n  - Acme Holdings (ad_account_id=\"act_123456789\")\n  - Acme EU (ad_account_id=\"act_987654321\")",
  "is_error": true,
  "tool": "search_tiktok_targeting"
}

402 — Quota exhausted

{
  "success": false,
  "error": "\ud83d\udea8 Monthly limit reached (150/150 tool calls on Plus tier).\nUpgrade to Pro at https://adspirer.ai to keep building.",
  "is_error": true,
  "tool": "search_tiktok_targeting",
  "quota": {
    "used": 150,
    "limit": 150,
    "tier": "plus",
    "period_end": "2026-05-01",
    "upgrade_url": "https://adspirer.ai"
  }
}

Try it live

Interactive: Swagger UI

Machine-readable: OpenAPI 3.1 spec · llms-full.txt

More tools: TikTok Ads · All tools

Adspirer REST API — get an API key at adspirer.ai/keys · adspirer.ai