Яндекс Wordstat. Руководство разработчика
Яндекс Wordstat - Коды ошибок
При некорректной обработке поисковых запросов ответ будет содержать тег error
Пример ответа с ошибкой:

Коды возможных ошибок
В таблице ниже приведены коды и описания ошибок, которые могут возвращаться в ответе.
При этом HTTP-Code сервера = 200
| Код ошибки | Описание ошибки |
|---|---|
| 1 | Текст запроса (query) содержит синтаксическую ошибку. Например, переданы два идущих подряд слеша (//). |
| 2 | Задан пустой поисковый запрос (в элементе query передано пустое значение). |
| 3-9 | Не верно указано значение для параметра groupby, pagetype, period, device, start, end, regions, distributionby. |
| 10 | Для дневной статистики можно запрашивать данные только за последние 60 дней. Данные доступны только начиная с 1 января 2018 года. |
| 19 | В поисковом запросе переданы несовместимые параметры/значения. |
| 20, 300 | Неизвестная ошибка. Причина ошибки не может быть установлена. При повторном получении этой ошибки обратитесь в техническую поддержку. |
| 32 | Превышено ограничение на количество допустимых суточных запросов |
| 55 | Превышено максимально допустимое количество запросов в секунду. |
| 101 | Сервис сбора данных WordstatAPI временно отключен. Ведутся технические работы, попробуйте позже. |
| 10001, 10002 | Задан слишком длинный поисковый запрос. Длина запроса не должна превышать 400 символов/40 слов. |
| 200 | На вашем счету закончились деньги. Для дальнейшей работы пополните баланс в системе XMLstock.com Ранее использовался код: -32 |
| -34 | Не корректный ID пользователя или ключ |
Обращаем ваше внимание, что ответы с кодами 1,19,10001,10002 тарифицируются в соответствии с тарифным планом, за ответы с иными кодами ошибок тарификация не ведется.
Ошибки сервера
Также может возникнуть ситуация, когда возникает ошибка сервера. При этом он возвращает HTTP-Code, отличный от 200-го. Это означает, что запрос не обработан и что-то пошло не так. Деньги за такие запросы не списываются.
| HTTP-код ошибки сервера | Описание ошибки |
|---|---|
| 500-502 | Внутренняя ошибка сервера. Необходимо сделать перезапрос. |
| 503 | Превышено максимально допустимое количество запросов в секунду/минуту. |

