`tiktok_ads_get_insights`

Get TikTok Ads Insights

Tiktok

Description

Get aggregated insights and analytics for TikTok ad entities with custom dimensions (age, gender, country, placement). Use this for audience demographic breakdowns and flexible dimension-based analysis — for video/creative metrics, use tiktok_ads_get_creative_report instead.

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://mcp.hopkin.ai/tiktok-ads/mcp",
      "transport": "sse"
    }
  }
}

No example prompts available.

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