list_ads
Retrieve Yandex Direct ads by ad group or campaign IDs. Filter by state (ON, OFF, SUSPENDED, REJECTED, ARCHIVED) and set result limit.
Instructions
List ads for given ad groups or campaigns.
Args: ad_group_ids: Filter by ad group IDs (preferred for precision). campaign_ids: Filter by campaign IDs. states: Filter by state — ON, OFF, SUSPENDED, REJECTED, ARCHIVED. limit: Max results.
At least one of ad_group_ids or campaign_ids is required.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "list_ads"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ad_group_ids | No | ||
| campaign_ids | No | ||
| states | No | ||
| limit | No |