tiktok get search ads maturity
tiktok_get_search_ads_maturityDiagnose TikTok Search Ads maturity from keyword and search-term reporting, and optionally validate seed keywords via recommendation endpoints. Read-only diagnostics.
Instructions
Diagnose TikTok Search Ads maturity from keyword/search-term reporting and optional keyword recommendation endpoints. Read-only diagnostics only.
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": {
"advertiserId": "<advertiserId>"
},
"name": "tiktok_get_search_ads_maturity"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Maximum number of returned items or rows. The declared bounds and default apply; use pagination for additional results. | |
| endDate | No | End date YYYY-MM-DD. Defaults to today. | |
| dataLevel | No | TikTok reporting aggregation level. Metrics and dimensions must be compatible with this level. | AUCTION_ADGROUP |
| startDate | No | Start date YYYY-MM-DD. Defaults to 14 days ago. | |
| advertiserId | Yes | TikTok advertiser ID | |
| seedKeywords | No | Optional seed keywords for keyword recommendation endpoint diagnostics. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes | Original tool result: parsed JSON when the text is JSON, otherwise the text or multiple MCP content blocks. Provider fields depend on the selected query. |