List ad campaigns
list_campaignsFetch a paginated list of ad campaigns with filters for status, type, dates, and managers. Also returns weekly API point balance.
Instructions
Lists the account's ad campaigns, one page at a time. Returns {total, items, page, limit, hasNextPage} plus apiPointBalance — the weekly API points left, which refill Mondays 00:00 UTC. Each campaign carries id, name, status, budget (rubles), paymentModel (CPM/CPC), campaignType, startDate/endDate, advertiserId, contractId, managerID and timestamps. All filter fields are AND-ed and each list keeps only the values it names. This API cannot create, edit, pause, resume, archive or delete a campaign and cannot touch its targeting — the only writes available anywhere are change_group_budget and change_group_price on an ad group.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ids | No | Campaign ids to keep. | |
| page | No | 1-based page number. Default 1. | |
| limit | No | Page size, 1..100. Default 20. | |
| filter | No | Escape hatch: extra filter keys merged as-is into the request filter (API spelling). The named fields above win on conflict. | |
| managers | No | Manager (account user) ids whose campaigns to keep. | |
| statuses | No | Campaign statuses to keep: draft, in_moderation, moderation_failed, partial_moderation, active, paused, stopped, finished, archived. | |
| createdAt | No | Keep campaigns created in this range: {from, to}, YYYY-MM-DD. | |
| timeFrame | No | Keep campaigns whose flight window falls in this range: {from, to}, YYYY-MM-DD. | |
| advertisers | No | Advertiser ids whose campaigns to keep. | |
| contractIds | No | Contract ids whose campaigns to keep. | |
| campaignTypes | No | Campaign types to keep: textImage, HTML, video. | |
| paymentModels | No | Payment models to keep: CPM, CPC. | |
| additionalAgreementIds | No | Additional-agreement ids whose campaigns to keep. |