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