tiktok get adgroups
tiktok_get_adgroupsRead full native ad group configuration: targeting, audiences, geo, placements, budget, schedule. Set smartPlus:true for Smart+ ad groups. Paginated.
Instructions
Read full native ad group configuration including targeting, custom/lookalike audience references and exclusions, geo, language, age/gender, placements, interests/behaviors, budget and schedule. Set smartPlus:true for upgraded Smart+ targeting_spec. Missing fields are unknown, not unrestricted targeting. Paginated.
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_adgroups"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | Page number to request, starting at 1. | |
| limit | No | Maximum number of returned items or rows. The declared bounds and default apply; use pagination for additional results. | |
| smartPlus | No | Use true for upgraded Smart+ ad groups: reads their native targeting_spec and exact placements via smart_plus/adgroup/get. No fallback to classic settings. | |
| adgroupIds | No | Restrict TikTok results to these ad group IDs. | |
| campaignId | No | Exact TikTok numeric ID, as a string. | |
| advertiserId | Yes | Exact TikTok numeric ID, as a string. |
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. |