О сервисе Yandex Search API

Сервис Yandex Search API позволяет автоматически отправлять запросы к поисковой базе Яндекса, получая в ответ поисковую выдачу. Сервис предназначен для разработчиков и вебмастеров.

С помощью Search API можно организовать поиск по сайту, группе сайтов или интернету, а также создать приложение, использующее возможности поиска. Кроме того, сервис дает возможность отслеживать позиции сайтов по поисковым запросам в поисковой выдаче Яндекса.

Сервис Search API предоставляет два интерфейса для выполнения запросов: API v1 и API v2.

Интерфейс API v1Интерфейс API v1

API v1 — интерфейс, совместимый с Яндекс XML. Интерфейс позволяет выполнять текстовые запросы методами GET и POST, получая результат в формате XML или HTML в синхронном режиме.

Также с помощью интерфейса API v1 вы можете использовать текстовый поиск в сочетании с генеративными возможностями YandexGPT. Это позволяет получить единый емкий и понятный генеративный ответ, при формировании которого нейросеть анализирует релевантные результаты текстового поиска Search API по сайтам.

Интерфейс API v1 Search API дает возможность получать результаты поиска по умолчанию и поиска, оптимизированного для мобильных устройств.

В дополнение к различным вариантам текстового поиска API v1 позволяет искать изображения по текстовым запросам. Поиск по картинкам поддерживает только GET-метод отправки запросов.

Чтобы использовать интерфейс API v1, необходимо зарегистрироваться в сервисе Search API:

• Задать список доверенных IP-адресов, которые вы будете использовать для отправки поисковых запросов.

• Выбрать один из трех доступных типов текстового поиска:

  • Русский
  • Турецкий
  • Международный

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

После регистрации вы сможете в любое время изменить выбранный тип поиска и заданные доверенные IP-адреса.

Интерфейс API v2Интерфейс API v2

API v2 — интерфейс, тесно интегрированный в экосистему Yandex Cloud. Интерфейс позволяет выполнять текстовые запросы методом POST. Запросы выполняются в отложенном (асинхронном) режиме, а результат возвращается в формате XML.

При использовании API v2 тип поиска задается непосредственно в теле каждого запроса. Регистрироваться в сервисе, а также задавать доверенные IP-адреса при использовании API v2 не нужно.