Сервисные запросы

API-методы

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

параметр [поисковая_система] – требуется для некоторых функций, это указано в таблице в формате запроса.

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

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

get_cost

Получение текущей стоимости тысячи запросов по указанной поисковой системе.
Формат запроса: xmlriver.com/api/get_cost/google/?user=[user_id]&key=[key]
Вместо google в запросе можно указываться также yandex, yaxml (Yandex Search API) или wordstat .

get_tarif

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

get_tarif_expire

Получение даты (включительно) завершения текущего тарифа. Возвращает строку с датой или строку "Basic", если вы используете базовый тариф.
Формат запроса: xmlriver.com/api/get_tarif_expire/?user=[user_id]&key=[key]

get_info

Все данные по сервисным запросам одновременно в формате JSON:

{
  "cost":{"google":25,"googlemaps":50,"yandex":25,"wordstat":25,"yaxml":28},
  "tarif":{"name":"Mega", "expire":"2026-01-01"},
  "balance":256.724,
  "threads":{"google":50,"yandex":10,"wordstat":10},
  "engine":{"google":1,"yandex":1,"wordstat":1,"yaxml":1}
}

Поле expire будет отсутствовать при тарифе Basic.
Поле engine – включен ли сбор. 1 – сбор доступен, 0 – сбор отключён/на обновлении.

Формат запроса: xmlriver.com/api/get_info/?user=[user_id]&key=[key]