Вихідні посилання (getOutlinks)
Метод getOutlinks повертає список вихідних посилань з аналізованого сайту, за набором даних аналогічний до звіту «Вихідні посилання».
Загальні параметри запиту та інструкція щодо використання Serpstat API
| Параметри запиту |
|||
| Параметр | Опис | За замовчувчанням | |
| id | обов'язково | Ідентифікатор запиту. Допускається введення будь-якого числового або строкового значення. | |
| method | обов'язково | Назва методу API: SerpstatBacklinksProcedure.getOutlinks | |
| params | обов'язково | Об'єкт з параметрами {...}, в ньому перераховуються всі нижченаведені параметри і масиви. | |
| query | обов'язково | Домен аналізованого сайту. Вказуємо домен без http / https і "/". | |
| searchType | обов'язково | Режим пошуку: * domain_with_subdomains - домен з піддоменами * domain - тільки домен * URL - тільки URL |
|
| page | опціонально | Номер сторінки. Допустимі числові значення. | 1 |
| size | опціонально | Кількість результатів. Допустимі числові значення. | 100 |
| sort | опціонально | Сортування даних: * url_from - сторінки, що посилаються * anchor - анкор вхідного посилання * link_nofollow - атрибути посилання * links_external - кількість вихідних посилань з посилається * link_type - тип вхідного посилання * url_to - цільова сторінка * lastupdate - дата першого виявлення |
lastupdate |
| order | опціонально | Напрямок сортування: * asc - по зростанню * desc - по спадаючій |
desc |
| complexFilter | опціонально | Фільтрація даних, вводиться у вигляді масивів. Доступні колонки: * url_from - сторінки, що посилаються * anchor - анкор вхідного посилання * link_nofollow - атрибути посилання. Можливі значення: follow, nofollow, ugc, sponsored * links_external - кількість вихідних посилань з посилається * link_type - тип вхідного посилання. Можливі значення: text, redirect, iframe, form, canonical, rss, alternate, image * url_to - цільова сторінка * lastupdate - дата першого виявлення. Формат значення: ДД.ММ.РРРР (01.01.2001) Типи порівняння: * gt - більше, ніж. Допустимі числові значення * lt - менше, ніж. Допустимі числові значення * gte - більше або дорівнює. Допустимі числові значення * lte - менше або дорівнює. Допустимі числові значення * eq - точна відповідність. Допустимі числові і рядкові значення * neq - НЕ відповідає. Допустимі числові і рядкові значення * between - між. Допустимі числові значення * contains - містить. Допустимі строкові значення * notContains - не містить. Допустимі строкові значення * startsWith - починається на. Допустимі строкові значення * endsWith - закінчується на. Допустимі строкові значення Перші квадратні дужки перераховують умови "АБО". Другі всередині перших - умови "І". |
|
| linkPerDomain | опціонально | Режим отримання даних: * 0 - одне посилання зі сторінки * 1 - одне посилання з домену |
1 |
| Параметри відповіді | |
| Параметр | Опис |
| id | Ідентифікатор запиту |
| result | Інкапсулює в собі відповідь |
| data | Масив з даними |
| url_from | Сторінка, на якій знайдено посилання |
| url_to | Сторінка, до якої веде посилання |
| nofollow | Посилання nofollow (1) або follow (0) |
| link_type | Тип посилання (варіанти: href, image, redirect, frame, rss, alternate, form, canonical) |
| links_ext | Кількість вихідних посилань зі сторінки, що посилається |
| link_text | Анкор посилання |
| first_seen | Дата першого виявлення посилання |
| last_visited | Дата останньої перевірки |
| date_del | Дата, коли бот Serpstat перестав бачити посилання |
| summary_info | Масив з даними |
| page | Номер сторінки |
| total | Кількість результатів за запитом (всього) |
| count | Кількість результатів в даній відповіді |
| left_lines | Ліміт рядків для тарифного плану, що залишився |
| sort | За якими даними відбувається сортування |
| order | Дані відсортовані за зростанням / спаданням |
Ліміти API знімаються таким чином: по 1 ліміту за 1 рядок результату у відповіді. Частина відповіді API, за яку знімається 1 ліміт:
{
"url_from": "https://zerotoscale.com/episode-150-content-creation-process-checklist-vacation-recap/",
"url_to": "https://serpstat.com/",
"nofollow": "follow",
"link_type": "href",
"links_ext": 12,
"link_text": "SerpStat",
"first_seen": "2019-09-05 05:51:46",
"last_visited": "2019-12-11 18:41:42",
"date_del": "2019-12-11 18:41:42"
}Request data:
{
"id": 1,
"method": "SerpstatBacklinksProcedure.getOutlinks",
"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": [
"follow",
"nofollow",
"ugc",
"sponsored"
]
},
{
"field": "anchor",
"compareType": "notContains",
"value": [
"лопспрол"
]
},
{
"field": "lastupdate",
"compareType": "lte",
"value": [
"1.1.2030"
]
},
{
"field": "links_external",
"compareType": "between",
"value": [
"1",
"500"
]
}
],
[
{
"field": "links_external",
"compareType": "lte",
"value": [
"800"
]
}
]
]
}
}Response data:
{
"id": "1",
"result": {
"data": [
{
"url_from": "https://zerotoscale.com/episode-150-content-creation-process-checklist-vacation-recap/",
"url_to": "https://serpstat.com/",
"nofollow": "follow",
"link_type": "href",
"links_ext": 12,
"link_text": "SerpStat",
"first_seen": "2019-09-05 05:51:46",
"last_visited": "2019-12-11 18:41:42",
"date_del": "2019-12-11 18:41:42"
},
{
"url_from": "https://zen.yandex.ru/media/oxjornal/poleznye-instrumenty-i-saity-dlia-seospecialista-59f08c339d5cb307089b57bd",
"url_to": "https://serpstat.com/",
"nofollow": "follow",
"link_type": "href",
"links_ext": 14,
"link_text": "Serpstat",
"first_seen": "2019-03-20 12:08:14",
"last_visited": "2019-11-01 16:03:36",
"date_del": "2019-11-01 16:03:36"
}
],
"summary_info": {
"left_lines": 999995,
"page": 1,
"count": 2,
"total": 1440,
"sort": "url_from",
"order": "DESC"
}
}
}