list_ad_groups
Retrieve all ad groups from your VK Ads cabinet, optionally filtered by campaign, status, and fields. Use to analyze targeting, banners, and UTM parameters.
Instructions
List ad groups (VK Ads ad_group objects) in the connected cabinet.
Ad groups live inside campaigns (ad_plan objects) and contain the
individual banners (creatives). This read-only tool drains every page of
the /ad_groups.json listing endpoint and returns the RAW item dicts so
every requested field reaches you for analysis.
By default the API returns a MINIMAL field set. Pass fields to get rich
data, e.g. "id,name,status,targetings,utm,banners,package_id". The
targetings field exposes age/gender/geo/interests. Call the
describe_fields tool with resource="ad_groups" first to learn the
full set of valid field names.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ad_plan_id | No | Restrict results to ad groups belonging to this campaign (``ad_plan``) id. Sent to the API as the ``_ad_plan_id__in`` filter. When omitted, ad groups from every campaign are returned. | |
| fields | No | Optional comma-separated list of object fields to request from the API. Forwarded verbatim as the ``fields`` query parameter. Rich fields include ``targetings``, ``utm``, ``banners``, ``package_id`` — see ``describe_fields``. | |
| status | No | Restrict results to ad groups with this status (e.g. ``"active"`` or ``"blocked"``). Sent to the API as the ``_status__in`` filter. | |
| sorting | No | Optional sort spec, e.g. ``"-id"`` or ``"id"``. Forwarded verbatim as the ``sorting`` query parameter. | |
| limit | No | Page size for pagination (1-50). The API caps page size at 50; larger values are clamped. This affects request batching only — all matching ad groups are returned regardless. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |