Skip to content
Get MCP AdsGet MCP Ads, home
Start free

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).

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

ParametersLink to this section

NameTypeRequiredNotes
advertiserIdstringRequiredTikTok advertiser ID.
metricsarrayRequiredMetric keys from tiktok://metrics (e.g., spend, impressions, clicks)
dimensionsarrayOptionalDimension keys from tiktok://dimensions (e.g., stat_time_day, campaign_id)
dataLevelstringOptionalOne of: AUCTION_ADVERTISER, AUCTION_CAMPAIGN, AUCTION_ADGROUP, AUCTION_AD. Default: "AUCTION_CAMPAIGN".
startDatestringRequiredStart date YYYY-MM-DD.
endDatestringRequiredEnd date YYYY-MM-DD.
queryLifetimebooleanOptionalQuery lifetime metrics (cannot use time dimensions) Default: false.
limitintegerOptionalDefault: 500.

Calling itLink to this section

jsonDirectly, since it is announced
{
  "name": "tiktok_get_insights",
  "arguments": {
    "advertiserId": "<string>",
    "metrics": "<array>",
    "startDate": "<string>",
    "endDate": "<string>"
  }
}
Esc

Type to search