TikTok Ads report raw
Run a native TikTok BASIC or AUDIENCE synchronous report with caller-selected dimensions and metrics. Works on your own TikTok Ads account, connected through Get MCP Ads. Needs advertiser id, data level, dimensions and more.
Inputs
- Advertiser ID
- TikTok advertiser account ID as a stringRequired · advertiserId
- Data level
- TikTok reporting aggregation levelRequired · dataLevel
- Dimensions
- Native reporting dimensionsRequired · dimensions
- Metrics
- Native or documented calculated metric names to requestRequired · metrics
- Service type
- TikTok report service category (AUCTION or RESERVATION)Optional · serviceType
- Report type
- Native provider report type; determines supported metrics and dimensions (BASIC, AUDIENCE, PLAYABLE_MATERIAL, CATALOG or BC)Optional · reportType
- Start date
- First date of the reporting period, in YYYY-MM-DD formatOptional · startDate
- End date
- Last date of the reporting period, in YYYY-MM-DD format, on or after startDateOptional · endDate
- Query lifetime
- Request lifetime reporting instead of the explicit reporting period where TikTok supports itOptional · queryLifetime
- Filtering
- Native provider filter expressions; credentials and account overrides are not allowedOptional · filtering
- Page
- Page number to request, starting at 1Optional · page
- Page size
- Maximum items requested per pageOptional · pageSize
- Order field
- Provider field used to order report rowsOptional · orderField
- Order type
- Sort direction for the selected ordering field (ASC or DESC)Optional · orderType
- Workspace ID
- Authorized workspace ID from list_accounts/list_workspacesOptional · workspace_id
Pricing
- Price
- $0.005 per call
- Billing
- The provider’s price, with no markup. Billed for measured usage.
Call
Your agent reads the schema and the price with inspect_tool before it runs the tool.
- MCP call
- cURL command
- TypeScript
- Tool ID
Alternatives
Connect your agent to 2,400+ tools for free
Sign in with Google or GitHub. No card required.