Skip to content
Get MCP AdsGet MCP Ads, home
Start free

tiktok_get_report_raw

Run a native TikTok synchronous report with caller-selected dimensions and metrics. One of 32 TikTok Ads tools on the Get MCP Ads MCP gateway.

Run a native TikTok synchronous report with caller-selected dimensions and metrics. 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.

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

NameTypeRequiredNotes
advertiserIdstringRequired
serviceTypestringOptionalOne of: AUCTION, RESERVATION. Default: "AUCTION".
reportTypestringOptionalOne of: BASIC, AUDIENCE, PLAYABLE_MATERIAL, CATALOG, BC. Default: "BASIC".
dataLevelstringRequiredOne of: AUCTION_ADVERTISER, AUCTION_CAMPAIGN, AUCTION_ADGROUP, AUCTION_AD, RESERVATION_ADVERTISER, RESERVATION_CAMPAIGN, RESERVATION_ADGROUP, RESERVATION_AD.
dimensionsarrayRequired
metricsarrayRequired
startDatestringOptional
endDatestringOptional
queryLifetimebooleanOptionalDefault: false.
filteringarrayOptional
pageintegerOptionalDefault: 1.
pageSizeintegerOptionalDefault: 1000.
orderFieldstringOptional
orderTypestringOptionalOne 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>"
    }
  }
}
Esc

Type to search