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