`tiktok_ads_get_performance_report`

Get TikTok Ads Performance Report

Tiktok

Description

Get a performance report for a TikTok advertiser. Returns spend, impressions, clicks, CPC, CPM, CTR, reach, frequency, conversions, cost_per_conversion, conversion_rate, result, and cost_per_result — broken down by day. Supports entity filters: pass campaign_id to get only ads/ad groups within a specific campaign, or adgroup_id to narrow to a specific ad group. This is the primary tool for standard delivery and conversion performance — use get_insights only for audience demographic breakdowns (age, gender, country).

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

Flag	Type	Required	Description
`--advertiser-id`	`string`	Required	TikTok advertiser ID.
`--level`	`string`	Required	Reporting level — mapped to data_level internally.
`--date-preset`	`string`	Optional	Shortcut date range. Overridden by explicit start_date/end_date.
`--start-date`	`string`	Optional	Start date in YYYY-MM-DD format.
`--end-date`	`string`	Optional	End date in YYYY-MM-DD format.
`--campaign`	`string`	Optional	Filter results to a specific campaign by its ID. When the user asks about a specific campaign, always pass this parameter to scope the report.
`--adgroup-id`	`string`	Optional	Filter to a specific ad group.
`--page`	`integer`	Optional	Page number (1-indexed). Default: 1.
`--page-size`	`integer`	Optional	Results per page. Default: 20.

{
  "mcpServers": {
    "tiktok-ads": {
      "url": "https://tiktok.mcp.hopkin.ai",
      "transport": "sse"
    }
  }
}

Parameters

Name	Type	Required	Description
`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)

Name	Type	Required	Description
`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 results to a specific campaign by its ID. When the user asks about a specific campaign, always pass this parameter to scope the report.
`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

Description

Usage

Parameters

Related Tools