tiktok_get_audience_report

Read TikTok AUDIENCE performance reports by age or gender at advertiser, campaign, ad group or ad level, including delivery from eligible Smart+ campaigns.

Read TikTok AUDIENCE performance reports by age or gender at advertiser, campaign, ad group or ad level, including delivery from eligible Smart+ campaigns. Multiple demographics return separate reports, not a joint distribution. Explicit pagination and native provider errors; no inference of configured targeting or Custom Audience membership.

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	Exact TikTok numeric ID, as a string.
`dataLevel`	string	Optional	TikTok reporting aggregation level. Metrics and dimensions must be compatible with this level. One of: `AUCTION_ADVERTISER`, `AUCTION_CAMPAIGN`, `AUCTION_ADGROUP`, `AUCTION_AD`. Default: `"AUCTION_CAMPAIGN"`.
`dimensions`	array	Required	age and/or gender, optionally with the ID matching dataLevel. Multiple demographics return separate reports, never a fabricated age × gender cross-tab.
`metrics`	array	Required	Native AUDIENCE metric keys, e.g. spend, impressions, clicks, ctr, cpc, conversion. Provider rejects unsupported metric combinations; BASIC metric availability does not imply AUDIENCE support.
`startDate`	string	Required	First date of the reporting period, in YYYY-MM-DD format.
`endDate`	string	Required	Last date of the reporting period, in YYYY-MM-DD format, on or after startDate.
`campaignIds`	array	Optional	Restrict results to these campaign IDs.
`adgroupIds`	array	Optional	Restrict TikTok results to these ad group IDs.
`adIds`	array	Optional	Restrict results to these ad IDs.
`page`	integer	Optional	Page number to request, starting at 1. Default: `1`.
`limit`	integer	Optional	Maximum number of returned items or rows. The declared bounds and default apply; use pagination for additional results. Default: `500`.
`orderField`	string	Optional	Provider field used to order report rows. One of: `spend`, `impressions`, `clicks`.
`orderType`	string	Optional	Sort direction for the selected ordering field. One of: `ASC`, `DESC`.

Calling itLink to this section

jsonDirectly, since it is announced

{
  "name": "tiktok_get_audience_report",
  "arguments": {
    "advertiserId": "<string>",
    "dimensions": "<array>",
    "metrics": "<array>",
    "startDate": "<string>",
    "endDate": "<string>"
  }
}