TikTok Ads insights

Query TikTok Ads performance insights using the current native/calculated metric catalog and query planning. Works on your own TikTok Ads account, connected through Get MCP Ads. Needs advertiser id, metrics, start date and more.

Inputs

4 required

Advertiser ID: TikTok advertiser IDRequired · advertiserId
Metrics: Metric keys from tiktok://metrics (e.g., spend, impressions, clicks)Required · metrics
Start date: Start date YYYY-MM-DDRequired · startDate
End date: End date YYYY-MM-DDRequired · endDate
Report type: Defaults to AUDIENCE for age/gender, BASIC otherwise (BASIC or AUDIENCE)Optional · reportType
Dimensions: Dimension keys from tiktok://dimensions (e.g., stat_time_day, campaign_id)Optional · dimensions
Data level: TikTok reporting aggregation level (AUCTION_ADVERTISER, AUCTION_CAMPAIGN, AUCTION_ADGROUP or AUCTION_AD)Optional · dataLevel
Query lifetime: Query lifetime metrics (cannot use time dimensions)Optional · queryLifetime
Campaign IDs: Restrict audience reports to these campaignsOptional · campaignIds
Adgroup IDs: Restrict audience reports to these ad groupsOptional · adgroupIds
Page: AUDIENCE report page; follow nextPageOptional · page
Ad IDs: Restrict AUCTION_AD reports to these ad IDs, including daily trendsOptional · adIds
Order field: Order the native report before limiting rows (spend, impressions or clicks)Optional · orderField
Order type: Native sort direction; defaults to DESC when orderField is selected (ASC or DESC)Optional · orderType
Limit: Maximum number of returned items or rowsOptional · limit
Workspace ID: Authorized workspace ID from list_accounts/list_workspacesOptional · workspace_id

Pricing

Price: $0.005 per call
Billing: The provider’s price, with no markup. Billed for measured usage.

Call

Your agent reads the schema and the price with inspect_tool before it runs the tool.

MCP call
cURL command
TypeScript
Tool ID

Alternatives

TikTok Ads reporting

Connect your agent to 2,400+ tools for free

Get $5 free credit Get $5 free credit