Домени, що посилаються (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
}
{
"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"
]
}
]
]
}
}
{
"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"
}
}
}