API история тИЦ, PR, склейка доменов

к списку API

Если Вы хотите получать данные об истории тИЦ, PR, склейке доменов в удобном для Вас формате, готовом для дальнейшей программной обработки, API история тИЦ, PR, склейки доменов - это именно то, что Вам нужно.

Что необходимо для того, чтобы получать данные о истории?

Прежде всего Вам необходимо быть зарегистрированным пользователем b2seo.net. Далее получить свой собственный API ключ для получения данных, пополнить лицевой счет в системе и отправить XML-запрос к нам на сервер.

Какова стоимость услуги?

Стоимость услуги прогнозируемая и, главное, ниже рыночной. Дело в том, что мы взымаем плату за саму проверку домена, а не за единицу информации. Что это означает? Это означает, что получив историю домена, Вы заплатите фиксированную сумму, в независимости от количества полученных записей такой истории. Например, история тИЦ домена в 10 записей и история домена в 100 записей для Вас обойдется в одну цену. Если же информация по домену отсутствует, за такой запрос, естественно, плата взиматься не будет. Это выгодно отличает наш сервис от конкурентов, поскольку проверка истории тИЦ доменов для Вас всегда будет стоить 5 проверок на 1 цент, а не 5 центов за 1 проверку, например.

На данный момент действуют такие тарифы:
Проверка истории тИЦ домена - $0,002 (500 проверок/$1)
Проверка истории PR домена - $0,005 (200 проверок/$1)
Считаете это дорого? Обоснуйте свою цену: iCQ: 474-500,

Данная услуга не может быть оплачена бонусами.

Как сделать запрос на получения информации и какой формат вывода?

Для того, чтобы получить данные, Вам необходимо обратиться к скрипту по адресу https://www.b2seo.net/api/domain-history/api.php (шифрованное соединение) с POST-запросом и отправить в нем с помощью XML такие значения:

  • Элемент KEY - со значением ключа, полученного предварительно Вами
  • Элемент ReturnFormat - со значением формата возвращаемого запроса (XML или JSON)
  • Элемент Domain (до 10 элементов (доменов) в одном запросе) со значением проверяемого домена и параметрами:
    • type - тип проверки. Может быть равен "cy", "pr" и "cypr". В первом случае система Вам вернет историю со значениями тИЦ, во втором - PR, в третьем - и тИЦ и PR.
    • from (необязательный) - с какой даты (в формате timestamp) сделать выборку. Если не указан - записи будут выбраны начиная с первой, известной системе.
    • to (необязательный) - по какую дату (в формате timestamp) сделать выборку. Если не указан - записи будут выбраны по последнюю, известную системе.
    • exact (необязательный) - на какую дату (в формате timestamp) сделать проверку. Если не указан ни один из параметров, будут выданы все известные системе записи.

Примеры запросов

Запрос на получение всей известной информации о тИЦ для домена b2seo.net

<DomainHistoryQuery>
<Key>b21a4067e204dad697123cafbba5d3ec</Key>
<ReturnFormat>xml</ReturnFormat>
<Domain type='cy'>b2seo.net</Domain>
</DomainHistoryQuery>

Запрос на получение всей известной информации о PR для двух доменов google.com и google.ru
и тИЦ для google.com.ua начиная с 01.01.2013 (1357070400).

<DomainHistoryQuery>
<Key>b21a4067e204dad697123cafbba5d3ec</Key>
<ReturnFormat>xml</ReturnFormat>
<Domain type='pr'>google.com</Domain>
<Domain type='pr'>google.ru</Domain>
<Domain type='cy' from="1357070400">google.com.ua</Domain>
</DomainHistoryQuery>

Запрос на получение всей известной информации о тИЦ и PR для домена yandex.ru
и значения тИЦ на 01.01.2013 (1357070400) для домена b2seo.net.

<DomainHistoryQuery>
<Key>b21a4067e204dad697123cafbba5d3ec</Key>
<ReturnFormat>xml</ReturnFormat>
<Domain type='cypr'>yandex.ru</Domain>
<Domain type='cy' exact="1357070400">b2seo.net</Domain>
</DomainHistoryQuery>

Примеры кода на PHP

Для того, чтобы отправить POST-запрос на PHP можно использовать библиотеку curl.

<?
//адрес для отправки запроса
$url = "https://www.b2seo.net/api/domain-history/api.php";

//сам зпрос
$data = "<DomainHistoryQuery>
<Key>b21a4067e204dad697123cafbba5d3ec</Key>
<ReturnFormat>xml</ReturnFormat>
<Domain type='cy'>b2seo.net</Domain>
</DomainHistoryQuery>";

//инициализируем curl
$ch = curl_init($url);
//вернуть данные
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
//использовать POST-метод
curl_setopt($ch, CURLOPT_POST, true);
//пропустить проверку сертификата
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
//отправить данные из переменной $data
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
//выполнить
$return = curl_exec($ch);
?>

Теперь осталось полученные данные разобрать.

Формат возвращаемых данных

Как уже указывалось, данные можно получить в двух форматах: XML и JSON. Если Вы используете PHP для обработки данных, наверное, удобнее будет использовать JSON, т.к. в PHP есть стандартная функция json_decode, которая вернет Вам удобный для работы ассоциативный массив. Однако, по порядку.

Так выглядит ответ в формате XML (естественно, для домена google.com элементов "Date" на много больше):
<DomainHistoryAnswer>
<Status>1</Status>
<Domain>
<Url>google.com</Url>
<DomainHistory>
<Date cy="68000">1285971691</Date>
<Date cy="210000">1372939093</Date>
</DomainHistory>
</Domain>
</DomainHistoryAnswer>

Для начала необходимо проверить данные из элемента "Status". Если значение элемента не равняется 1, значит произошла ошибка. Кода ошибок:

  • 0 - нет доступа. Это означает, что API-ключ указан неверно, или IP хоста, с которого пришел запрос, не соответствует установелнным ограничениям.
  • 2 - не указан один из параметров/неверный формат запроса
  • 3 - недостаточно средств на счету

Элемент "Domain" содержит в себе 2 элемента: "Url", в котором, собственно, указан домен, и "DomainHistory", внутри которого располагаются элементы "Date". Элементы "Date" являются записями с историей домена. Значение этого элемента - это дата и время в формате timestamp, а параметры - его значения. Если Вы запрашивали PR, отобразится параметр "pr" с соответствующим значением, если Вы запрашивали тИЦ, отобразится параметр "cy" со значением тИЦ, а если заправшивали "cypr", отобразятся оба параметра с соответствующими значениями. Если домен в это время был склеен, отобразится параметр "glued", в которм значением будет домен, с которым был склеен запрашиваемый домен.

А так выглядит ответ в формате JSON:
{
"Status": "1",
"google.com": {
"1285971691":{"cy": 68000},
"1296978081":{"cy": 65000},
"1372939093":{"cy": 210000}
}
}
где элементы первого уровня - домены (и элемент "Status", который необходимо программно пропустить), элементы второго уровня - даты проверок в формате timestamp, элменты третьего уровня, соответственно, параметры тИЦ (cy), PR (pr) или склейка (glued).

Если у Вас возникают вопросы, обращайтесь в поддержку: iCQ: 474-500,

 
 

Приветствуем, Гость. Войдите или зарегистрируйтесь.

Домены

Аналитика

Контент для сайтов

Аналитика