Список объявлений
list_adsRetrieve Yandex Direct ads with titles, texts, links, statuses, types, sitelinks, images, and videos; filter results by ad, group, or campaign IDs plus state, status, and type.
Instructions
Объявления: все заголовки и тексты, ссылки, статусы, тип и подтип объявления, привязанные сайтлинки, изображения и видео. Текстовые объявления Директ отдаёт комбинаторными (RESPONSIVE_AD). Причина отказа модерации приходит в StatusClarification. Отбор по ID объявлений, группам или кампаниям — хотя бы одно из трёх; сужается состоянием, статусом и типом. Без фильтра по состоянию архивные приходят наравне с активными. Список может быть неполным: объявления, тексты которых генерирует нейросеть Яндекса, через API недоступны и в выдачу не попадают, а по ответу это никак не видно. Поэтому «в группе только эти объявления» из ответа не следует — ни из пустого, ни из непустого; для полноты картины сверяйтесь с интерфейсом Директа.
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 |
|---|---|---|---|
| limit | No | Сколько объектов вернуть (максимум 10000) | |
| types | No | Фильтр по типу объявления | |
| ad_ids | No | Конкретные объявления по ID | |
| offset | No | Смещение выборки: сюда передаётся LimitedBy предыдущей страницы | |
| states | No | Фильтр по состоянию: ON — показывается, SUSPENDED — остановлено, ARCHIVED — в архиве | |
| statuses | No | Фильтр по статусу модерации | |
| ad_group_ids | No | Группы, объявления которых нужно выбрать | |
| campaign_ids | No | Кампании, объявления которых нужно выбрать, до 10 |