Skip to content
Get MCP AdsGet MCP Ads, home

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.

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

ParametersLink to this section

NameTypeRequiredNotes
advertiserIdstringRequiredExact TikTok numeric ID, as a string.
dataLevelstringOptionalOne of: AUCTION_ADVERTISER, AUCTION_CAMPAIGN, AUCTION_ADGROUP, AUCTION_AD. Default: "AUCTION_CAMPAIGN".
dimensionsarrayRequiredage and/or gender, optionally with the ID matching dataLevel. Multiple demographics return separate reports, never a fabricated age × gender cross-tab.
metricsarrayRequiredNative AUDIENCE metric keys, e.g. spend, impressions, clicks, ctr, cpc, conversion. Provider rejects unsupported metric combinations; BASIC metric availability does not imply AUDIENCE support.
startDatestringRequired
endDatestringRequired
campaignIdsarrayOptional
adgroupIdsarrayOptional
adIdsarrayOptional
pageintegerOptionalDefault: 1.
limitintegerOptionalDefault: 500.
orderFieldstringOptionalOne of: spend, impressions, clicks.
orderTypestringOptionalOne 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>"
  }
}
Esc

Type to search