list_banners
Read-onlyIdempotent
Retrieve all banners (creatives) from your VK Ads cabinet. Supports filtering by ad group, status, and field selection for rich creative data including content and moderation status.
Instructions
List banners (creatives) in the own VK Ads cabinet.
Fetches every banner from GET /banners.json, transparently paginating
over all result pages, and returns the RAW item dicts so every requested
field reaches you for analysis. Read-only.
By default the API returns a MINIMAL field set. Pass fields to get rich
creative data, e.g. "id,status,content,textblocks,urls,moderation_status".
The content field carries the creative variants/urls. Call the
describe_fields tool with resource="banners" first to learn the full
set of valid field names.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ad_group_id | No | Restrict results to banners belonging to this ad group. Mapped to the API filter ``_ad_group_id__in``. | |
| fields | No | Optional comma-separated list of fields to request from the API. Forwarded verbatim as the ``fields`` param. Rich fields include ``content``, ``textblocks``, ``urls``, ``moderation_status`` — see ``describe_fields``. | |
| status | No | Restrict results to banners with this status (e.g. ``active``, ``blocked``). Mapped to the API filter ``_status__in``. | |
| 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 banners are returned regardless. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |