TikTok Ads 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. Works on your own TikTok Ads account, connected through Get MCP Ads. Needs advertiser id, dimensions, metrics and more.
Inputs
- Advertiser ID
- Exact TikTok numeric ID, as a stringRequired · advertiserId
- Dimensions
- Age and/or gender, optionally with the ID matching dataLevelRequired · dimensions
- Metrics
- Native AUDIENCE metric keys, e.g. spend, impressions, clicks, ctr, cpc, conversionRequired · metrics
- Start date
- First date of the reporting period, in YYYY-MM-DD formatRequired · startDate
- End date
- Last date of the reporting period, in YYYY-MM-DD format, on or after startDateRequired · endDate
- Data level
- TikTok reporting aggregation level (AUCTION_ADVERTISER, AUCTION_CAMPAIGN, AUCTION_ADGROUP or AUCTION_AD)Optional · dataLevel
- Campaign IDs
- Restrict results to these campaign IDsOptional · campaignIds
- Adgroup IDs
- Restrict TikTok results to these ad group IDsOptional · adgroupIds
- Ad IDs
- Restrict results to these ad IDsOptional · adIds
- Page
- Page number to request, starting at 1Optional · page
- Limit
- Maximum number of returned items or rowsOptional · limit
- Order field
- Provider field used to order report rows (spend, impressions or clicks)Optional · 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.