Коды ошибок

При некорректной обработке поисковых запросов ответ сервера содержит тег error.

Формат:

<error code="код ошибки">
        Текстовое описание ошибки</error>
        

В таблице ниже приведены коды и описания наиболее распространенных ошибок, возникающих при обработке поисковых запросов.

Код ошибки

Описание

1

Текст запроса (значение, переданное в поле query) содержит синтаксическую ошибку.

Например, в качестве запроса переданы два идущих подряд символа слеш (//).

2

Задан пустой поисковый запрос (в поле query передано пустое значение).

15

Для заданного поискового запроса отсутствуют результаты поиска.

18

Передаваемый XML-файл не может быть валидирован или заданы некорректные параметры запроса. Возможные причины:

  • переданы некорректные теги или значения тегов;
  • тело запроса содержит неэкранированные специальные символы. Например, символ амперсанд (&) и т.п.;
  • запрошена страница, содержащая результаты поиска, позиции которых превышают 1000. Например, если каждая страница содержит 10 результатов, ошибка будет возвращена при попытке запросить 101 и последующие страницы с результатами.

19

В поисковом запросе переданы несовместимые параметры (например, несовместимые значения элемента groupings).

20

Причина ошибки не может быть установлена. При повторном получении этой ошибки обратитесь в техническую поддержку.

31

В запросе передан идентификатор каталога (поле folderid), пользователь которого не прошел регистрацию в сервисе Yandex Search API.

32

Превышено ограничение на количество допустимых суточных запросов. Ознакомьтесь с информацией об ограничениях и запросите увеличение квот.

33

IP-адрес, с которого отправлен поисковый запрос, не совпадает с заданным(и) при регистрации.

37

Ошибка в параметрах запроса. Возможно, не введены обязательные или определены взаимоисключающие.

42

Переданный API-ключ не прошел аутентификацию или авторизацию. Проверьте корректность API-ключа, а также наличие роли search-api.executor у сервисного аккаунта, используемого для отправки запросов.

44

Адрес, по которому выполняется обращение, больше не поддерживается. Необходимо скорректировать значение в соответствии с адресом, указанным при регистрации.

48

Тип поиска, указанный при регистрации, не совпадает с типом, используемым для запроса данных. Исправьте тип поиска в запросе или в консоли управления.

55

Превышено максимально допустимое количество запросов в секунду.

100

Существует высокая вероятность, что запрос отправлен роботом. При проявлении данной ошибки пользователю необходимо вернуть капчу.

10002

Превышено максимальное количество слов в поисковом запросе.