tiktok_ads_get_performance_report
Get TikTok Ads Performance Report
TiktokDescription
Get a performance report for a TikTok advertiser over a date range, with optional breakdowns and entity filters.
Read-onlyIdempotentOpen-world
Usage
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "tiktok_ads_get_performance_report",
"arguments": {}
}
}
hopkin tiktok performance-report get
| Flag | Type | Required | Description |
|---|---|---|---|
--advertiser-id | string | Required | TikTok advertiser ID. |
--level | string | Required | Reporting level — mapped to data_level internally. |
--date-preset | string | Optional | Shortcut date range. Overridden by explicit start_date/end_date. |
--start-date | string | Optional | Start date in YYYY-MM-DD format. |
--end-date | string | Optional | End date in YYYY-MM-DD format. |
--campaign | string | Optional | Filter to a specific campaign. |
--adgroup-id | string | Optional | Filter to a specific ad group. |
--page | integer | Optional | Page number (1-indexed). Default: 1. |
--page-size | integer | Optional | Results per page. Default: 20. |
{
"mcpServers": {
"tiktok-ads": {
"url": "https://mcp.hopkin.ai/tiktok-ads/mcp",
"transport": "sse"
}
}
}
No example prompts available.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
advertiser_id |
string |
Required | TikTok advertiser ID.minLength: 1 |
level |
string |
Required | Reporting level — mapped to data_level internally.campaign adgroup ad |
reason |
string |
Required | Why this tool call is neededminLength: 1, maxLength: 500 |
Optional parameters (7)
| Name | Type | Required | Description |
|---|---|---|---|
date_preset |
string |
Optional | Shortcut date range. Overridden by explicit start_date/end_date.last_7d last_14d last_30d |
start_date |
string |
Optional | Start date in YYYY-MM-DD format. |
end_date |
string |
Optional | End date in YYYY-MM-DD format. |
campaign_id |
string |
Optional | Filter to a specific campaign. |
adgroup_id |
string |
Optional | Filter to a specific ad group. |
page |
integer |
Optional | Page number (1-indexed). Default: 1.min: 1 |
page_size |
integer |
Optional | Results per page. Default: 20.min: 1, max: 1000 |