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