菜单
Узкий актуальный справочник по Yandex Search API Wordstat v2: методы, схемы, авторизация, квоты, регионы, устройства и динамика. Для рекламного процесса сначала использовать yandex-direct-unified.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
| name | yandex-wordstat |
| description | Узкий актуальный справочник по Yandex Search API Wordstat v2: методы, схемы, авторизация, квоты, регионы, устройства и динамика. Для рекламного процесса сначала использовать yandex-direct-unified. |
Этот файл не задает порядок сбора семантики, смысловые решения, минус-слова, структуру кампаний или готовность к сборке.
Для любых задач Яндекс.Директа, ключевых фраз, SQR, семантики и стоп-слов сначала открыть yandex-direct-unified, его обязательные references и keyword-collection-runbook.md. Этот файл использовать только как справочник по текущему Wordstat API.
https://searchapi.api.cloud.yandex.net.https://api.wordstat.yandex.net/v1/* и метод userInfo не использовать.folderId передается в теле каждого запроса.Разрешены два варианта:
Authorization: Api-Key <key>.Authorization: Bearer <iam-token>.Для API-ключа нужна область yc.search-api.execute, а сервисному аккаунту или пользователю — роль search-api.webSearch.user на нужный каталог.
Секреты нельзя печатать, передавать в аргументах процесса или сохранять в raw/manifest. Канонический credential-файл должен находиться в закрытом каталоге 700, иметь владельца рабочего пользователя и права 600.
Устройства:
DEVICE_ALL;DEVICE_DESKTOP;DEVICE_PHONE;DEVICE_TABLET.Если передается список devices, в нем не более трех значений. Для topRequests и dynamics список regions содержит не более 100 строковых ID.
POST /v2/wordstat/topRequestsНазначение: спрос за последние 30 дней, популярные вложенные фразы и ассоциации.
Запрос:
{
"phrase": "обязательная фраза до 400 символов",
"numPhrases": 2000,
"regions": ["регион"],
"devices": ["DEVICE_ALL"],
"folderId": "каталог"
}
numPhrases: от 1 до 2000.
Ответ:
{
"totalCount": 0,
"results": [{"phrase": "...", "count": 0}],
"associations": [{"phrase": "...", "count": 0}]
}
Ассоциаций в одном ответе бывает не более 20. Для Директа и results, и associations сохраняются как raw и дальше проходят только workflow yandex-direct-unified.
POST /v2/wordstat/dynamicsНазначение: динамика спроса.
Запрос:
{
"phrase": "обязательная фраза до 400 символов",
"period": "PERIOD_MONTHLY",
"fromDate": "2026-01-01T00:00:00Z",
"toDate": "2026-07-01T00:00:00Z",
"regions": ["регион"],
"devices": ["DEVICE_ALL"],
"folderId": "каталог"
}
Периоды: PERIOD_MONTHLY, PERIOD_WEEKLY, PERIOD_DAILY. Даты передаются в RFC3339. Для недельной и месячной динамики допустим только оператор +; для дневной поддерживаются все операторы Wordstat.
Ответ:
{
"results": [{"date": "2026-01-01T00:00:00Z", "count": 0, "share": 0.0}]
}
POST /v2/wordstat/regionsНазначение: распределение спроса за последние 30 дней.
Запрос:
{
"phrase": "обязательная фраза до 400 символов",
"region": "REGION_ALL",
"devices": ["DEVICE_ALL"],
"folderId": "каталог"
}
Значения region: REGION_ALL, REGION_CITIES, REGION_REGIONS. Путь /v2/wordstat/regionsDistribution неверен: это было смешение имени gRPC-метода с REST-путем.
Ответ:
{
"results": [
{"region": "ID", "count": 0, "share": 0.0, "affinityIndex": 0.0}
]
}
POST /v2/wordstat/getRegionsTreeНазначение: дерево поддерживаемых регионов.
Запрос содержит только folderId:
{"folderId": "каталог"}
Ответ:
{
"regions": [
{"id": "ID", "label": "Название", "children": []}
]
}
Метод официально не тарифицируется, но лишние вызовы запрещены.
topRequests, dynamics, regions и getRegionsTree; дерево регионов имеет нулевую стоимость, но потребляет запрос квоты.userInfo и ответа с остатком дневной квоты.Retry-After.wordstat_errors_retry_log.tsv; волна не закрывается, пока повтор не дал результат либо маска явно не помечена blocked с причиной.Поддерживаются операторы Wordstat -, +, !, кавычки, квадратные и круглые скобки. Их семантика применяется по официальной документации Wordstat. Операторная форма маски не является автоматически готовым ключом Директа.
intake-gate, product/routing/protected layers и pre-Wordstat извлечение синонимов.SAFE_STOP только с protected-check, сохраняемый prefilter, затем полный построчный смысловой разбор.PASS.candidate_id либо явное решение с причиной.Безопасная OAuth-авторизация amoCRM, чтение схемы аккаунта и сверка заявок по источнику, времени, статусу, ответственному и внешней ссылке.
Исследование коммерческого спроса по нише, географии, товару или услуге через Wordstat до перехода к рекламной семантике.
Чтение отчётов Roistat, воспроизводимая сверка с сырыми сделками и коллтрекингом, а также строго ограждённая запись сохранённых отчётов.
Расследование, остановка и контроль расходов Yandex Cloud Search API без раскрытия доступов.
Совместимый переходник: жизненный цикл клиента Яндекс.Директа ведётся через yandex-direct-unified.
Единая точка входа для безопасной работы с Яндекс.Директом: авторизация, чтение кабинета, Метрика, Wordstat, семантика, подготовка изменений и контролируемая запись.