Вхiднi активні посилання
Метод SerpstatBacklinksProcedure.getNewBacklinks повертає список активних посилань на аналізований сайт. За набором даних аналогічний до звіту «Активні посилання».
Приклад використання: За допомогою методу SerpstatBacklinksProcedure.getNewBacklinks перевірте активні посилання, що ведуть на домен конкурента, і його рейтинг, щоб дізнатися, на яких доменах краще розміщувати посилання на ваш сайт.
Загальні параметри запиту та інструкція щодо використання Serpstat API
| Параметри запиту | |||||
| Параметр | Опис | Тип даних | Обов'язковий | Значення за замовчуванням | Варіанти значень |
| id | Ідентифікатор запиту: відповідь містить цей же ідентифікатор. Введення числового (number) або текстового (string) значення | int/string | так |
| будь-яке текстове або числове значення |
| method | Назва методу API | string | так |
| SerpstatBacklinksProcedure.getNewBacklinks |
| params | Об'єкт з параметрами {...}, в ньому перераховуються всі нижченаведені параметри та масиви [...] |
| так | ||
| query | Домен аналізованого сайту. Вказуємо домен без http / https і «/» | string | так | Текстове значення аналізованого домену. Наприклад: 000webhostapp.com | |
| searchType | Режими пошуку для аналізу | string | так | * domain - только домен (site.com) * domain_with_subdomains - домен, включающий поддомен (subdomain.site.com) * URL - конкретная страница (site.com/path/) * part_url - адрес страницы начинается с (site.com/path/*) | |
| page | Номер сторінки (числове значення) | int | ні | 1 | будь-яке числове значення |
| size | Кількість результатів (числове значення) | int | ні | 100 | числове значення у діапазоні 1-1000 |
| order | Напрямок сортування | string | ні | desc | * asc - по зростанню * desc - по спадаючій |
| sort | Сортування даних | string | ні | check | * url_from - сторінки, що посилаються * anchor - анкор вхідного посилання * link_nofollow - атрибути посилання * links_external - кількість вихідних посилань * link_type - тип вхідного посилання * url_to - цільова сторінка * add - дата виявлення посилання (перша індексація) * check - дата оновлення посилання (остання індексація) * domain_rank - показник авторитетності сайту від 0 до 100 |
| Параметри фільтрації | ||
| Параметр | Опис | |
| complexFilter | Фільтрація даних, вводиться у вигляді масивів [...] з наступними параметрами: | |
| Параметри відповіді | |
| Параметр | Опис |
| id | Ідентифікатор відповіді: відповідає id в запиті |
| result | Містить в собі відповідь |
| data | Масив з даними відповіді |
| url_from | Сторінка, на якій знайдено посилання (сторінка, на яку посилаються) |
| url_to | Сторінка, до якої веде посилання (цільова сторіна) |
| nofollow | Атрибути посилання. Якщо кілька - перераховані через кому. Варіанти: follow, nofollow, ugc, sponsored |
| link_type | Тип посилання (варіанти: href, image, redirect, frame, rss, alternate, form, canonical) |
| links_ext | Кількість вихідних посилань зі сторінки, що посилається |
| link_text | Анкор посилання (anchor) |
| first_seen | Дата першого виявлення посилання |
| last_visited | Дата останньої перевірки |
| domain_rank | Рейтинг домену, що посилається — Serpstat Domain Rank |
| summary_info | Об'єкт з даними відповіді |
| left_lines | Ліміт рядків для тарифного плану, що залишився |
| page | Номер сторінки |
| count | Кількість результатів в даній відповіді (всього) |
| total | Кількість результатів за запитом (всього) |
| sort | За якими даними відбувається сортування |
| order | Дані відсортовані: * asc - за зростанням * desc - за спаданням |
Ліміти API знімаються таким чином: по 1 ліміту за 1 рядок результату у відповіді. Частина відповіді API, за яку знімається 1 ліміт:
{
"url": "/blog/rank-your-page-for-a-whole-group-instead-of-a-single-keyword-with-our-new-keyword-clustering-tool/",
"ref_pages": 114,
"ref_domains": 69,
"ips": 65,
"urlTo": "https://serpstat.com/blog/rank-your-page-for-a-whole-group-instead-of-a-single-keyword-with-our-new-keyword-clustering-tool/"
}{
"id": 1,
"method": "SerpstatBacklinksProcedure.getNewBacklinks",
"params": {
"query": "serpstat.com",
"searchType": "domain",
"sort": "url_from",
"order": "desc",
"page": 1,
"size": 2,
"linkPerDomain": 1,
"complexFilter": [
[
{
"field": "url_from",
"compareType": "notContains",
"value": [
"7654765"
]
},
{
"field": "link_nofollow",
"compareType": "contains",
"value": [
"0",
"1",
"2",
"4"
]
},
{
"field": "anchor",
"compareType": "notContains",
"value": [
"лопспрол"
]
},
{
"field": "check",
"compareType": "lte",
"value": [
"1.1.2030"
]
},
{
"field": "links_external",
"compareType": "between",
"value": [
"1",
"500"
]
}
],
[
{
"field": "links_external",
"compareType": "lte",
"value": [
"800"
]
},
{
"additional_filters": "no_subdomains"
},
{
"additional_filters": "only_main_page"
}
]
]
}
}{
"id": "1",
"result": {
"data": [
{
"url_from": "https://www.wmlou.com/",
"url_to": "https://serpstat.com/?ref=326045",
"nofollow": "follow",
"link_type": "href",
"links_ext": 330,
"link_text": "Serpstat",
"first_seen": "2020-11-24",
"last_visited": "2021-03-29 09:19:13",
"domain_rank": 22
},
{
"url_from": "https://www.vsesv.com/",
"url_to": "http://serpstat.com",
"nofollow": "follow",
"link_type": "href",
"links_ext": 11,
"link_text": "Serpstat",
"first_seen": "2021-08-06",
"last_visited": "2021-08-06 10:42:54",
"domain_rank": 17
}
],
"summary_info": {
"left_lines": 999806,
"page": 1,
"count": 2,
"total": 167,
"sort": "url_from",
"order": "DESC"
}
}
}