Ссылающиеся домены (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"
}
}
}