get_statistics
Read-onlyIdempotent
Fetch performance statistics for VK Ads objects, automatically splitting large date ranges and ID lists to comply with API limits.
Instructions
Fetch performance statistics for VK Ads objects.
Retrieves statistics from GET /statistics/{object_type}/{period}.json and
returns a merged {"items": [...]} payload. The underlying client
transparently handles the API's hard limits: date ranges longer than 92 days
are split into multiple inclusive windows, and id lists longer than 50 are
chunked, with all responses merged into a single result. The caller never has
to worry about those limits.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| object_type | Yes | The object level to report on. One of: * ``"ad_plans"`` — campaign-level statistics. * ``"ad_groups"`` — ad-group-level statistics. * ``"banners"`` — banner (creative) level statistics. | |
| date_from | No | Inclusive start date in ``YYYY-MM-DD`` format (e.g. ``"2025-01-01"``). When omitted the API applies its own default window. Mostly relevant for ``period="day"``. | |
| date_to | No | Inclusive end date in ``YYYY-MM-DD`` format (e.g. ``"2025-01-31"``). Must not precede ``date_from``. When omitted the API applies its own default window. | |
| period | No | The aggregation period. One of: * ``"day"`` (default) — one row per day in the date range; use this for time-series breakdowns. * ``"summary"`` — a single aggregated total over the whole range. | day |
| ids | No | Optional list of object ids to restrict the report to (campaign, ad-group or banner ids matching ``object_type``). When omitted, statistics are returned for all objects of that type. | |
| metrics | No | The metrics group to include. One of: * ``"base"`` (default) — core delivery metrics (shows, clicks, spent, CTR, CPC, CPM, etc.). * ``"all"`` — every available metric group. * ``"uniques"`` — reach / unique-users metrics. * ``"video"`` — video-specific metrics (views, view depth, etc.). | base |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||