Ссылающиеся домены

Метод SerpstatBacklinksProcedure.getRefDomainsmethod возвращает список ссылающихся на анализируемый сайт доменов, аналогичен отчету «Ссылающиеся домены». Данные в этом и Суммарном отчетах могут немного отличаться из-за алгоритма для быстрого подсчета суммарных данных.

Ссылающиеся домены

Пример использования:  Используя метод SerpstatBacklinksProcedure.getRefDomainsmethod проверьте, какие сайты ссылаются на ваших конкурентов, чтобы разместить на этих же ссылки на ваш сайт.

Общие параметры запроса и инструкция по использованию Serpstat API

Параметры запроса

Параметр

Описание

Тип данных

Обязательный

Значение по умолчанию

Варианты значений

id

Идентификатор запроса: ответ содержит этот же идентификатор.

int/string

да

любое текстовое или числовое значение

Например: 1, test

method

Название метода API

string

да

SerpstatBacklinksProcedure.getRefDomainsmethod

params

Объект с параметрами {...}, в нем перечисляются все нижеследующие параметры и массивы [...]

да

query

Домен анализируемого сайта. Указываем домен без http / https и "/".

string

да

Текстовое значение анализируемого домена.
Например: 000webhostapp.com

searchType

Режимы поиска для анализа

string

да

domain_with_subdomains domain - только домен (site.com)
 domain_with_subdomains - домен с поддоменами(subdomain.site.com)

page

Номер страницы (числовое значение)

int

нет

1 любое числовое значение

size

Количество результатов (числовое значение)

int

нет

100 числовое значение в диапазоне 1-1000

sort

Сортировка данных результата

string

нет

check * domain_links - количество ссылок на домен
* domain_from - донор
* domain_rank - SDR (Serpstat Domain Rank), показатель авторитетности сайта
check - дата первого обнаружения

order

Расположение

string

нет

desc asc - по возрастанию
desc - по убыванию

Параметры фильтрации
Параметр Описание
complexFilter Фильтрация данных, вводится в виде массивов [...] со следующими параметрами: 
1) field - тип фильтра, доступные фильтры:
* domain_links - the number of links to the domain
* domain_from - домен, с которого ведут ссылки
* domain_rank - SDR (Serpstat Domain Rank), показатель авторитетности сайта

2) compareType - условие фильтра:
* gt - больше, чем (числовое значение)
* lt - меньше, чем (числовое значение)
* gte - больше или равно (числовое значение)
* lte - меньше или равно (числовое значение)
* eq - точное соответствие (числовое или текстовое значение)
* neq - не соответствует (числовое или текстовое значение)
* between - между (числовое значение)
* contains - содержит (текстовое значение)
* notContains - не содержит (текстовое значение)
* startsWith - начинается на (текстовое значение)
* endsWith - заканчивается на (текстовое значение)

3) value - значение для фильтрации

Быстрые фильтры:
additional_filters - на данный момент доступны следующие:
* no_subdomains - не учитывает ссылки с поддоменов анализируемого домена
* only_subdomains - показывает только поддомены
* only_hosts - показывает только хосты
* last_week - данные за последнюю неделю

Первые квадратные скобки перечисляют условия "ИЛИ". Вторые внутри первых - условия "И".


Параметры ответа
Параметр Описание
id Идентификатор запроса: соответствует id в запросе
result Содержит ответ
data Массив с данными ответа
domain_from Ссылающийся домен
ref_pages Количество ссылающихся страниц с домена
domainRank Показатель качества ссылочного профиля — Serpstat Domain Rank (SDR)
summary_info Объект с данными ответа
left_lines Оставшееся количество строк для тарифного плана
count Количество результатов в ответе
page Номер страницы
total Количество результатов всего по запросу
sort Данные для сортировки
order Данные отсортированы:
asc - по возрастанию
desc - по убыванию

Снятие лимитов API: по 1 лимиту за 1 строку результата в ответе. Часть ответа API, за которую снимается 1 лимит:

{
     "domain_from": "plus.google.com",
     "ref_pages": 5,
     "domainRank": 97
}

Example
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"
                    ]
                },
                 {
                    "additional_filters": "last_week"
                }
            ]
        ]
  }
}
Response data:
{
    "id": "1",
    "result": {
        "data": [
            {
                "domain_from": "kunocreative.com",
                "ref_pages": 1,
                "domainRank": 58
            },
            {
                "domain_from": "geeknizer.com",
                "ref_pages": 2,
                "domainRank": 47
            }
        ],
        "summary_info": {
            "left_lines": 995119,
            "page": 1,
            "count": 2,
            "total": 17,
            "sort": "domain_rank",
            "order": "DESC"
        }
    }
}

Поделитесь статьей с вашими друзьями

Вы уверены?

Знакомство с Serpstat

Узнайте об основных возможностях сервиса удобным способом!

Отправьте заявку и наш специалист предложит вам варианты обучения: персональную демонстрацию, пробный период или материалы для самостоятельного изучения и повышения экспертизы. Все для комфортного начала работы с Serpstat.

Имя

Email

Телефон

Будем рады вашему комментарию
Я принимаю условия Политики конфиденциальности.

Спасибо, мы сохранили ваши новые настройки рассылок.

Открыть чат технической поддержки