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