HTML format of response to a text search query
In response to a text search query, Yandex Search API can return an HTML file with search results. The returned HTML file is identical to the HTML page with the same search results you get on the Yandex Search home page in incognito mode.
A query result in HTML format contains more data than the result of a similar query in XML format: the HTML result includes ads, quick responses, and other elements which may appear in search results. The HTML response format is regularly updated together with the format of Yandex Search results.
The service returns an HTML response for text queries processed both via API v2 and API v1.
Warning
API v1 is now obsolete and will be discontinued on September 30, 2025. Make sure to migrate your projects to API v2 before this date and use it in your new projects.
See the example of HTML search results.
You can get a maximum of 1,000 search results per search query. You can specify the number of search results per page in the groupsOnPage field. For example, if the groupsOnPage field is set to 10, no more than 100 search result pages can be generated, and if the field is set to 50, no more than 20 pages can be generated. You can set the number of search results per page only in the API v2 interface.