Формат ответа

<?xml version="1.0" encoding="utf-8"?>
<yandexsearch version="1.0">
<response date="20120928T103130">
   <found priority="all">206775197</found>
   <addresults>
      <zeroposition>
        <title>Как приготовить пиццу в домашних условиях (видео) - tochka.net</title>
        <url>https://lady.tochka.net/31385-kak-prigotovit-pitstsu-v-domashnikh-usloviyakh/</url>
      </zeroposition>
      <relatedQuestions>
        <question>
           <title>Как приготовить пиццу Неаполитано</title>
        ​</question>
      </relatedQuestions>
      <knowledge_graph>
        <place_id>ChIJrTLr-GyuEmsRBfy61i59si0</place_id>
        <name>Организация</name>
        <rating>Рейтинг</rating> 
        <countReviews>Кол-во отзывов</countReviews>
        <address>Адрес</address>
        <phone>Телефон</phone>
      </knowledge_graph>
   </addresults>
   <results>
      <grouping>
        <page first="1" last="2">0</page>
        <group>
            <doccount>1</doccount>
            <doc>
                <url>http://test.tankionline.com/</url>
                <title> Tanki Online - Test Server </title>
                <pubDate> 29 авг. 2018 г. - </pubDate>
                <extendedpassage>Рейтинг: 4,1 - ‎140 голосов - ‎2 ч.</extendedpassage>
                <passages>
                    <passage>
                        Добро пожаловать на страницу тестовых серверов «Танков Онлайн»! Большую часть времени серверы работают в режиме закрытого тестирования: ...
                    </passage>
                </passages>
                <sitelinks>
                    <sitelink>
                        <url>http://test.tankionline.com/about/</url>
                        <title>Про нас</title>
                        <snippet>Информация о нас</snippet>
                    </sitelink>
                </sitelinks>
            </doc>
        </group>
        <group>
            <doccount>1</doccount>
            <doc>
                <url>https://ru.wikipedia.org/wiki/Test</url>
                <title> test — Википедия </title>
                <pubDate> 29 авг. 2018 г. - </pubDate>
                <passages>
                    <passage>
                       test — UNIX-утилита для проверки типа файла и сравнения значений. Возвращает код возврата 0 (истина) или 1 (ложь) в зависимости вычисления  ...
                    </passage>
                </passages>
                <oneline_sitelinks>
                    <sitelink>
                        <url>ru.wikipedia.org/wiki</url>
                        <title> Википедия </title>
                        <snippet/>
                    </sitelink>
                </oneline_sitelinks>
            </doc>
        </group>
      </grouping>
   </results>
</response>
</yandexsearch>

 
 

Формат ответа при ошибке:

<?xml version="1.0" encoding="utf-8"?>
<yandexsearch version="1.0">
   <response date="20120928T103130">
      <error code="15">Искомая комбинация слов нигде не встречается</error>
   </response>
</yandexsearch>


Общая информация о результатах поиска

Теги блока с общей информацией о результатах поиска представлены в таблице ниже.

Теги общей информации о результатах поиска Описание Атрибуты
error Описание ошибки.

Присутствует только в случае некорректной обработки поискового запроса (например, при пустом запросе, некорректных параметрах и т.п.).

code — код ошибки.
found

Приблизительная оценка количества документов, найденных по запросу.

priority — служебный. Возможные значения:

  • «all»


Блок results

Присутствует, если по запросу найдены результаты.

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

Теги блока results Описание Атрибуты
results

Группирующий. Дочерние теги содержат сведения о параметрах поиска и найденных документах.

нет

grouping

Группирующий. Дочерние теги содержат сведения о параметрах поиска и найденных документах.

 

page Номер возвращенной страницы результатов поиска. Нумерация начинается с нуля (первой странице соответствует значение «1»).
  • first — порядковый номер первой группы с результатами поиска;
  • last — порядковый номер последней группы с результатами поиска.
group

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

Каждый тег group содержит сведения о найденной группе документов.

нет
doccount

Всегда равен 1. Введен для совместимости с ответом Яндекс.XML

нет
doc

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

Каждый тег doc содержит информацию о найденном документе.

нет
url Адрес найденного документа. нет
title

Заголовок найденного документа.

Слова, входящие в поисковый запрос, выделяются тегом hlword.

нет
pubDate

Дата публикации.

нет
extendedpassage

Дополнительный сниппет. Включает в себя рейтинг, кол-во отзывов, цены...

нет
passages Группирующий тег, содержащий список пассажей документа. нет
passage

Пассаж с аннотацией к документу.

Слова, входящие в поисковый запрос, выделяются тегом hlword.

нет
sitelinks Группирующий тег, содержащий список дополнительных ссылок для первой позиции. Когда запрос содержит название бренда и на первой позиции показывается сайт с дополнительными ссылками (витальный запрос). нет
oneline_sitelinks Группирующий тег, содержащий список дополнительных ссылок для запроса в одну строку. нет
sitelink Группирующий тег с дополнительными ссылками к запросу.
Содержит в себе тэги
нет

 

Блок addresults

Присутствует, если по запросу найдены дополнительные результаты.

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

Теги блока results Описание Атрибуты
zeroposition

Группирующий. Дочерние теги содержат сведения о заголовке и ссылке на страницу для нулевой позиции в результатах поиска.

нет
relatedQuestions

Группирующий, содержит похожие запросы.

нет

knowledge_graph

Группирующий. Дочерние теги содержат сведения о:
place_id - id организации в Google Places database
name - наименование организации
rating - рейтинг
countReviews - кол-во отзывов
address - адрес
phone - телефон 

нет
question Группирующий. Дочерние теги содержат сведения о похожих запросах. нет