`tiktok_ads_get_insights`

Get TikTok Ads Insights

Tiktok

Description

Get audience demographic breakdowns and custom dimension analysis for TikTok ads (age, gender, country, placement). Use this only when you need demographic or placement-level segmentation. For standard performance metrics (spend, clicks, conversions, CPC, CPM, CTR, cost_per_conversion, conversion_rate), use tiktok_ads_get_performance_report instead — it already includes all conversion metrics. For video/creative metrics, use tiktok_ads_get_creative_report.

Read-onlyIdempotentOpen-world

Usage

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "tiktok_ads_get_insights",
    "arguments": {}
  }
}

hopkin tiktok insights get

Flag	Type	Required	Description
`--advertiser-id`	`string`	Required	TikTok advertiser ID.
`--report-type`	`string`	Optional	Type of report. AUDIENCE for demographic breakdowns (age, gender, country). Default: BASIC.
`--data-level`	`string`	Required	Granularity level for the report.
`--dimensions`	`array`	Required	Grouping dimensions, e.g. ["campaign_id", "stat_time_day"].
`--metrics`	`array`	Optional	Metrics to retrieve. Defaults to standard funnel metrics if omitted.
`--start-date`	`string`	Optional	Start date in YYYY-MM-DD format.
`--end-date`	`string`	Optional	End date in YYYY-MM-DD format.
`--lifetime`	`boolean`	Optional	If true, return lifetime metrics instead of date-ranged.
`--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
`data_level`	`string`	Required	Granularity level for the report. `AUCTION_ADVERTISER` `AUCTION_CAMPAIGN` `AUCTION_ADGROUP` `AUCTION_AD`
`dimensions`	`array`	Required	Grouping dimensions, e.g. ["campaign_id", "stat_time_day"].
`reason`	`string`	Required	Why this tool call is neededminLength: 1, maxLength: 500

Optional parameters (7)

Name	Type	Required	Description
`report_type`	`string`	Optional	Type of report. AUDIENCE for demographic breakdowns (age, gender, country). Default: BASIC. `BASIC` `AUDIENCE`
`metrics`	`array`	Optional	Metrics to retrieve. Defaults to standard funnel metrics if omitted.
`start_date`	`string`	Optional	Start date in YYYY-MM-DD format.
`end_date`	`string`	Optional	End date in YYYY-MM-DD format.
`lifetime`	`boolean`	Optional	If true, return lifetime metrics instead of date-ranged.
`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