tiktok_ get_ insights
Query TikTok Ads performance insights. One of 32 TikTok Ads tools on the Get MCP Ads MCP gateway.
Query TikTok Ads performance insights. Supports 400+ metrics with intelligent query planning. Use tiktok://metrics resource to see available metrics. Use tiktok://dimensions for dimensions. The query planner automatically splits requests when dimension combinations are incompatible (only 1 ID dimension + 1 time dimension allowed per request).
- 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. |
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 | One of: AUCTION_, AUCTION_CAMPAIGN, AUCTION_ADGROUP, AUCTION_AD. Default: "AUCTION_. |
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. |
limit | integer | Optional | Default: 500. |
Calling itLink to this section
{
"name": "tiktok_get_insights",
"arguments": {
"advertiserId": "<string>",
"metrics": "<array>",
"startDate": "<string>",
"endDate": "<string>"
}
}