tiktok_ads_get_performance_report

Get TikTok Ads Performance Report

Tiktok

Description

Get a performance report for a TikTok advertiser over a date range, with optional breakdowns and entity filters.

Read-onlyIdempotentOpen-world

Usage

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "tiktok_ads_get_performance_report",
    "arguments": {}
  }
}
hopkin tiktok performance-report get
FlagTypeRequiredDescription
--advertiser-idstringRequiredTikTok advertiser ID.
--levelstringRequiredReporting level — mapped to data_level internally.
--date-presetstringOptionalShortcut date range. Overridden by explicit start_date/end_date.
--start-datestringOptionalStart date in YYYY-MM-DD format.
--end-datestringOptionalEnd date in YYYY-MM-DD format.
--campaignstringOptionalFilter to a specific campaign.
--adgroup-idstringOptionalFilter to a specific ad group.
--pageintegerOptionalPage number (1-indexed). Default: 1.
--page-sizeintegerOptionalResults per page. Default: 20.
{
  "mcpServers": {
    "tiktok-ads": {
      "url": "https://mcp.hopkin.ai/tiktok-ads/mcp",
      "transport": "sse"
    }
  }
}

No example prompts available.

Parameters

NameTypeRequiredDescription
advertiser_id string Required TikTok advertiser ID.minLength: 1
level string Required Reporting level — mapped to data_level internally.
campaign adgroup ad
reason string Required Why this tool call is neededminLength: 1, maxLength: 500
Optional parameters (7)
NameTypeRequiredDescription
date_preset string Optional Shortcut date range. Overridden by explicit start_date/end_date.
last_7d last_14d last_30d
start_date string Optional Start date in YYYY-MM-DD format.
end_date string Optional End date in YYYY-MM-DD format.
campaign_id string Optional Filter to a specific campaign.
adgroup_id string Optional Filter to a specific ad group.
page integer Optional Page number (1-indexed). Default: 1.min: 1
page_size integer Optional Results per page. Default: 20.min: 1, max: 1000