Read TikTok Ads performance
get_tiktok_ads_performanceThe connected TikTok advertiser's results for a date range, from what the daily pull stored: totals and per-campaign spend, impressions, clicks, CTR, CPC, CPM, conversions, cost per conversion, purchases, purchase value and ROAS, most spend first. Money is in the advertiser's currency (currencyCode); conversions follow the ad account's attribution setting. Days are in the advertiser's time zone; at most 90 days. Read-only; uses no credits.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"projectId": "<projectId>"
},
"name": "get_tiktok_ads_performance"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| endDate | No | Last day (YYYY-MM-DD). Use with startDate. Without both, the last 30 stored days. At most 90 days. | |
| projectId | Yes | Required. The Visibility Genies project this call works in and is billed to. Call list_projects to find one. | |
| startDate | No | First day (YYYY-MM-DD, the advertiser's time zone). Use with endDate. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ok | Yes | ||
| meta | No | ||
| reason | No | ||
| totals | No | ||
| endDate | No | ||
| message | No | ||
| failedAt | No | ||
| campaigns | No | ||
| startDate | No | ||
| connectUrl | No | ||
| accountName | No | ||
| currencyCode | No | ||
| storedThrough | No | ||
| needsReconnect | No |