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

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

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

Параметри запиту
Параметр		Опис	За замовчувчанням
id	обов'язково	Ідентифікатор запиту. Допускається введення будь-якого числового або строкового значення.
method	обов'язково	Назва методу API: SerpstatBacklinksProcedure.getRefDomains
params	обов'язково	Об'єкт з параметрами {...}, в ньому перераховуються всі нижченаведені параметри і масиви.
query	обов'язково	Домен аналізованого сайту. Вказуємо домен без http / https і "/".
searchType	обов'язково	Режим пошуку: * domain_with_subdomains - домен з піддоменами * domain - тільки домен * URL - тільки URL
page	опціонально	Номер сторінки. Допустимі числові значення.	1
size	опціонально	Кількість результатів. Допустимі числові значення.	100
sort	опціонально	Сортування даних: * domain_links - кількість посилань на домен * domain_from - донор * domain_rank - SDR (Serpstat Domain Rank) * lastupdate - дата першого виявлення	lastupdate
order	опціонально	Напрямок сортування: * asc - по зростанню * desc - по спадаючій	desc
complexFilter	опціонально	Фільтрація даних, вводиться у вигляді масивів. Доступні колонки: * domain_links - кількість посилань на домен * domain_from - донор * domain_rank - SDR (Serpstat Domain Rank) * lastupdate - дата першого виявлення. Формат значення: ДД.ММ.РРРР (01.01.2001) Типи порівняння: * gt - більше, ніж. Допустимі числові значення * lt - менше, ніж. Допустимі числові значення * gte - більше або дорівнює. Допустимі числові значення * lte - менше або дорівнює. Допустимі числові значення * eq - точна відповідність. Допустимі числові і рядкові значення * neq - НЕ відповідає. Допустимі числові і рядкові значення * between - між. Допустимі числові значення * contains - містить. Допустимі строкові значення * notContains - не містить. Допустимі строкові значення * startsWith - починається на. Допустимі строкові значення * endsWith - закінчується на. Допустимі строкові значення Перші квадратні дужки перераховують умови "АБО". Другі всередині перших - умови "І".

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

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

 {
                "domain_from": "plus.google.com",
                "ref_pages": 5,
                "domainRank": 97
            }

Example PHP Python

Request data:

{
 "id": "1",
 "method": "SerpstatBacklinksProcedure.getRefDomains",
 "params": {
     "query" : "serpstat.com",
     "searchType": "domain",
     "order": "desc",
     "page": 1,
     "size": 2,
     "sort": "domain_rank",
     "complexFilter":[
            [
                {
                    "field": "domain_from",
                    "compareType": "contains",
                    "value": [
                        ".com"
                    ]
                },
                 {
                    "field": "domain_rank",
                    "compareType": "gte",
                    "value": [
                        "1"
                    ]
                },
                 {
                    "field": "domain_links",
                    "compareType": "gte",
                    "value": [
                        "1"
                    ]
                }
            ]
        ]
  }
}

Response data:

{
    "id": "1",
    "result": {
        "data": [
            {
                "domain_from": "plus.google.com",
                "ref_pages": 5,
                "domainRank": 97
            },
            {
                "domain_from": "github.com",
                "ref_pages": 12,
                "domainRank": 93
            }
        ],
        "summary_info": {
            "left_lines": 999821,
            "page": 1,
            "count": 2,
            "total": 2853,
            "sort": "domain_rank",
            "order": "DESC"
        }
    }
}