SEO-проекты · token

`competitors` Конкуренты: видимость доменов в выдаче по запросам проекта

Отдаёт данные отчёта «Анализ конкурентов» проекта: какие домены встречаются в выдаче по запросам проекта, их видимость, прогнозный трафик и попадания в ТОП-10 и ТОП-100, изменение за период и ряды для графика. Метод синхронный — считает по уже снятым позициям.

Адрес: /projects/api/v1/competitors/get
Режим: синхронный
Лимиты: вызов не тратит
Доменов: до 150 в ответе

Конкуренты за период

GET /projects/api/v1/competitors/get

Берёт апдейты позиций проекта в интервале from–to. Таблица table_data — значения на самом свежем апдейте интервала и разница с самым старым; chart_data — значения по каждому апдейту для графика. Домен проекта и домены из списка конкурентов в настройках проекта есть в ответе всегда — с нулями, если в выдаче их не нашлось.

Параметры query

token string обязательный

Ключ API из настроек аккаунта — тот же, что key у методов инструментов.
project_id int обязательный

ID проекта. Виден в адресе страницы проекта и в ответе projects/get.
search_system_id string

ID поисковой системы проекта из search-systems/get или all — сводно по всем системам проекта.

По умолчанию all
from date

Начало периода, ГГГГ-ММ-ДД. По умолчанию — 30 дней до to. Раньше даты создания проекта и раньше 2020-03-30 не опускается.
to date

Конец периода. По умолчанию и при дате в будущем — сегодня.
types array

Типы конкурентов. Одно значение строкой или несколько как types[]=primary&types[]=direct.

all
все

primary
ключевой

direct
прямой

indirect
косвенный

По умолчанию all

Ответ

result.table_data object

Домены, ключ — ID домена. Домен проекта идёт первым, остальные — по убыванию видимости.
Вложенные поля
- domain_id, domain string
  
  ID и имя домена.
- update_id string
  
  Апдейт, на котором сняты значения.
- type_id string
  
  Тип конкурента из user_domain_types.
- visibility float
  
  Видимость, %.
- ctr_ws float
  
  Прогнозный трафик (CTR × частота) по запросам проекта.
- top_ten, top_hundred int
  
  Сколько раз домен попал в ТОП-10 и ТОП-100.
- visibility_delta, ctr_ws_delta, top_ten_delta, top_hundred_delta float
  
  Изменение относительно самого старого апдейта периода.
- visibility_arr, ctr_ws_arr, top_ten_arr, top_hundred_arr object
  
  Только при search_system_id=all: те же показатели в разрезе поисковых систем, ключ — ID системы; у видимости ещё weight — вес системы в сводной оценке.
result.chart_data object

Ряды для графика.
Вложенные поля
- default_domains string[]
  
  Домены, которые показывать на графике по умолчанию.
- visibility, ctr_ws, top_ten, top_hundred object
  
  Ключ — домен, значение — точки {x: "ДД.ММ.ГГГГ", y: число} по апдейтам.
- options object
  
  Для каждого показателя — min, max и подпись оси y_axis.
result.user_domain_types object

Справочник типов конкурентов: id, name, slug, order_by.
result.ss_name, result.ss_region string

Название поисковой системы и регион; для all — «Все поисковые системы» и пустая строка.

GET /projects/api/v1/competitors/get

curl -G 'https://tools.pixelplus.ru/projects/api/v1/competitors/get' \
  --data-urlencode 'token=ВАШ_КЛЮЧ' \
  --data-urlencode 'project_id=7002' \
  --data-urlencode 'search_system_id=all' \
  --data-urlencode 'from=2026-09-01' \
  --data-urlencode 'to=2026-09-30'

<?php
$url = 'https://tools.pixelplus.ru/projects/api/v1/competitors/get?' . http_build_query([
    'token' => 'ВАШ_КЛЮЧ',
    'project_id' => 7002,
    'search_system_id' => 'all',
    'from' => '2026-09-01',
    'to' => '2026-09-30',
]);

$ch = curl_init($url);
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 60,
]);
$response = json_decode(curl_exec($ch), true);
curl_close($ch);

print_r($response);

import requests

response = requests.get(
    "https://tools.pixelplus.ru/projects/api/v1/competitors/get",
    params={
        "token": "ВАШ_КЛЮЧ",
        "project_id": 7002,
        "search_system_id": "all",
        "from": "2026-09-01",
        "to": "2026-09-30",
    },
    timeout=60,
)
print(response.json())

project_id обязательный ID проекта. Виден в адресе страницы проекта и в ответе projects/get search_system_id ID поисковой системы проекта из search-systems/get или all — сводно по всем системам проекта from Начало периода, ГГГГ-ММ-ДД to Конец периода

Запрос настоящий — выполнится с вашим ключом

Пример ответа

{
    "status": "ok",
    "code": 1,
    "msg": "success",
    "result": {
        "table_data": {
            "2969": {
                "domain_id": "2969",
                "ss_id_arr": [
                    "1",
                    "324"
                ],
                "update_id": "1731570",
                "domain": "example.ru",
                "visibility_arr": {
                    "1": {
                        "weight": 1,
                        "value": "1.7"
                    },
                    "324": {
                        "weight": 0.86,
                        "value": "0.1"
                    }
                },
                "ctr_ws_arr": {
                    "1": "1760.7",
                    "324": "147.0"
                },
                "top_ten_arr": {
                    "1": "1",
                    "324": "1"
                },
                "top_hundred_arr": {
                    "1": "2",
                    "324": "1"
                },
                "type_id": "3",
                "ss_id": "all",
                "visibility": 0.8,
                "ctr_ws": 1907.7,
                "top_ten": 2,
                "top_hundred": 3,
                "visibility_delta": -5.1,
                "ctr_ws_delta": -2623.2,
                "top_ten_delta": -1,
                "top_hundred_delta": -7
            }
        },
        "chart_data": {
            "default_domains": [
                "example.ru"
            ],
            "visibility": {
                "example.ru": [
                    {
                        "x": "01.09.2026",
                        "y": 5.9
                    },
                    {
                        "x": "05.09.2026",
                        "y": 0.8
                    }
                ]
            },
            "ctr_ws": {
                "example.ru": [
                    {
                        "x": "01.09.2026",
                        "y": 4530.9
                    },
                    {
                        "x": "05.09.2026",
                        "y": 1907.7
                    }
                ]
            },
            "top_ten": {
                "example.ru": [
                    {
                        "x": "01.09.2026",
                        "y": 3
                    },
                    {
                        "x": "05.09.2026",
                        "y": 2
                    }
                ]
            },
            "top_hundred": {
                "example.ru": [
                    {
                        "x": "01.09.2026",
                        "y": 10
                    },
                    {
                        "x": "05.09.2026",
                        "y": 3
                    }
                ]
            },
            "options": {
                "visibility": {
                    "max": 100,
                    "min": 0,
                    "y_axis": "Проценты"
                },
                "ctr_ws": {
                    "max": 4530.9,
                    "min": 0,
                    "y_axis": "Хиты"
                },
                "top_ten": {
                    "max": 3,
                    "min": 0,
                    "y_axis": "Хиты"
                },
                "top_hundred": {
                    "max": 10,
                    "min": 0,
                    "y_axis": "Хиты"
                }
            }
        },
        "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": ""
    }
}

Ошибки

Код	Сообщение	Когда
`50`	`access error`	Токен не передан, не найден, или у его владельца нет доступа к проекту.
`52`	`wrong request data`	Проекта с таким `project_id` нет.

Ответ с ошибкой

{
    "status": "error",
    "code": 50,
    "msg": "access error",
    "result": []
}

Если у проекта ещё нет ни одного успешного апдейта позиций, метод отвечает успехом с пустым result. Если апдейты есть, но не в выбранном периоде, — table_data и ряды графика пустые.

search_system_id должен быть ID системы именно этого проекта из search-systems/get. С чужим или несуществующим ID сервер отвечает ошибкой 500 вместо JSON.