API Reference › TikTok Ads › explain_tiktok_objective

explain_tiktok_objective

TikTok Ads Read

Explain what a TikTok campaign objective requires BEFORE attempting to create one

Endpoint

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

Headers

Description

Explain what a TikTok campaign objective requires BEFORE attempting to create one. Returns required fields (promotion_type, app_id, frequency), forbidden fields (e.g. pixel_id at ad-group level is only valid for CONVERSIONS / PRODUCT_SALES / SHOP_PURCHASES), the account's minimum daily budget in its currency, and flags objectives that need extra TikTok account-level grant (LEAD_GENERATION → lead form, PRODUCT_SALES → catalog, etc.). Use this when a customer asks 'can I run X objective?' or before any create_tiktok_campaign call to confirm the objective is runnable. Read-only — no TikTok API call.

Request body

All tool arguments are wrapped in an arguments object.

FieldTypeDescription
objective_typestring requiredTikTok campaign objective to explain. Valid values: TRAFFIC, VIDEO_VIEWS, REACH, ENGAGEMENT, RF_REACH, APP_INSTALL, APP_PROMOTION, LEAD_GENERATION, CONVERSIONS, WEB_CONVERSIONS, PRODUCT_SALES, SHOP_PURCHASES, CATALOG_SALES.
advertiser_idstring optionalOptional TikTok advertiser ID. If provided, the response includes the actual minimum budget for the account's currency (e.g. ZAR 500, USD 20, INR 1500). If omitted, returns generic guidance.

Example request

{
  "arguments": {
    "objective_type": "string",
    "advertiser_id": "string"
  }
}

Example responses

200 — Success

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

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": "explain_tiktok_objective"
}

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": "explain_tiktok_objective",
  "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