tiktok_get_insights

Query TikTok Ads performance insights using the current native/calculated metric catalog and query planning.

Query TikTok Ads performance insights using the current native/calculated metric catalog and query planning. Use tiktok://metrics resource to see available metrics. Use tiktok://dimensions for dimensions. Age/gender dimensions route automatically to AUDIENCE reports via tiktok_get_audience_report, including campaign/ad group levels. Other dimensions use the BASIC planner. Multiple audience breakdowns remain separate reports, never joined.

Source: TikTok Ads
Kind: Read
Discovery: Announced in the tool list
Account parameter: advertiserId
Endpoint: https://mcp.getmcpads.com/tiktok-ads/mcp

ParametersLink to this section

Name	Type	Required	Notes
`advertiserId`	string	Required	TikTok advertiser ID.
`reportType`	string	Optional	Defaults to AUDIENCE for age/gender, BASIC otherwise. Explicit BASIC with demographics is rejected. One of: `BASIC`, `AUDIENCE`.
`metrics`	array	Required	Metric keys from tiktok://metrics (e.g., spend, impressions, clicks)
`dimensions`	array	Optional	Dimension keys from tiktok://dimensions (e.g., stat_time_day, campaign_id)
`dataLevel`	string	Optional	TikTok reporting aggregation level. Metrics and dimensions must be compatible with this level. One of: `AUCTION_ADVERTISER`, `AUCTION_CAMPAIGN`, `AUCTION_ADGROUP`, `AUCTION_AD`. Default: `"AUCTION_CAMPAIGN"`.
`startDate`	string	Required	Start date YYYY-MM-DD.
`endDate`	string	Required	End date YYYY-MM-DD.
`queryLifetime`	boolean	Optional	Query lifetime metrics (cannot use time dimensions) Default: `false`.
`campaignIds`	array	Optional	Restrict audience reports to these campaigns.
`adgroupIds`	array	Optional	Restrict audience reports to these ad groups.
`page`	integer	Optional	AUDIENCE report page; follow nextPage.
`adIds`	array	Optional	Restrict AUCTION_AD reports to these ad IDs, including daily trends.
`orderField`	string	Optional	Order the native report before limiting rows. Include this metric in metrics. One of: `spend`, `impressions`, `clicks`.
`orderType`	string	Optional	Native sort direction; defaults to DESC when orderField is selected. One of: `ASC`, `DESC`.
`limit`	integer	Optional	Maximum number of returned items or rows. The declared bounds and default apply; use pagination for additional results. Default: `500`.

Calling itLink to this section

jsonDirectly, since it is announced

{
  "name": "tiktok_get_insights",
  "arguments": {
    "advertiserId": "<string>",
    "metrics": "<array>",
    "startDate": "<string>",
    "endDate": "<string>"
  }
}