About Yandex Search API

With Yandex Search API, you can automatically submit queries to the Yandex search database and get your search results. The service is tailored for developers and webmasters.

With Search API, you can easily implement the search feature on individual websites, groups of websites, or across the internet, or create an application with built-in search features. Additionally, it offers features to monitor website ranking for specific queries in Yandex search results.

Search API provides two interfaces for queries: API v1 and API v2.

API v1API v1

API v1 is a Yandex XML compatible interface. It allows you to run text queries using the GET and POST methods and get your results in XML or HTML format in synchronous mode.

You can also use API v1 for text search in combination with YandexGPT generative features. This gets you a single concise and coherent generative response to produce which the neural network analyzes the relevant results of the Search API's text search across websites.

With Search API API v1, you can choose between default search and search optimized for mobile devices.

In addition to various text search options, API v1 allows you to search for images based on a text query. Image search only supports the GET method for queries.

To use the API v1 interface, you need to register in Search API:

• Make a list of trusted IP addresses you are going to use to submit search queries.

• Select one of the three available text search types:

  • Russian
  • Turkish
  • International

  The search type determines the search result ranking formula and the search database, i.e., the documents covered by the search.

After registration, you can change your search type and trusted IP addresses at any time.

API v2API v2

API v2 is an interface natively integrated into the Yandex Cloud ecosystem. This interface allows you to run text queries using the POST method. Queries are executed in deferred (asynchronous) mode, and you get the result in XML format.

With API v2, you set the search type directly in the body of each query. You do not need to register in Yandex Search API or specify trusted IP addresses when using API v2.