Authentication with the API v1

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

1. Get the service account's folder ID.

2. Get an API key.

3. Provide the obtained values in each request:

   GET requests

   POST requests

   In GET requests, provide the folder ID and API key values 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 value in the Authorization request header in the following format:

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

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

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