Перетин донорів - деталізація

Метод SerpstatBacklinksProcedure.getIntersect повертає список вхідних посилань з донорів, що перетинаються, на аналізовані домени. За набором даних аналогічний до звіту «Перетин донорів».

список вхідних посилань з донорів, що перетинаються, на аналізовані домени

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

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

Параметри запиту
Параметр	Опис	Тип даних	Обов'язковий	Значення за замовчуванням	Варіанти значень
id	Ідентифікатор запиту: відповідь містить цей же ідентифікатор. Введення числового (number) або текстового (string) значення	int/string	так		будь-яке текстове або числове значення Наприклад: 1, test
method	Назва методу API	string	так		SerpstatBacklinksProcedure.getIntersect
params	Об'єкт з параметрами {...}, в ньому перераховуються всі нижченаведені параметри та масиви [...]		так
query	Домен аналізованого сайту. Вказуємо домен без http / https і «/»	string	так		Текстове значення аналізованого домену. Наприклад: 000webhostapp.com
intersect	Домени для порівняння у вигляді: site.com	string	так		klubok.com, issaplus.com
page	Номер сторінки (числове значення)	int	ні	1	будь-яке числове значення
size	Кількість результатів (числове значення)	int	ні	100	числове значення у діапазоні 1-1000
sort	Сортування даних	string	ні	domain_rank - SDR (asc - за зростанням	* domain_rank - SDR * links_count1 - кількість посилань на домен # 1 * links_count2 - кількість посилань на домен # 2 * links_count3 - кількість посилань на домен # 3
order	Напрямок сортування	string	ні	desc	* asc - по зростанню * desc - по спадаючій

Параметри фільтрації
Параметр		Опис
complexFilter		Фільтрація даних, вводиться у вигляді масивів [...]. * field - тип фільтру Доступні фільтри: * domain_from - донор * domain_rank - SDR (Serpstat Domain Rank) * links_count1 - кількість посилань на домен # 1 * links_count2 - кількість посилань на домен # 2 * links_count3 - кількість посилань на домен # 3 (якщо є третій домен) * lastupdate - дата першого виявлення. Формат значення: ДД.ММ.РРРР (01.01.2001) * compareType - умова фільтру * gt - більше, ніж (числове значення) * lt - менше, ніж (числове значення) * gte - більше або дорівнює (числове значення) * lte - менше або дорівнює (числове значення) * eq - точна відповідність (числове та текстове значення) * neq - НЕ відповідає (числове та текстове значення) * between - між (числове значення) * contains - містить (текстове значення) * notContains - не містить (текстове значення) * startsWith - починається на (текстове значення) * endsWith - закінчується на (текстове значення) * value - значення для фільтрації Перші квадратні дужки перераховують умови "АБО". Другі всередині перших - умови "І".

Параметри відповіді
Параметр	Опис
id	Ідентифікатор відповіді: відповідає id в запиті
result	Містить в собі відповідь
data	Масив з даними
domain	Домен для сортування
Links count for domain #1	Кількість посилань на домен # 1
Links count for domain #2	Кількість посилань на домен # 2
Links count for domain #3	Кількість посилань на домен # 3
SDR	Показник авторитетності домену — Serpstat Domain Rank
summary_info	Масив з даними
page	Номер сторінки
order	Дані відсортовані: * asc - за зростанням * desc - за спаданням
sort	Дані, за якими відбувається сортування
total	Кількість результатів за запитом (всього)
count	Кількість результатів в даній відповіді
left_lines	Ліміт рядків для тарифного плану, що залишився

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

{
     "Domain": "hunter.io",
     "SDR": 62,
     "Links count for domain #1 gepur.com": 2,
     "Links count for domain #2 klubok.com": 5,
     "Links count for domain #3 issaplus.com": 0
}

Example

Request data:

{
 "id": 1,
 "method": "SerpstatBacklinksProcedure.getIntersect",
 "params": {
     "query": "gepur.com",
     "sort": "links_count1",
     "order": "desc",
     "page": 1,
     "size": 2,
     "intersect": ["klubok.com", "issaplus.com"],
     "complexFilter":[
           [
                {
                    "field": "domain_rank",
                    "compareType": "gte",
                    "value": [
                        "1"
                    ]
                },
                {
                    "field": "links_count1",
                    "compareType": "gte",
                    "value": [
                        "1"
                    ]
                },
                {
                    "field": "links_count2",
                    "compareType": "gte",
                    "value": [
                        "1"
                    ]
                }
            ]
        ]
  }
}

Response data:

{
    "id": "1",
    "result": {
        "data": [
            {
                "Domain": "znaxarenko.mybb.ru",
                "SDR": 5,
                "Links count for domain #1 gepur.com": 177,
                "Links count for domain #2 klubok.com": 3,
                "Links count for domain #3 issaplus.com": 0
            },
            {
                "Domain": "speshka.com",
                "SDR": 30,
                "Links count for domain #1 gepur.com": 61,
                "Links count for domain #2 klubok.com": 1,
                "Links count for domain #3 issaplus.com": 92
            }
        ],
        "summary_info": {
            "left_lines": 499945,
            "page": 1,
            "count": 2,
            "total": 229,
            "sort": "links_count1",
            "order": "DESC"
        }
    }
}