Документация на группу методов "competitors"
Доступ к API осуществляется GET-запросом по адресу
https://tools.pixelplus.ru/projects/api/v1/<ИМЯ ГРУППЫ>/<ИМЯ МЕТОДА>?<ПАРАМЕТРЫ>
Токен доступа передается GET-параметром в общем списке параметров
(&token=<ВАШ ТОКЕН>)
Поддерживаемые методы для группы competitors:
get (отдает позиции по проекту)
параметры:
(int) project_id — id проекта
(int) search_system_id — id поисковой системы, по умолчнанию "all"
(string) from — дата начала интервала, по умолчанию 30 дней назад
(string) to — дата окончания интервала, по умолчанию текущая дата
Пример запроса:
tools.pixelplus.ru/projects/api/v1/competitors/get?token=testtoken&project_id=990&from=2025-03-01&to=2025-03-18&search_system_id=all
Пример получения данных с данного API:
{
"status": "ok",
"code": 1,
"msg": "success",
"result": {
"table_data": {
"2969": {
"domain_id": "2969",
"ss_id_arr": [
"1",
"5",
"324",
"326"
],
"update_id": "1731570",
"domain": "pixelplus.ru",
"visibility_arr": {
"1": {
"weight": 1,
"value": "1.7"
},
"5": {
"weight": 0.25,
"value": "0.2"
},
"324": {
"weight": 0.86,
"value": "0.1"
},
"326": {
"weight": 0.22,
"value": "0.1"
}
},
"ctr_ws_arr": {
"1": "1760.7",
"5": "205.5",
"324": "147.0",
"326": "147.0"
},
"top_ten_arr": {
"1": "1",
"5": "1",
"324": "1",
"326": "1"
},
"top_hundred_arr": {
"1": "2",
"5": "2",
"324": "1",
"326": "1"
},
"type_id": "3",
"ss_id": "all",
"visibility": 0.8,
"ctr_ws": 2260.2,
"top_ten": 4,
"top_hundred": 6,
"domain_id_delta": 0,
"update_id_delta": 16904,
"domain_delta": 0,
"type_id_delta": 0,
"ss_id_delta": 0,
"visibility_delta": -5.1,
"ctr_ws_delta": -26233.2,
"top_ten_delta": -1,
"top_hundred_delta": -7
},
"117": {
"domain_id": "117",
"ss_id_arr": [
"324",
"326",
"5",
"1"
],
"update_id": "1731570",
"domain": "yandex.ru",
"visibility_arr": {
"324": {
"weight": 0.86,
"value": "100.0"
},
"326": {
"weight": 0.22,
"value": "100.0"
},
"5": {
"weight": 0.25,
"value": "99.9"
},
"1": {
"weight": 1,
"value": "99.9"
}
},
"ctr_ws_arr": {
"324": "64868.7",
"326": "64840.5",
"5": "64813.5",
"1": "64506.7"
},
"top_ten_arr": {
"324": "7",
"326": "7",
"5": "7",
"1": "7"
},
"top_hundred_arr": {
"324": "7",
"326": "7",
"5": "7",
"1": "7"
},
"type_id": "3",
"ss_id": "all",
"visibility": 99.9,
"ctr_ws": 259029.4,
"top_ten": 28,
"top_hundred": 28,
"domain_id_delta": 0,
"update_id_delta": 16904,
"domain_delta": 0,
"type_id_delta": 0,
"ss_id_delta": 0,
"visibility_delta": 2.1,
"ctr_ws_delta": 11725,
"top_ten_delta": 0,
"top_hundred_delta": 0
},
"5081": {
"domain_id": "5081",
"ss_id_arr": [
"5",
"326",
"1",
"324"
],
"update_id": "1731570",
"domain": "unisender.com",
"visibility_arr": {
"5": {
"weight": 0.25,
"value": "66.4"
},
"326": {
"weight": 0.22,
"value": "36.6"
},
"1": {
"weight": 1,
"value": "36.2"
},
"324": {
"weight": 0.86,
"value": "26.6"
}
},
"ctr_ws_arr": {
"5": "25837.4",
"326": "13940.0",
"1": "13795.7",
"324": "13879.0"
},
"top_ten_arr": {
"5": "4",
"326": "4",
"1": "3",
"324": "2"
},
"top_hundred_arr": {
"5": "5",
"326": "5",
"1": "4",
"324": "5"
},
"type_id": "3",
"ss_id": "all",
"visibility": 35.9,
"ctr_ws": 67452.1,
"top_ten": 13,
"top_hundred": 19,
"domain_id_delta": 0,
"update_id_delta": 16904,
"domain_delta": 0,
"type_id_delta": 0,
"ss_id_delta": 0,
"visibility_delta": 16.9,
"ctr_ws_delta": 2469.1,
"top_ten_delta": 2,
"top_hundred_delta": -1
},
"3516": {
"domain_id": "3516",
"ss_id_arr": [
"326",
"324",
"5",
"1"
],
"update_id": "1731570",
"domain": "timeweb.com",
"visibility_arr": {
"326": {
"weight": 0.22,
"value": "17.4"
},
"324": {
"weight": 0.86,
"value": "17.3"
},
"5": {
"weight": 0.25,
"value": "16.1"
},
"1": {
"weight": 1,
"value": "14.3"
}
},
"ctr_ws_arr": {
"326": "14193.3",
"324": "14125.7",
"5": "13470.1",
"1": "6923.2"
},
"top_ten_arr": {
"326": "4",
"324": "4",
"5": "4",
"1": "4"
},
"top_hundred_arr": {
"326": "6",
"324": "6",
"5": "6",
"1": "6"
},
"type_id": "3",
"ss_id": "all",
"visibility": 15.9,
"ctr_ws": 48712.3,
"top_ten": 16,
"top_hundred": 24,
"domain_id_delta": 0,
"update_id_delta": 16904,
"domain_delta": 0,
"type_id_delta": 0,
"ss_id_delta": 0,
"visibility_delta": -6.6,
"ctr_ws_delta": 3042.7,
"top_ten_delta": -1,
"top_hundred_delta": 0
},
"3385": {
"domain_id": "3385",
"ss_id_arr": [
"324",
"5",
"1",
"326"
],
"update_id": "1731570",
"domain": "1ps.ru",
"visibility_arr": {
"324": {
"weight": 0.86,
"value": "6.5"
},
"5": {
"weight": 0.25,
"value": "5.0"
},
"1": {
"weight": 1,
"value": "5.0"
},
"326": {
"weight": 0.22,
"value": "4.9"
}
},
"ctr_ws_arr": {
"324": "6214.6",
"5": "11626.6",
"1": "4779.1",
"326": "4971.6"
},
"top_ten_arr": {
"324": "0",
"5": "0",
"1": "0",
"326": "0"
},
"top_hundred_arr": {
"324": "4",
"5": "3",
"1": "3",
"326": "2"
},
"type_id": "3",
"ss_id": "all",
"visibility": 5.5,
"ctr_ws": 27591.9,
"top_ten": 0,
"top_hundred": 12,
"domain_id_delta": 0,
"update_id_delta": 16904,
"domain_delta": 0,
"type_id_delta": 0,
"ss_id_delta": 0,
"visibility_delta": 2,
"ctr_ws_delta": 10253.9,
"top_ten_delta": 0,
"top_hundred_delta": 0
},
"62": {
"domain_id": "62",
"ss_id_arr": [
"1",
"5",
"324",
"326"
],
"update_id": "1731570",
"domain": "pr-cy.ru",
"visibility_arr": {
"1": {
"weight": 1,
"value": "0.1"
},
"5": {
"weight": 0.25,
"value": 0
},
"324": {
"weight": 0.86,
"value": 0
},
"326": {
"weight": 0.22,
"value": 0
}
},
"ctr_ws_arr": {
"1": "62.1",
"5": 0,
"324": 0,
"326": 0
},
"top_ten_arr": {
"1": "0",
"5": 0,
"324": 0,
"326": 0
},
"top_hundred_arr": {
"1": "1",
"5": 0,
"324": 0,
"326": 0
},
"type_id": "3",
"ss_id": "all",
"visibility": 0,
"ctr_ws": 62.1,
"top_ten": 0,
"top_hundred": 1,
"domain_id_delta": "62",
"update_id_delta": "1731570",
"domain_delta": "pr-cy.ru",
"type_id_delta": "3",
"ss_id_delta": "all",
"visibility_delta": 0,
"ctr_ws_delta": 62.1,
"top_ten_delta": 0,
"top_hundred_delta": 1
},
"3412": {
"domain_id": 3412,
"ss_id_arr": 0,
"update_id": 0,
"domain": "ashmanov.com",
"visibility_arr": 0,
"ctr_ws_arr": 0,
"top_ten_arr": 0,
"top_hundred_arr": 0,
"type_id": 0,
"ss_id": 0,
"visibility": 0,
"ctr_ws": 0,
"top_ten": 0,
"top_hundred": 0,
"domain_id_delta": 0,
"ss_id_arr_delta": 0,
"update_id_delta": -1714666,
"domain_delta": 0,
"visibility_arr_delta": 0,
"ctr_ws_arr_delta": 0,
"top_ten_arr_delta": 0,
"top_hundred_arr_delta": 0,
"type_id_delta": -3,
"ss_id_delta": 0,
"visibility_delta": -1.6,
"ctr_ws_delta": -15391.5,
"top_ten_delta": 0,
"top_hundred_delta": -2
},
"8572": {
"domain_id": 8572,
"ss_id_arr": 0,
"update_id": 0,
"domain": "topvisor.com",
"visibility_arr": 0,
"ctr_ws_arr": 0,
"top_ten_arr": 0,
"top_hundred_arr": 0,
"type_id": 0,
"ss_id": 0,
"visibility": 0,
"ctr_ws": 0,
"top_ten": 0,
"top_hundred": 0,
"domain_id_delta": 8572,
"ss_id_arr_delta": 0,
"update_id_delta": 0,
"domain_delta": "topvisor.com",
"visibility_arr_delta": 0,
"ctr_ws_arr_delta": 0,
"top_ten_arr_delta": 0,
"top_hundred_arr_delta": 0,
"type_id_delta": 0,
"ss_id_delta": 0,
"visibility_delta": 0,
"ctr_ws_delta": 0,
"top_ten_delta": 0,
"top_hundred_delta": 0
}
},
"chart_data": {
"default_domains": [
"pixelplus.ru",
"yandex.ru",
"unisender.com",
"timeweb.com",
"1ps.ru"
],
"visibility": {
"pixelplus.ru": [
{
"x": "01.03.2025",
"y": 5.9
},
{
"x": "05.03.2025",
"y": 0.9
},
{
"x": "08.03.2025",
"y": 0.1
},
{
"x": "12.03.2025",
"y": 1.5
},
{
"x": "15.03.2025",
"y": 0.8
}
],
"yandex.ru": [
{
"x": "01.03.2025",
"y": 97.8
},
{
"x": "05.03.2025",
"y": 100
},
{
"x": "08.03.2025",
"y": 81.9
},
{
"x": "12.03.2025",
"y": 100
},
{
"x": "15.03.2025",
"y": 99.9
}
],
"unisender.com": [
{
"x": "01.03.2025",
"y": 19
},
{
"x": "05.03.2025",
"y": 33
},
{
"x": "08.03.2025",
"y": 41.5
},
{
"x": "12.03.2025",
"y": 34.3
},
{
"x": "15.03.2025",
"y": 35.9
}
],
"timeweb.com": [
{
"x": "01.03.2025",
"y": 22.5
},
{
"x": "05.03.2025",
"y": 20
},
{
"x": "08.03.2025",
"y": 21.4
},
{
"x": "12.03.2025",
"y": 19
},
{
"x": "15.03.2025",
"y": 15.9
}
],
"1ps.ru": [
{
"x": "01.03.2025",
"y": 3.5
},
{
"x": "05.03.2025",
"y": 6.6
},
{
"x": "08.03.2025",
"y": 5.3
},
{
"x": "12.03.2025",
"y": 6
},
{
"x": "15.03.2025",
"y": 5.5
}
],
"pr-cy.ru": [
{
"x": "01.03.2025",
"y": 0
},
{
"x": "05.03.2025",
"y": 0.2
},
{
"x": "08.03.2025",
"y": 0
},
{
"x": "12.03.2025",
"y": 0
},
{
"x": "15.03.2025",
"y": 0
}
],
"ashmanov.com": [
{
"x": "01.03.2025",
"y": 0
},
{
"x": "05.03.2025",
"y": 0
},
{
"x": "08.03.2025",
"y": 0
},
{
"x": "12.03.2025",
"y": 0
},
{
"x": "15.03.2025",
"y": 0
}
],
"topvisor.com": [
{
"x": "01.03.2025",
"y": 0
},
{
"x": "05.03.2025",
"y": 0
},
{
"x": "08.03.2025",
"y": 0
},
{
"x": "12.03.2025",
"y": 0
},
{
"x": "15.03.2025",
"y": 0
}
]
},
"options": {
"visibility": {
"max": 100,
"min": 0,
"y_axis": "Проценты"
},
"ctr_ws": {
"max": 259029.4,
"min": 0,
"y_axis": "Хиты"
},
"top_ten": {
"max": 28,
"min": 0,
"y_axis": "Хиты"
},
"top_hundred": {
"max": 28,
"min": 0,
"y_axis": "Хиты"
}
},
"ctr_ws": {
"pixelplus.ru": [
{
"x": "01.03.2025",
"y": 28493.4
},
{
"x": "05.03.2025",
"y": 2571.3
},
{
"x": "08.03.2025",
"y": 650.1
},
{
"x": "12.03.2025",
"y": 2656.3
},
{
"x": "15.03.2025",
"y": 2260.2
}
],
"yandex.ru": [
{
"x": "01.03.2025",
"y": 247304.4
},
{
"x": "05.03.2025",
"y": 251068.8
},
{
"x": "08.03.2025",
"y": 201059.2
},
{
"x": "12.03.2025",
"y": 252830.7
},
{
"x": "15.03.2025",
"y": 259029.4
}
],
"unisender.com": [
{
"x": "01.03.2025",
"y": 64983
},
{
"x": "05.03.2025",
"y": 63614.2
},
{
"x": "08.03.2025",
"y": 82945.4
},
{
"x": "12.03.2025",
"y": 58996.2
},
{
"x": "15.03.2025",
"y": 67452.1
}
],
"timeweb.com": [
{
"x": "01.03.2025",
"y": 45669.6
},
{
"x": "05.03.2025",
"y": 58589.6
},
{
"x": "08.03.2025",
"y": 60526.6
},
{
"x": "12.03.2025",
"y": 54674.3
},
{
"x": "15.03.2025",
"y": 48712.3
}
],
"1ps.ru": [
{
"x": "01.03.2025",
"y": 17338
},
{
"x": "05.03.2025",
"y": 21434.1
},
{
"x": "08.03.2025",
"y": 23050
},
{
"x": "12.03.2025",
"y": 32163.3
},
{
"x": "15.03.2025",
"y": 27591.9
}
],
"pr-cy.ru": [
{
"x": "01.03.2025",
"y": 0
},
{
"x": "05.03.2025",
"y": 1870.8
},
{
"x": "08.03.2025",
"y": 0
},
{
"x": "12.03.2025",
"y": 0
},
{
"x": "15.03.2025",
"y": 62.1
}
],
"ashmanov.com": [
{
"x": "01.03.2025",
"y": 0
},
{
"x": "05.03.2025",
"y": 0
},
{
"x": "08.03.2025",
"y": 0
},
{
"x": "12.03.2025",
"y": 0
},
{
"x": "15.03.2025",
"y": 0
}
],
"topvisor.com": [
{
"x": "01.03.2025",
"y": 0
},
{
"x": "05.03.2025",
"y": 0
},
{
"x": "08.03.2025",
"y": 0
},
{
"x": "12.03.2025",
"y": 0
},
{
"x": "15.03.2025",
"y": 0
}
]
},
"top_ten": {
"pixelplus.ru": [
{
"x": "01.03.2025",
"y": 5
},
{
"x": "05.03.2025",
"y": 4
},
{
"x": "08.03.2025",
"y": 4
},
{
"x": "12.03.2025",
"y": 4
},
{
"x": "15.03.2025",
"y": 4
}
],
"yandex.ru": [
{
"x": "01.03.2025",
"y": 28
},
{
"x": "05.03.2025",
"y": 28
},
{
"x": "08.03.2025",
"y": 26
},
{
"x": "12.03.2025",
"y": 28
},
{
"x": "15.03.2025",
"y": 28
}
],
"unisender.com": [
{
"x": "01.03.2025",
"y": 11
},
{
"x": "05.03.2025",
"y": 13
},
{
"x": "08.03.2025",
"y": 12
},
{
"x": "12.03.2025",
"y": 14
},
{
"x": "15.03.2025",
"y": 13
}
],
"timeweb.com": [
{
"x": "01.03.2025",
"y": 17
},
{
"x": "05.03.2025",
"y": 15
},
{
"x": "08.03.2025",
"y": 19
},
{
"x": "12.03.2025",
"y": 17
},
{
"x": "15.03.2025",
"y": 16
}
],
"1ps.ru": [
{
"x": "01.03.2025",
"y": 0
},
{
"x": "05.03.2025",
"y": 1
},
{
"x": "08.03.2025",
"y": 1
},
{
"x": "12.03.2025",
"y": 0
},
{
"x": "15.03.2025",
"y": 0
}
],
"pr-cy.ru": [
{
"x": "01.03.2025",
"y": 0
},
{
"x": "05.03.2025",
"y": 0
},
{
"x": "08.03.2025",
"y": 0
},
{
"x": "12.03.2025",
"y": 0
},
{
"x": "15.03.2025",
"y": 0
}
],
"ashmanov.com": [
{
"x": "01.03.2025",
"y": 0
},
{
"x": "05.03.2025",
"y": 0
},
{
"x": "08.03.2025",
"y": 0
},
{
"x": "12.03.2025",
"y": 0
},
{
"x": "15.03.2025",
"y": 0
}
],
"topvisor.com": [
{
"x": "01.03.2025",
"y": 0
},
{
"x": "05.03.2025",
"y": 0
},
{
"x": "08.03.2025",
"y": 0
},
{
"x": "12.03.2025",
"y": 0
},
{
"x": "15.03.2025",
"y": 0
}
]
},
"top_hundred": {
"pixelplus.ru": [
{
"x": "01.03.2025",
"y": 13
},
{
"x": "05.03.2025",
"y": 8
},
{
"x": "08.03.2025",
"y": 5
},
{
"x": "12.03.2025",
"y": 6
},
{
"x": "15.03.2025",
"y": 6
}
],
"yandex.ru": [
{
"x": "01.03.2025",
"y": 28
},
{
"x": "05.03.2025",
"y": 28
},
{
"x": "08.03.2025",
"y": 26
},
{
"x": "12.03.2025",
"y": 28
},
{
"x": "15.03.2025",
"y": 28
}
],
"unisender.com": [
{
"x": "01.03.2025",
"y": 20
},
{
"x": "05.03.2025",
"y": 20
},
{
"x": "08.03.2025",
"y": 20
},
{
"x": "12.03.2025",
"y": 20
},
{
"x": "15.03.2025",
"y": 19
}
],
"timeweb.com": [
{
"x": "01.03.2025",
"y": 24
},
{
"x": "05.03.2025",
"y": 24
},
{
"x": "08.03.2025",
"y": 24
},
{
"x": "12.03.2025",
"y": 24
},
{
"x": "15.03.2025",
"y": 24
}
],
"1ps.ru": [
{
"x": "01.03.2025",
"y": 12
},
{
"x": "05.03.2025",
"y": 18
},
{
"x": "08.03.2025",
"y": 16
},
{
"x": "12.03.2025",
"y": 17
},
{
"x": "15.03.2025",
"y": 12
}
],
"pr-cy.ru": [
{
"x": "01.03.2025",
"y": 0
},
{
"x": "05.03.2025",
"y": 1
},
{
"x": "08.03.2025",
"y": 0
},
{
"x": "12.03.2025",
"y": 0
},
{
"x": "15.03.2025",
"y": 1
}
],
"ashmanov.com": [
{
"x": "01.03.2025",
"y": 0
},
{
"x": "05.03.2025",
"y": 0
},
{
"x": "08.03.2025",
"y": 0
},
{
"x": "12.03.2025",
"y": 0
},
{
"x": "15.03.2025",
"y": 0
}
],
"topvisor.com": [
{
"x": "01.03.2025",
"y": 0
},
{
"x": "05.03.2025",
"y": 0
},
{
"x": "08.03.2025",
"y": 0
},
{
"x": "12.03.2025",
"y": 0
},
{
"x": "15.03.2025",
"y": 0
}
]
}
},
"user_domain_types": {
"1": {
"id": "1",
"name": "Ключевой",
"slug": "primary",
"order_by": "10"
},
"2": {
"id": "2",
"name": "Прямой",
"slug": "direct",
"order_by": "20"
},
"3": {
"id": "3",
"name": "Косвенный",
"slug": "indirect",
"order_by": "30"
}
},
"ss_name": "Все поисковые системы",
"ss_region": ""
}
}