Google XML Search. Руководство разработчика
Google XML Search - параметры, передаваемые в GET-запросе
Если вы передаете параметры через GET-запрос, то они имеют приоритет над настройками по умолчанию в личном кабинете. Если какой-либо из параметров не передается, то его значение берется из настроек по умолчанию.
https://xmlstock.com/google/xml/
? [user=<ID пользователя>]
& [key=<API-ключ>]
& [query=<текст поискового запроса>]
& [lr=<идентификатор региона поиска>]
& [groupby=<количество результатов на странице>]
& [page=<номер страницы>]
& [domain=<доменная зона>]
& [device=<устройство>]
& [tbm=<тип поиска>]
& [tbs=<период поиска>]
& [hl=<язык интерфейса>]
& [ads=<рекламные блоки>]
& [related=<блоки Related Questions и Related Searches>]
& [filter=<тип фильтрации>]
& [punycode=<формат кириллических доменов>]
& [hlword=<подсветка ключевых слов>]
& [nfpr=<исправление опечаток в запросе>]
& [safe=<безопасный поиск>]
| Параметр | Обязательно | Описание и допустимые значения |
|---|---|---|
| &user= | да | Ваш уникальный ID пользователя |
| &key= | да | Ваш уникальный API-ключ, выданный при регистрации Можно поменять в любой момент |
| &query= | да | Текст поискового запроса &query=окна - результаты поисковой выдачи &query=site:https://domain.com - результаты поиска для определенного домена и определение количества проиндексмированных страниц сайта |
| &lr= | нет | Идентификатор страны, области или города, из которого осуществляется поиск. Определяет правила ранжирования сайтов для выбранного региона: - Список идентификаторов всех регионов Google (Скачать .csv файл) Также мы осуществляем поддержку для Google списка идентификаторов часто используемых в Яндексе. Если указать значения из данной таблицы Яндекса в ПС Google, то наша система сопоставит значения, автоматически найдет нужный регион в Гугл и подставит его самостоятельно.* Также значение для параметра &lr можно увидеть, выбрав необходимый регион или город в форме настроек "Региональность поиска" |
| &groupby= | нет | Максимальное количество результатов поиска, которые будут возвращены на одной странице. Допустимые значения: от 10 до 100 |
| &page= | нет | Номер запрашиваемой страницы поисковой выдачи. Нумерация начинается с нуля (первой странице соответствует значение «0»). Если параметр не задан, возвращается первая страница поисковой выдачи. |
| &domain= | нет | Доменная зона Google, по которой производится поиск (com, ru, com.ua, by и т.д.). Если не указано, по умолчанию com Также можно указывать числовое значение (например domain=143 для google.ru) |
| &device= | нет | С какого устройства осуществляется поиск (desktop, mobile) |
| &start= | нет | Альтернатива параметру &page=. Показывает выдачу, начиная с заданной позиции (например, &start=50) |
| &tbm= | нет | Тип поиска: &tbm= (или без него) - Поисковая выдача &tbm=images - Поиск по картинкам &tbm=news - Поиск по новостям &tbm=video - Поиск по видео |
| &tbs= | нет |
Период поиска: &tbs= (или без него) - За все время &tbs=qdr:s - За секунду &tbs=qdr:n - За минуту &tbs=qdr:n10 - За 10 минут или любое другое значение &tbs=qdr:h - За час &tbs=qdr:d - За 24 часа &tbs=qdr:w - За неделю &tbs=qdr:m - За месяц &tbs=qdr:y - За год &tbs=cdr:1,cd_min:1/2/2023,cd_max:3/2/2023 - Конкретный временной диапазон дат В примере: 2 января 2023 - 2 марта 2023 |
| &hl= | нет | Параметр определяет язык интерфейса пользователя для более точных результатов |
| &ads= | нет | Параметр отвечает за показ рекламных блоков. Если значение &ads=1, то в выдаче показываются данные из верхнего и нижнего рекламных блоков (topads и bottomads). Если &ads=0, то не показываются. На данный момент ПС Google из-за введенных ограничений не показывает рекламу в РФ. |
| &related= | нет | Параметр отвечает за показ двух блоков: Вопросы по теме (Related Questions) и Запросы по Теме (Related Searches). Если значение &related=1, то в выдаче показываются данные блока вопросов и ответов и похожих запросов при их наличии на странице. Если &related=0, то не показываются. |
| &filter= | нет | ПС Google по умолчанию скрывает некоторые результаты, которые очень похожи на уже представленные. Если вам необходимо получить выдачу вместе с этими скрытыми результатами, то необходимо передать значение &filter=1 |
| &punycode= | нет | Показывать кириллические домены в формате Punycode или нет &punycode=1 - Домены в формате punycode &punycode=0 - Домены в кириллическом формате |
| &hlword= | нет | Подсвечивать ключевые слова в теге hlword или нет &hlword=1 - ключевые слова выделены тегом hlword &hlword=0 - Тег hlword не используется |
| &nfpr= | нет | Исправление запроса Google в случае опечатки. &nfpr=1 - запрос не исправляется &nfpr=0 - Запрос исправляется. Значение по умолчанию. |
| &safe= | нет | Безопасный поиск. Скрывает из результатов контент для взрослых. &safe= Размытие. Значение по умолчанию. Изображения для взрослых будут размыты, но текст и ссылки останутся. &safe=on Фильтр. Контент для взрослых (изображения, ссылки и текст) будет убран из поисковой выдачи. &safe=off Отключено. Будут показываться все актуальные результаты поиска, включая контент для взрослых. |
* По вашему запросу в чат техподдержки мы можем произвести сопоставление ваших регионов Яндекс с регионами Google, чтобы вы могли указывать один код региона для обоих систем.
