Помощь по Google XML Search
Google XML - почти как Яндекc XML, только Google!
Новый инструмент от нашего сервиса - Google XML позволяет отправлять автоматические поисковые запросы к Google и получать ответы в аналогичном c Яндекс XML формате.
Вы можете организовать анализ поисковой выдачи Google с помощью любого софта, поддерживающего Яндекс XML, или использовать собственные программы и скрипты - переделывать придется по минимуму! При этом цена одного запроса значительно ниже, чем у сервисов по съему позиций и начинается от 10 рублей за 1000 запросов.
Как приступить к работе
1. Для начала необходимо определиться с тарифным планом. По умолчанию установлен тарифный план "Базовый" с оплатой за каждый запрос. Если вам необходимо совершать большое количество запросов к Google на регулярной основе, то вам подойдут пакетные тарифы "Оптимальный" или "Максимум", цена на них значительно ниже.
2. В разделе Настроек - укажите необходимые параметры поиска по умолчанию. Обратите внимание на то, что в зависимости от настроек региональности - позиции сайтов могут значительно меняться. Почти все параметры из настроек можно передавать в URL для совершения запросов, тогда они имеют приоритет над настройками по умолчанию.
3 Для совершения запросов используйсте свой уникальный URL:
?user=[id] - ваш ID в системе
&key=[key] - ваш уникальный ключ.
При необходимости ключ можно поменять в любой момент.
4 Для получения результатов поиска в формате XML, необходимо сформировать GET запрос и добавить к своему URL параметр &query=[Запрос]
Все остальные параметры которые можно передавать в URL через GET запрос представлены в таблице ниже.
5 Скопируйте URL для запросов в любую программу которая в своих настройках поддерживает Яндекс.XML и тогда вы будете получать результаты поиска для Google.
6 Со статистикой совершения запросов можно ознакомиться на странице "Статистика запросов".
Отличия от Яндекс.XML
1. Парсинг Google осуществляется по принципу проксирования. Нет необходимости где-либо регистрировать свой IP адрес. Ваша программа или скрипт отправляет запрос к нашему сервису на уникальный URL, мы отдаем ответ в формате XML, схожем по своей структуре с Яндекс.XML.
2. Отсутствуют ограничения на количество запросов в час/в сутки. Существует ограничение на количество одновременных потоков, которое зависит от текущей нагрузки на сервис.
3. Скорость работы ниже чем в Яндекс.XML, так как существует некоторая задержка при получении ответа. Учитывайте это в настройках своего софта. В случае если мы не успеваем обработать ваши запросы и появляются ошибки - используйте тайм-ауты и временные интервалы ожидания ответов.
4. Региональность в Google представлена намного более обширным списком стран, регионов и городов. При работе с нашей системой, вы можете использовать и список идентификаторов часто используемых стран и городов Яндекса, и список идентификаторов геолокации Google.
Параметры которые можно передавать в URL через GET-запросы
Если вы передаете параметры через GET-запрос, то они имеют приоритет над настройками в личном кабинете.
Если какой-либо из параметров не передается, то его значение берется из настроек по умолчанию.
| Параметр | Описание и допустимые значения |
|---|---|
| ?user= | Ваш ID пользователя на нашей бирже |
| &key= | Значение API-ключа, выданного при регистрации |
| &query= | Текст поискового запроса |
| &groupby= | Максимальное количество результатов поиска, которые будут возвращены на одной странице. Допустимые значения: от 1 до 100 |
| &page= | Номер запрашиваемой страницы поисковой выдачи. Нумерация начинается с нуля (первой странице соответствует значение «0»). Если параметр не задан, возвращается первая страница поисковой выдачи. |
| &domain= | Доменная зона Google, по которой производится поиск (com, ru, com.ua, by и т.д.) Также можно указывать числовое значение (например domain=143 для google.ru) |
| &hl= | Параметр определяет язык интерфейса пользователя для более точных результатов |
| &device= | С какого устройства осуществляется поиск: desktop, tablet, mobile |
| &lr= | Идентификатор страны, области или города, из которого осуществляется поиск. Определяет правила ранжирования сайтов для выбранного региона. Мы осуществляем поддержку списка идентификаторов часто используемых стран и регионов Яндекса. Кроме этого поддерживаются все идентификаторы из файла геолокаций Google. Также значение для параметра lr можно увидеть, выбрав необходимый регион и город в форме настроек "Региональность поиска" |
| &ads= | Параметр отвечает за показ рекламных блоков. Если значение &ads=1, то в выдаче показываются данные из верхнего и нижнего рекламных блоков (topads и bottomads). Если &ads=0, то не показываются. |
| &filter= | ПС Google по умолчанию скрывает некоторые результаты, которые очень похожи на уже представленные. Если вам необходимо получить выдачу вместе с этими скрытыми результатами, то необходимо передать значение &filter=1 |
Коды ошибок
| Код ошибки | Описание ошибки |
|---|---|
| 2 | Задан пустой поисковый запрос (в элементе query передано пустое значение). |
| 3-8 | Не верно указано значение GET-параметров (groupby, domain, hl, device, page, lr). |
| 15 | Для заданного поискового запроса отсутствуют результаты поиска. |
| 20-25 | Внутренняя ошибка. Обратитесь в службу поддержки. |
| 31 | Пользователь с таким ID не зарегистрирован в системе. |
| 42 | Ключ, выданный при регистрации, содержит ошибку. Необходимо проверить корректность адреса, используемого для отправки запросов. |
| 101 | Сервис сбора данных Google XML временно отключен. Ведутся технические работы, попробуйте позже. |
| 110 | Нет свободных каналов для сбора данных. Попробуйте позже. |
| 200 | На вашем счету закончились деньги. Для дальнейшей работы пополните баланс. |
| 500, 503 | Превышено максимально допустимое количество запросов в секунду/минуту |
Если у вас возникли вопросы - смело обращайтесь в техподдержку, мы вас проконсультируем и все расскажем!
