API Google

Для подключения и начала использования XMLRiver, выполните следующие действия:

  1. Зарегистрируйтесь.
  2. В аккаунте в разделе Покупка запросов настройте параметры сбора. Без указания этих параметров Вам будет недоступна ссылка для сбора данных.
  3. Убедитесь, что запросы успешно отправляются:
    • Сформируйте и отправьте запрос методом GET с компьютера. Используйте URL для запросов, указанный в разделе Покупка запросов и добавьте к нему параметр query. Запрос будет выглядеть следующим образом:

    • http://xmlriver.com/search/xml?user=[user_id]&key=[key]&query=test
    • ВАЖНО! Строка, которая передается в параметр query не должна содержать амперсанд (&). Его нужно заменять на код %26
  4. Проверьте полученный XML-документ.

    Ответ должен соответствовать заданному формату и не должен содержать ошибок.

    Примечание. Если по поисковому запросу отсутствуют результаты, допустима ошибка с кодом «15».

 

Кроме установки необходимых настроек запросов в аккаунте, вы можете задавать их через GET запрос.

Возможные параметры:

groupby – числовое значение, ТОП позиций для сбора. Возможные значения: 10, 20, 30, 50, 100;
loc – числовое значение (id) местоположения из этого файла;
country – числовое значание (id) страны из этого файла;
lr – код языка из файла языков;
domain – числовое значение (id) google домена из этого файла;
device – устройство (desktop, tablet, mobile).

Пример: 
http://xmlriver.com/search/xml?user=[user_id]&key=[key]&groupby=20&loc=1000028&country=2008&lr=RU&domain=10&device=desktop

Обратите внимание!
При использовании программ сбора, вам необходимо ставить таймаут при обращении к нашему сервису равный 5 минутам. При низком таймауте большая вероятность того, что часть ответов от нас не будут получены вашей программой.

В стандартном аккаунте вам доступен сбор данных в 10 потоков api, что позволяет собрать около 200 тысяч запросов в сутки по Google и около 80 тысяч запросов по Яндексу.
Если вам нужно больше, создайте тикет.

Дополнительные API-методы

Запросы к дополнительным методам осуществляется по адресу xmlriver.com/api/[имя_метода]/ с обязательной передачей GET-параметров user=[user_id]&key=[key]

Метод Описание
get_balance

Получение баланса по счету. Возвращается сумма основного и бонусного счетов.
Возвращает строку с балансом или с ошибкой.
Формат запроса: xmlriver.com/api/get_balance/?user=[user_id]&key=[key]