Связаться с намиПодключиться

Аутентификация в API v1

Статья создана
Обновлена 7 июля 2025 г.

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

Важно

Если ваш API-ключ мог быть скомпрометирован, отзовите его и выпустите новый.

  1. Получите идентификатор каталога сервисного аккаунта.

  2. Получите API-ключ.

  3. Полученные значения передавайте в каждом запросе:

    В GET-запросах передавайте значения идентификатора каталога и API-ключа в URL запроса в полях folderid и apikey:

    curl 'https://yandex.<домен>/search/xml?folderid=<идентификатор_каталога>&apikey=<значение_API-ключа>&query=<текст_поискового_запроса>'

    В POST-запросах передавайте значение API-ключа в заголовке запроса Authorization в следующем формате:

    curl \
  --request POST \
  --header "Authorization: Api-Key <API-ключ>" \
  ...

    Идентификатор каталога передавайте в URL запроса в поле folderid:

    https://yandex.<домен>/search/xml?folderid=<идентификатор_каталога>