Общий порядок подключения

Для подключения и начала использования Яндекс.XML выполните следующие действия:

  1. Зарегистрируйте IP-адрес, с которого планируется отправлять поисковые запросы.

  2. Отправьте тестовый запрос.

    Убедитесь, что запросы успешно отправляются с указанного IP-адреса:

    • Отправьте запрос из интерфейса сервиса. Обращение к интерфейсу должно выполняться с компьютера, которому выделен IP-адрес, указанный при регистрации.

    • Сформируйте и отправьте запрос методом GET с компьютера, которому выделен IP-адрес, указанный при регистрации. Например, если при регистрации в поле Ваш адрес для совершения запроса возвращена строка «https://yandex.ru/search/xml?user=test-yandex&key=09.31114:e650g7j» используйте следующий GET-запрос:

      https://yandex.ru/search/xml?user=test-yandex&key=09.31114:e650g7j&query=yandex
      
  3. Проверьте полученный XML-документ.

    Ответ должен соответствовать заданному формату и не должен содержать ошибок.

    Примечание

    Если по поисковому запросу отсутствуют результаты, допустима ошибка с кодом «15».

  4. Зарегистрируйте свои сайты в сервисе Яндекс.Вебмастер. После регистрации определяются индивидуальные ограничения для текущего пользователя.

  5. Ознакомьтесь с суточными и часовым ограничениями на странице Информация о лимитах.

    Яндекс.XML может быть использован только на тех сайтах, у которых в сервисе Яндекс.Вебмастер текущий пользователь самостоятельно подтвердил права на сайт (они не были делегированы другим пользователем).

  6. Настройте параметры запросов.

    Поддерживаются методы GET и POST.

  7. Ознакомьтесь с форматом ответа.

  8. Настройте обработку ответа.

    При оформлении результатов поиска необходимо придерживаться требований к оформлению.

  9. При необходимости. Запросите информацию о часовых ограничениях на ближайшие сутки.

  10. Опционально. Настройте защиту от роботов.