Анкори вхiдних посилань

Метод SerpstatBacklinksProcedure.getAnchors повертає список анкорів вхідних посилань на аналізований сайт. За набором даних аналогічний до звіту «Анкори».

список анкорів вхідних посилань на аналізований сайт

Приклад використання: за допомогою методу SerpstatBacklinksProcedure.getAnchors перевірте, які анкори використовують ваші конкуренти, і використовуйте ці анкори для ваших власних посилань.

Загальні параметри запиту та інструкція щодо використання Serpstat API

Параметри запиту
Параметр	Опис	Тип даних	Обов'язковий	Значення за замовчуванням	Варіанти значень
id	Ідентифікатор запиту: відповідь містить цей же ідентифікатор. Введення числового (number) або текстового (string) значення	int/string	так		будь-яке текстове або числове значення Наприклад: 1, test
method	Назва методу API	string	так		SerpstatBacklinksProcedure.getAnchors
params	Об'єкт з параметрами {...}, в ньому перераховуються всі нижченаведені параметри та масиви [...]		так
query	Домен аналізованого сайту. Вказуємо домен без http / https і «/»	string	так		Текстове значення аналізованого домену. Наприклад: 000webhostapp.com
searchType	Режими пошуку для аналізу	string	так		* domain - тільки домен (site.com) * domain_with_subdomains - домен з піддоменами (subdomain.site.com) * URL - тільки URL (site.com/path/) * part_url - URL починається з (site.com/path/*)
page	Номер сторінки (числове значення)	int	ні	1	будь-яке числове значення
size	Кількість результатів (числове значення)	int	ні	100	числове значення у діапазоні 1-1000
order	Напрямок сортування	string	ні	desc	* asc - по зростанню * desc - по спадаючій
sort	Сортування даних	string	ні	lastupdate	* url_from - сторінки, що посилаються * anchor - анкор вхідного посилання * link_nofollow - атрибути посилання * links_external - кількість вихідних посилань, що посилається * link_type - тип вхідного посилання * url_to - цільова сторінка * lastupdate - дата першого виявлення

Параметри фільтрації
Параметр		Опис
complexFilter		Фільтрація даних, вводиться у вигляді масивів [...] з наступними параметрами: 1) field - тип фільтру; доступні фільтри: * url_from - сторінки, що посилаються * anchor - анкор вхідного посилання * link_nofollow - атрибути посилання. Можливі значення: ["0"] для "follow", ["1"] для "nofollow", ["2"] для "ugc", ["4"] для "sponsored", ["0", "1"] для "follow" та "nofollow", ["0", "2"] для "follow" та "ugc" ["0", "4"] для "follow" та "sponsored" ["1", "2"] для "nofollow" та "ugc" ["1", "4"] для "nofollow" та "sponsored" ["4", "2"] для "sponsored" та "ugc" ["0", "1", "2"] для "follow", "nofollow" та "ugc" ["0", "1", "2", "4"] для "follow", "nofollow", "ugc", "sponsored" * links_external - кількість вихідних посилань * link_type - тип вхідного посилання. Можливі значення: text, redirect, iframe, form, canonical, rss, alternate, image * url_to - цільова сторінка * check - дата оновлення посилання, (остання індексація). Формат значення: ДД.ММ.РРРР (01.01.2001) * add - дата виявлення посилання, (перша індексація). Формат значения: ДД.ММ.РРРР (01.01.2001) 2) compareType - умова фільтру: * gt - більше, ніж (числове значення) * lt - менше, ніж (числове значення) * gte - більше або дорівнює (числове значення) * lte - менше або дорівнює (числове значення) * eq - точна відповідність (числове та текстове значення) * neq - НЕ відповідає (числове та текстове значення) * between - між (числове значення) * contains - містить (текстове значення) * notContains - не містить (текстове значення) * startsWith - починається на (текстове значення) * endsWith - закінчується на (текстове значення)

Параметри відповіді
Параметр	Опис
id	Ідентифікатор відповіді: відповідає id в запиті
result	Містить в собі відповідь
data	Масив з даними відповіді
anchor	Текст анкору
refDomains	Кількість доменів, що посилається, з таким анкором
total	Кількість вхідних посилань з таким анкором
noFollow	Кількість вхідних nofollow-посилань з таким анкором
summary_info	Об'єкт з даними відповіді
left_lines	Ліміт рядків для тарифного плану, що залишився
page	Номер сторінки
total	Кількість результатів за запитом (всього)
count	Кількість результатів в даній відповіді
sort	За якими даними відбувається сортування
order	Дані відсортовані: * asc - за зростанням * desc - за спаданням

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

{
     "anchor": "«Serpstat»",
     "refDomains": 3,
     "total": 3,
     "noFollow": 3
}

Example

Request data:

{
 "id": 1,
 "method": "SerpstatBacklinksProcedure.getAnchors",
 "params": {
     "query": "serpstat.com",
     "searchType": "domain_with_subdomains",
     "anchor": "serpstat",
     "count": "1",
     "sort": "anchor",
     "order": "desc",
     "page": 1,
     "size": 2,
     "complexFilter": [
           [
                {
                    "field": "anchor",
                    "compareType": "contains",
                    "value": [
                        "serpstat"
                    ]
                },
                {
                    "field": "total",
                    "compareType": "gt",
                    "value": [
                        "1"
                    ]
                },
                {
                    "field": "noFollow",
                    "compareType": "gte",
                    "value": [
                        "1"
                    ]
                },
                 {
                    "additional_filters": "no_subdomains"
                }
            ]
        ]
  }
}

Response data:

{
    "id": "1",
    "result": {
        "data": [
            {
                "anchor": "加入Serpstat会员计划››",
                "refDomains": 1,
                "total": 2,
                "noFollow": 2
            },
            {
                "anchor": "«Serpstat»",
                "refDomains": 3,
                "total": 3,
                "noFollow": 1
            }
        ],
        "summary_info": {
            "left_lines": 999816,
            "page": 1,
            "count": 2,
            "total": 78,
            "sort": "anchor",
            "order": "DESC"
        }
    }
}