Contact UsTry it for free
© 2025 Direct Cursus Technology L.L.C.

Authentication in API v1

Written by
Updated at July 24, 2025

To work with Yandex Search API using API v1, you need to send API requests under a service account. API v1 only supports authentication with API keys.

Warning

If your API key may have been compromised, revoke it and issue a new one.

  1. Get the service account's folder ID.

  2. Get an API key.

  3. Provide the obtained values in each request:

    In GET requests, provide the folder ID and API key in the folderid and apikey fields of the request URL, respectively:

    curl 'https://yandex.<domain>/search/xml?folderid=<folder_ID>&apikey=<API_key_value>&query=<search_request_text>'

    In POST requests, provide the API key in the Authorization request header in the following format:

    curl \
  --request POST \
  --header "Authorization: Api-Key <API_key>" \
  ...

    Provide the folder ID in the folderid field of the request URL:

    https://yandex.<domain>/search/xml?folderid=<folder_ID>