Yandex Cloud
Search
Contact UsGet started
  • Blog
  • Pricing
  • Documentation
  • All Services
  • System Status
    • Featured
    • Infrastructure & Network
    • Data Platform
    • Containers
    • Developer tools
    • Serverless
    • Security
    • Monitoring & Resources
    • ML & AI
    • Business tools
  • All Solutions
    • By industry
    • By use case
    • Economics and Pricing
    • Security
    • Technical Support
    • Customer Stories
    • Gateway to Russia
    • Cloud for Startups
    • Education and Science
  • Blog
  • Pricing
  • Documentation
Yandex project
© 2025 Yandex.Cloud LLC
Yandex Search API
    • Overview
    • XML response
    • HTML response
    • Generative response
    • Quotas and limits
  • Access management
  • Pricing policy
  • Audit Trails events
  1. Concepts
  2. HTML response

HTML format of response to a text search query

Written by
Yandex Cloud
Updated at April 30, 2025

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 v1 and API v2.

See the example of HTML search results.

Note

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.

See also

  • Performing search queries using API v2 in synchronous mode
  • Performing search queries in deferred mode using API v2
  • Text search with API v2

Was the article helpful?

Previous
XML response
Next
Generative response
Yandex project
© 2025 Yandex.Cloud LLC