Документация

request

Обобщенная информация о параметрах запроса. Может отсутствовать, если ответ содержит ошибки.

Теги request описаны в таблице ниже.

Теги группы requestОписаниеАтрибуты
query Текст переданного поискового запроса.Отсутствуют.
page Номер возвращенной страницы результатов поиска. Нумерация начинается с нуля (первой странице соответствует значение «0»).Отсутствуют.
sortby

Параметры сортировки результатов. Возможные значения:

  • «rlv» — по релевантности;
  • «tm» — по времени изменения документа.
  • order — порядок сортировки. По умолчанию используется значение «descending» (прямой). При сортировке по времени изменения может принимать значение «ascending» (обратный);
  • priority — служебный. Принимает значение «no».
maxpassages Максимальное количество пассажей, которые могут быть переданы в одном результатом поиска.Отсутствуют.
groupings

Группирующий.

Содержит параметры группировок в теге groupby. Атрибуты отсутствуют

Отсутствуют.
groupby Параметры группировки найденных результатов поиска.
  • mode — метод группировки;
  • attr — служебный;
  • groups-on-page — максимальное количество групп, которые могут быть возвращены на одной странице результатов поиска;
  • docs-in-group — максимальное количество документов, которые могут быть возвращены в одной группе. Любая группа может содержать меньшее количество документов, чем указанное в данном параметре значение;
  • curcateg — служебный. Принимает значение «-1».

Пример

В следующем примере приведено содержимое группирующего тега request, возвращаемого для запроса https://yandex.com.tr/search/xml?l10n=en&user=xml-search-user&key=03.79031114:b631r9j587dkl4jko987hgg7bn2kl8a2&query=%22has%20sample%20applications%20for%20the%20most%20popular%20programming%22&sortby=tm&maxpassages=2&groupby=attr%3Dd.mode%3Ddeep.groups-on-page%3D5.docs-in-group%3D3&maxpassages=3&page=1

<request>
  <query>"has sample applications for the most popular programming"</query>
  <page>1</page>
  <sortby order="descending" priority="no">tm</sortby>
  <maxpassages>2</maxpassages>
  <groupings>
    <groupby attr="d" mode="deep" groups-on-page="5" docs-in-group="3" curcateg="-1"/>
  </groupings>
</request>