tiktok_get_report_raw

Run a native TikTok BASIC or AUDIENCE synchronous report with caller-selected dimensions and metrics.

Run a native TikTok BASIC or AUDIENCE synchronous report with caller-selected dimensions and metrics. AUDIENCE supports demographics such as age/gender at campaign/adgroup levels; tiktok_get_audience_report provides a guided path. Use when a current API field is not yet in tiktok://metrics; unlike tiktok_get_insights, this tool does not calculate aliases or auto-split incompatible selections.

Source: TikTok Ads
Kind: Read
Discovery: Reachable through search_tools and run_tool
Account parameter: advertiserId
Endpoint: https://mcp.getmcpads.com/tiktok-ads/mcp

ParametersLink to this section

Name	Type	Required	Notes
`advertiserId`	string	Required	TikTok advertiser account ID as a string.
`serviceType`	string	Optional	TikTok report service category. One of: `AUCTION`, `RESERVATION`. Default: `"AUCTION"`.
`reportType`	string	Optional	Native provider report type; determines supported metrics and dimensions. One of: `BASIC`, `AUDIENCE`, `PLAYABLE_MATERIAL`, `CATALOG`, `BC`. Default: `"BASIC"`.
`dataLevel`	string	Required	TikTok reporting aggregation level. Metrics and dimensions must be compatible with this level. One of: `AUCTION_ADVERTISER`, `AUCTION_CAMPAIGN`, `AUCTION_ADGROUP`, `AUCTION_AD`, `RESERVATION_ADVERTISER`, `RESERVATION_CAMPAIGN`, `RESERVATION_ADGROUP`, `RESERVATION_AD`.
`dimensions`	array	Required	Native reporting dimensions. Validate compatibility with the selected metrics.
`metrics`	array	Required	Native or documented calculated metric names to request. Check compatibility with the selected dimensions.
`startDate`	string	Optional	First date of the reporting period, in YYYY-MM-DD format.
`endDate`	string	Optional	Last date of the reporting period, in YYYY-MM-DD format, on or after startDate.
`queryLifetime`	boolean	Optional	Request lifetime reporting instead of the explicit reporting period where TikTok supports it. Default: `false`.
`filtering`	array	Optional	Native provider filter expressions; credentials and account overrides are not allowed.
`page`	integer	Optional	Page number to request, starting at 1. Default: `1`.
`pageSize`	integer	Optional	Maximum items requested per page. Follow the returned pagination information for remaining results. Default: `1000`.
`orderField`	string	Optional	Provider field used to order report rows.
`orderType`	string	Optional	Sort direction for the selected ordering field. One of: `ASC`, `DESC`.

Calling itLink to this section

jsonThrough run_tool, since it is not announced

{
  "name": "run_tool",
  "arguments": {
    "name": "tiktok_get_report_raw",
    "args": {
      "advertiserId": "<string>",
      "dataLevel": "AUCTION_ADVERTISER",
      "dimensions": "<array>",
      "metrics": "<array>"
    }
  }
}