list_ad_groups
List ad groups in an Apple Search Ads campaign. Provide campaign ID to retrieve ad group metadata including name, status, default bid, and automated keyword opt-in. Supports pagination with limit (default 20, max 1000) and offset.
Instructions
List ad groups within a specific Apple Search Ads campaign. Requires ASA authentication; read-only. Returns ad group metadata (id, name, status, default bid, automated keyword opt-in) but not performance metrics — use get_ad_group_report for metrics. Supports pagination via limit/offset; default limit 20, max 1000.
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": {
"campaignId": "<campaignId>"
},
"name": "list_ad_groups"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| campaignId | Yes | ID of the campaign whose ad groups to list. Obtain from list_campaigns. | |
| limit | No | Max ad groups to return (1–1000). Defaults to 20. | |
| offset | No | Zero-based page offset for pagination. Defaults to 0. |