Параметры и методы

Использование параметров GET

Кроме установки необходимых настроек запросов в аккаунте, вы можете передавать эти параметры через GET запрос.
ВАЖНО! Переданные параметры в GET запросе имеют приоритет перед параметрами, установленными в настройках аккаунта!

Строка запроса

Наименование

Обязательно Описание
query да Параметр определяет строку запроса поиска. Вы можете использовать любые запросы, как если бы Вы делали поиск в Google, кроме символа амперсанда (&), который необходимо заменять на код %26

groupby

нет

Числовое значение, ТОП позиций для сбора. Возможные значения: 10, 20, 30, 50.
для совместимости в параметре groupby можно передавать значения в формате Яндекс.XML
    groupby=attr%3Dd.mode%3Ddeep.groups-on-page%3D5.docs-in-group%3D3
    в этом случае deep.groups-on-page учитывается следующим образом:
    deep.groups-on-page = 1..14 – сбор топ10
    deep.groups-on-page = 15..24 – сбор топ20
    deep.groups-on-page = 25..34 – сбор топ30
    deep.groups-on-page = 35..50 – сбор топ50
    deep.groups-on-page > 50 – возвращается ошибка

ВАЖНОЕ УТОЧНЕНИЕ!
Вы можете собирать по Яндексу ТОП100, но только в том случае, если установили это в кабинете в разделе Настройки сбора и не передаете в запросе GET-параметр groupby!
При передаче GET-параметра groupby=100, но не установленном в кабинете ТОП100 по Яндексу, вы будете получать ошибку 107.
За сбор ТОП100 взимается двойная оплата стоимости запроса по Яндексу.

page нет Числовое значение, определяет страницу поисковой выдачи. В Яндексе страницы нумеруются начиная с нуля.
highlights нет Подсветка ключевых слов.
При передаче параметра highlights=1 тайтл и сниппет заключаются в контейнер <![CDATA[...]]> и содержат тег <hlword> в который заключены выделенные жирным слова из выдачи, если таковые присутствуют.

 

Географическое расположение

Наименование

Обязательно Описание
lr нет

числовое значение (id) местоположения (регион Яндекса)

 

Локализация

Наименование

Обязательно Описание
lang нет

Код языка Яндекса: ruuk...

domain нет

Строка yandex домена. Возможные значения: rucomuacom.trbykz

 

Параметры XMLRiver

Наименование

Обязательно Описание
device нет

Устройство, на котором выполняется поиск: desktop, tablet, mobile

raw нет При передаче параметра raw=page мы возвращаем полный html код страницы яндекса. При передаче этого значения, параметр delayed игнорируется. Т.е. получать полный html код страницы яндекса в режиме отложенного ответа нельзя.


Пример: 
http://xmlriver.com/search_yandex/xml?user=[user_id]&key=[key]&groupby=10&lang=ru&lr=1&domain=ru&device=desktop