Домени, що посилаються (getRefDomains)

Метод getRefDomains повертає список доменів, що посилаються на аналізований сайт, за набором даних аналогічний до звіту "Домени, що посилаються". Неактуальні показники залишаються в методі для збереження зворотної сумісності.

Загальні параметри запиту та інструкція щодо використання Serpstat API

Параметри запиту
Параметр	Значення	Опис
id	any number or string	Ідентифікатор запиту
method	SerpstatBacklinksProcedure.getRefDomains	Назва методу API
params	{...}	Масив з параметрами
query	domain	Домен аналізованого сайту
searchType	domain_with_subdomains \| url	Тип пошуку — домен з піддоменами або url
(optional) page	number	Номер сторінки. За стандартними налаштуваннями: 1
(optional) size	number	Кількість результатів. За стандартними налаштуваннями: 20
(optional) order	desc \| asc	Сортування. За стандартними налаштуваннями: за зменшенням (за кількістю сторінок, що посилаються)

Параметри відповіді
Параметр	Опис
id	Ідентифікатор запиту
result	Інкапсулює відповідь
data	Масив з даними
domain_from	Домен, що посилається
ref_pages	Кількість сторінок, що посилаються
domainRank	Показник Serpstat Domain Rank (SDR)
str	Показник Serpstat TrustRank (неактуальний)
spr	Показник Serpstat PageRank (неактуальний)
summary_info	Масив з даними
page	Номер сторінки
total	Кількість результатів за запитом (всього)
count	Кількість результатів в даній відповіді
left_lines	Ліміт рядків для тарифного плану, що залишився
sort	За якими даними відбувається сортування
order	Дані відсортовані за зростанням / спаданням

Ліміти API знімаються таким чином: по 1 ліміту за 1 рядок результату у відповіді. Частина відповіді API, за яку знімається 1 ліміт:

{
"domain_from": "abroad.ucu.edu.ua",
"ref_pages": "258",
"domainRank": 13.700301,
"str": null,
"spr": null
}

Example

Request data:

{
    "id": 1,
    "method": "SerpstatBacklinksProcedure.getRefDomains",
    "params": {
        "query": {{url}},
        "searchType": {{"domain_with_subdomains"|"url"}},
        (optional) "page": {{page}},
        (optional) "size": {{size}},
        (optional) "order": {{"desc"|"asc"}}
    }
}

Response data:

{
    "id": "1",
    "result": {
        "data": [
            {
                "domain_from": "abroad.ucu.edu.ua",
                "ref_pages": "258",
                "domainRank": 13.700301,
                "str": null,
                "spr": null
            },
            {
                "domain_from": "101.datascience.community",
                "ref_pages": "258",
                "domainRank": 41.6473,
                "str": null,
                "spr": null
            },
            {
                "domain_from": "catholicnews.org.ua",
                "ref_pages": "256",
                "domainRank": 47.71492,
                "str": null,
                "spr": null
            }
        ],
        "summary_info": {
            "page": 1,
            "total": 2090,
            "count": 100,
            "left_lines": 996196,
            "sort": null,
            "order": null
        }
    }
}