Суммарный отчет (getSummary)

Метод getSummary возвращает общую информацию о ссылочном профиле: количество входящих ссылок, ссылающихся IP-адресов и подсетей, количество ссылающихся доменов и поддоменов, показатель авторитетности домена и типы ссылающихся ссылок. По набору данных аналогичен отчету «Суммарный отчет».

Общие параметры запроса и инструкция по использованию Serpstat API

Параметры запроса
Параметр		Описание
id	обязательно	Идентификатор запроса. Допускается ввод любого числового или строкового значения.
method	обязательно	Название метода API: SerpstatBacklinksProcedure.getSummary
params	обязательно	Объект с параметрами {...}, в нем перечисляются все нижеследующие параметры и массивы.
query	обязательно	Домен анализируемого сайта. Указываем домен без http / https и "/".
searchType	обязательно	Режим поиска: * domain_with_subdomains - домен с поддоменами * domain - только домен * URL - только URL

Параметры ответа
Параметр	Описание
id	Идентификатор запроса
result	Инкапсулирует в себе ответ
data	Массив с данными
referringDomains	Количество ссылающихся доменов
referringSubDomains	Количество ссылающихся поддоменов
referringLinks	Количество входящих ссылок
totalIndexed	Количество проиндексированных страниц в Google
externalDomains	Количество исходящих доменов
noFollowLinks	Количество ссылающихся nofollow-ссылок
doFollowLinks	Количество ссылающихся follow-ссылок
referringIps	Количество ссылающихся IP-адресов
referringSubnets	Количество ссылающихся подсетей
trustRank	Показатель TrustRank (устаревший)
citationRank	Показатель CitationRank (устаревший)
domainZoneEdu	Количество ссылающихся доменов в зоне .edu (устаревший)
domainZoneGov	Количество ссылающихся доменов в зоне .gov (устаревший)
outlinksTotal	Количество исходящих ссылок
outlinksUnique	Количество уникальных исходящих ссылок
facebookLinks	Количество ссылок из социальной сети Facebook (устаревший)
pinterestLinks	Количество ссылок из социальной сети Pinterest (устаревший)
linkedinLinks	Количество ссылок из социальной сети LinkedIn (устаревший)
vkLinks	Количество ссылок из социальной сети vKontakte (устаревший)
typeText	Количество ссылающихся текстовых ссылок
typeImg	Количество ссылающихся изображений
typeRedirect	Количество ссылающихся редиректов
typeAlt	Количество ссылок из атрибута alt
referringDomainsDynamics	Значение динамики по ссылающимся доменам
referringSubDomainsDynamics	Значение динамики по ссылающимся поддоменам
referringLinksDynamics	Значение динамики по входящим ссылкам
totalIndexedDynamics	Значение динамики по проиндексированным страницам в Google
externalDomainsDynamics	Значение динамики по исходящим доменам
noFollowLinksDynamics	Значение динамики по обратным nofollow-ссылкам
doFollowLinksDynamics	Значение динамики по обратным follow-ссылкам
referringIpsDynamics	Значение динамики по ссылающимся IP-адресам
referringSubnetsDynamics	Значение динамики по ссылающимся подсетям
trustRankDynamics	Значение динамики по показателю TrustRank (устаревший)
citationRankDynamics	Значение динамики по показателю CitationRank (устаревший)
domainZoneEduDynamics	Значение динамики по ссылающимся доменам в зоне .edu (устаревший)
domainZoneGovDynamics	Значение динамики по ссылающимся доменам в зоне .gov (устаревший)
outlinksTotalDynamics	Значение динамики по исходящим ссылкам (устаревший)
outlinksUniqueDynamics	Значение динамики по уникальным исходящим ссылкам (устаревший)
facebookLinksDynamics	Значение динамики по ссылкам из социальной сети Facebook (устаревший)
pinterestLinksDynamics	Значение динамики по ссылкам из социальной сети Pinterest (устаревший)
linkedinLinksDynamics	Значение динамики по ссылкам из социальной сети LinkedIn (устаревший)
vkLinksDynamics	Значение динамики по ссылкам из социальной сети vKontakte (устаревший)
typeTextDynamics	Значение динамики по ссылающимся текстовым ссылкам
typeImgDynamics	Значение динамики по ссылающимся изображениям
typeRedirectDynamics	Значение динамики по ссылающимся редиректам
typeAltDynamics	Значение динамики по ссылкам из атрибута alt
threats	Количество ссылающихся зараженных сайтов
threatsDynamics	Значение динамики по ссылающимся зараженным сайтам
mainPageLinks	Количество ссылающихся главных страниц
mainPageLinksDynamics	Значение динамики по ссылающимся главным страницам
domainRank	Показатель Serpstat Domain Rank

За 1 запрос снимается 1 лимит API.

Example PHP Python

Request data:

{
 "id": "1",
 "method": "SerpstatBacklinksProcedure.getSummary",
 "params": {
     "query" : "serpstat.com",
     "searchType": "domain"
  }
}

Response data:

{
    "id": "1",
    "result": {
        "data": {
            "referringDomains": 4545,
            "referringSubDomains": 975,
            "referringLinks": 45333,
            "totalIndexed": 914,
            "externalDomains": 22,
            "noFollowLinks": 17035,
            "doFollowLinks": 80136,
            "referringIps": 3869,
            "referringSubnets": 2261,
            "trustRank": 0,
            "citationRank": 0,
            "domainZoneEdu": 0,
            "domainZoneGov": 0,
            "outlinksTotal": 19760,
            "outlinksUnique": 1284,
            "facebookLinks": 0,
            "pinterestLinks": 0,
            "linkedinLinks": 0,
            "vkLinks": 0,
            "typeText": 84775,
            "typeImg": 11498,
            "typeRedirect": 898,
            "typeAlt": 0,
            "referringDomainsDynamics": 19,
            "referringSubDomainsDynamics": 10,
            "referringLinksDynamics": 142,
            "totalIndexedDynamics": 31,
            "externalDomainsDynamics": 1,
            "noFollowLinksDynamics": 30,
            "doFollowLinksDynamics": 488,
            "referringIpsDynamics": 14,
            "referringSubnetsDynamics": 8,
            "trustRankDynamics": 0,
            "citationRankDynamics": 0,
            "domainZoneEduDynamics": 0,
            "domainZoneGovDynamics": 0,
            "outlinksTotalDynamics": 2224,
            "outlinksUniqueDynamics": 5,
            "facebookLinksDynamics": null,
            "pinterestLinksDynamics": null,
            "linkedinLinksDynamics": null,
            "vkLinksDynamics": null,
            "typeTextDynamics": 513,
            "typeImgDynamics": 3,
            "typeRedirectDynamics": 2,
            "typeAltDynamics": 0,
            "threats": 5,
            "threatsDynamics": 0,
            "mainPageLinks": 3848,
            "mainPageLinksDynamics": 10,
            "domainRank": 57.826405000000001
        },
        "summary_info": {
            "left_lines": 9988762,
            "page": 1,
            "count": null,
            "total": null,
            "sort": null,
            "order": null
        }
    }
}

<?php
$client = new http\Client;
$request = new http\Client\Request;
$request->setRequestUrl('http://api.serpstat.com/v4/?token={{token}}');
$request->setRequestMethod('POST');
$body = new http\Message\Body;
$body->append('{
 "id": "",
 "method": "SerpstatBacklinksProcedure.getSummary",
 "params": {
     "query" : "allo.ua"
  }
}');
$request->setBody($body);
$request->setOptions(array());
$request->setHeaders(array(
  'Content-Type' => 'application/json'
));
$client->enqueue($request)->send();
$response = $client->getResponse();
echo $response->getBody();

import http.client
import mimetypes
conn = http.client.HTTPSConnection("api.serpstat.com")
payload = "{\r\n \"id\": \"\",\r\n \"method\": \"SerpstatBacklinksProcedure.getSummary\",\r\n \"params\": {\r\n     \"query\" : \"allo.ua\"\r\n  }\r\n}"
headers = {
  'Content-Type': 'application/json'
}
conn.request("POST", "/v4/?token={{token}}", payload, headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))