Яндекс Live. Руководство разработчика
Яндекс Live - параметры, передаваемые в GET-запросе
Если вы передаете параметры через GET-запрос, то они имеют приоритет над настройками по умолчанию в личном кабинете. Если какой-либо из параметров не передается, то его значение берется из настроек по умолчанию.
https://xmlstock.com/yandexlive/xml/
? [user=<ID пользователя>]
& [key=<API-ключ>]
& [query=<текст поискового запроса>]
& [lr=<идентификатор региона поиска>]
& [page=<номер страницы>]
& [domain=<доменная зона>]
& [device=<устройство>]
& [tbm=<тип поиска>]
& [lang=<язык поиска>]
& [ads=<рекламные блоки>]
& [scroller=<рекламная карусель>]
& [related=<блок Related Searches>]
& [punycode=<формат кириллических доменов>]
& [hlword=<подсветка ключевых слов>]
| Параметр | Обязательно | Описание и допустимые значения |
|---|---|---|
| &user= | да | Ваш уникальный ID пользователя |
| &key= | да | Ваш уникальный API-ключ, выданный при регистрации Можно поменять в любой момент |
| &query= | да |
Текст поискового запроса &query=окна - результаты поисковой выдачи &query=site:https://domain.com - результаты поиска для определенного домена &query=image:https://domain.com/ImageURL.jpg - Обратный поиск по картинкам. (Поиск похожих картинок) Работает только в режиме &tbm=images Поиск по дате, языку и типу файла: Уточнить результаты поиска среди найденных документов можно с помощью операторов: тип файла, язык и дата добавления. Как правило, оператор указывается после текста поискового запроса и отделяется от него пробелом. В одном запросе можно использовать несколько операторов, разделяя их пробелом. mime:тип файла (Поддерживаемые типы: pdf, xls, ods, rtf, ppt, odp, swf, odt, odg, doc)lang:язык (Поддерживаемые языки: ru, en, de, fr) date:ГГГГММДД - дата добавления страницы соответствует указанной дате date:>ГГГГММДД - дата добавления страницы находится до или после указанной даты (<, <=, >, >=): date:ГГГГММДД..ГГГГММДД - дата добавления страницы находится в интервале date:ГГГГММ* - добавление страницы произошло в определенном месяце date:ГГГГ* - дата добавления страницы указана частично Год добавления указывается обязательно. Месяц и день можно заменить символом *. |
| &within= | нет |
Также для фильтрации по периоду времени можно использовать параметр &within= Значения: 77 - за сутки, 1 - за 2 недели, 2 - за месяц Параметр работает только в XML и JSON формате! Для HTML-формата используйте поиск по дате, описанный выше! |
| &lr= | нет | Идентификатор страны, области или города, из которого осуществляется поиск. Определяет правила ранжирования сайтов для выбранного региона: - Cписок идентификаторов часто используемых стран и регионов Яндекса (Посмотреть) - Список идентификаторов всех регионов Яндекса (Скачать .csv файл). Также значение для параметра &lr можно увидеть, начав вводить необходимый регион или город в форме настроек "Региональность поиска". |
| &page= | нет | Номер запрашиваемой страницы поисковой выдачи. Нумерация начинается с нуля (первой странице соответствует значение «0»). Если параметр не задан, возвращается первая страница поисковой выдачи. |
| &domain= | нет | Доменная зона Яндекс, по которой производится поиск (ru, by, kz, com.tr). Если не указано, по умолчанию ru |
| &device= | нет | С какого устройства осуществляется поиск (desktop, mobile) |
| &tbm= | нет | Тип поиска: &tbm= (или без него) - Поисковая выдача &tbm=images - Поиск по картинкам &tbm=video - Поиск по видео &tbm=turbo - Поисковая выдача на высокой скорости без ошибок и ограничений. Тарифицируется дополнительно |
| &lang= | нет | Поиск сайтов по конкретному Языку (ru, en, be, id, kk, de, tt, tr, uk, fr) Используйте, если понимаете для чего вам это нужно |
| &rstr= | нет | Поиск по сайтам которые содержат в тексте или анкор-файле упоминание заданного региона. В качестве значения используется номер региона аналогично оператору lr, но со знаком «минус», например: rstr=-213. Используйте, если понимаете для чего вам это нужно. |
| &ads= | нет | Параметр отвечает за показ рекламных блоков. Если значение &ads=1, то в выдаче показываются данные из верхнего и нижнего рекламных блоков (topads и bottomads). Если &ads=0 или параметр не задан, то не показываются. |
| &scroller= | нет | Параметр отвечает за показ рекламной карусели с товарами, расположенной в самом верху поисковой выдачи. Встречается не на всех запросах. Если значение &scroller=1, то товары показываются. Если &scroller=0 или параметр не задан, то не показываются. |
| &related= | нет | Параметр отвечает за показ блока Люди Ищут (Related Searches). Если значение &related=1, то в выдаче показываются данные блока похожих запросов пользователей при их наличии на странице. Если &related=0, то не показываются. |
| &punycode= | нет | Показывать кириллические домены в формате Punycode или нет &punycode=1 - Домены в формате punycode &punycode=0 - Домены в кириллическом формате |
| &hlword= | нет | Подсвечивать ключевые слова в теге hlword или нет &hlword=1 - ключевые слова выделены тегом hlword &hlword=0 - Тег hlword не используется |
