SEO-проекты · token

`summary` Сводка: видимость, потенциал и интегральные оценки проекта

Группа отдаёт показатели со «Сводки» проекта: динамику видимости в выдаче, её изменение между двумя апдейтами позиций по каждой поисковой системе, реализацию потенциала трафика и интегральные оценки внутренней и внешней оптимизации и поведенческих факторов. Все методы синхронные и считают по уже снятым позициям.

Адрес: /projects/api/v1/summary/<блок>/<метод>, /projects/api/v1/integrals/get
Режим: синхронный
Лимиты: вызов не тратит

Динамика видимости

GET /projects/api/v1/summary/visibility/get

Видимость сайта, сводно по всем поисковым системам проекта, на каждый апдейт позиций за период, который заканчивается датой to. Длина периода — интервал сводки из настроек проектов (обычно 30 дней), но не раньше даты создания проекта.

Параметры query

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

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

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

Конец периода, ГГГГ-ММ-ДД, не позже сегодняшнего дня.

По умолчанию сегодня
mode string

Что отдать.

monthly
все апдейты за период

last
одну точку — последний апдейт периода

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

Ответ

result[].date date

Дата апдейта, ГГГГ-ММ-ДД.
result[].visibility float

Видимость, % от 0 до 100.

GET /projects/api/v1/summary/visibility/get

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

<?php
$url = 'https://tools.pixelplus.ru/projects/api/v1/summary/visibility/get?' . http_build_query([
    'token' => 'ВАШ_КЛЮЧ',
    'project_id' => 7002,
    '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/summary/visibility/get",
    params={
        "token": "ВАШ_КЛЮЧ",
        "project_id": 7002,
        "to": "2026-09-30",
    },
    timeout=60,
)
print(response.json())

project_id обязательный ID проекта. Виден в адресе страницы проекта и в ответе projects/get to Конец периода, ГГГГ-ММ-ДД, не позже сегодняшнего дня

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

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

{
    "status": "ok",
    "code": 1,
    "msg": "success",
    "result": [
        {
            "date": "2026-09-21",
            "visibility": 34.2
        },
        {
            "date": "2026-09-28",
            "visibility": 36.8
        }
    ]
}

Изменение видимости между апдейтами

GET /projects/api/v1/summary/visibility/change

Видимость на выбранном апдейте и на предыдущем (закончившемся в другой день) — сводно и по каждой поисковой системе проекта, — и признак резкого падения по порогам из настроек проектов. Без update_id и date_update берётся последний успешный апдейт.

Параметры query

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

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

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

ID апдейта из updates/get.
date_update date

Вместо update_id: апдейт, закончившийся в эту дату, а если такого нет — ближайший после неё. Важнее update_id.

Ответ

result.updates object

current и previous — строки апдейтов: id, dt_start, dt_end, status, queries_count и др.
result.dictionary object

Названия: ключ 0 — «Все поисковые системы», остальные — ID поисковых систем проекта.
result.search_systems_data object

Ключи те же, что в dictionary: current и previous — видимость в %, diff — разница.
result.limits object

Пороги падения из настроек: absolute — в пунктах, relative — в процентах.
result.warnings object

status — превышен ли порог хотя бы где-то, search_systems — где именно (ключи dictionary).

GET /projects/api/v1/summary/visibility/change

curl -G 'https://tools.pixelplus.ru/projects/api/v1/summary/visibility/change' \
  --data-urlencode 'token=ВАШ_КЛЮЧ' \
  --data-urlencode 'project_id=7002' \
  --data-urlencode 'date_update=2026-09-28'

<?php
$url = 'https://tools.pixelplus.ru/projects/api/v1/summary/visibility/change?' . http_build_query([
    'token' => 'ВАШ_КЛЮЧ',
    'project_id' => 7002,
    'date_update' => '2026-09-28',
]);

$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/summary/visibility/change",
    params={
        "token": "ВАШ_КЛЮЧ",
        "project_id": 7002,
        "date_update": "2026-09-28",
    },
    timeout=60,
)
print(response.json())

project_id обязательный ID проекта. Виден в адресе страницы проекта и в ответе projects/get date_update Вместо update_id: апдейт, закончившийся в эту дату, а если такого нет — ближайший после неё

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

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

{
    "status": "ok",
    "code": 1,
    "msg": "success",
    "result": {
        "updates": {
            "current": {
                "id": "1731570",
                "project_id": "7002",
                "dt_start": "2026-09-28 03:00:12",
                "dt_end": "2026-09-28 05:41:37",
                "positions": "2",
                "ctrws": "1",
                "vidimost": "1",
                "status": "2",
                "queries_count": "1500"
            },
            "previous": {
                "id": "1729911",
                "project_id": "7002",
                "dt_start": "2026-09-21 03:00:08",
                "dt_end": "2026-09-21 05:12:50",
                "positions": "2",
                "ctrws": "1",
                "vidimost": "1",
                "status": "2",
                "queries_count": "1500"
            }
        },
        "dictionary": {
            "0": "Все поисковые системы",
            "1": "Яндекс (Москва)",
            "324": "Яндекс (мобильный) (Москва)"
        },
        "search_systems_data": {
            "0": {
                "current": 36.8,
                "previous": 34.2,
                "diff": 2.6
            },
            "1": {
                "current": 41.5,
                "previous": 38,
                "diff": 3.5
            },
            "324": {
                "current": 32.1,
                "previous": 30.4,
                "diff": 1.7
            }
        },
        "limits": {
            "absolute": 5,
            "relative": 10
        },
        "warnings": {
            "status": false
        }
    }
}

Реализация потенциала трафика

GET /projects/api/v1/summary/potential/get

Какую долю от максимально возможного трафика сайт собирает на последнем апдейте: прогнозный трафик по текущим позициям относительно трафика, если бы все запросы стояли на первом месте. Сводно по всем поисковым системам проекта.

Параметры query

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

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

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

Ответ

Пустой result, если у проекта ещё нет успешных апдейтов.

result.date date

Дата последнего апдейта.
result.potential float

Реализация потенциала, % от 0 до 100.

GET /projects/api/v1/summary/potential/get

curl -G 'https://tools.pixelplus.ru/projects/api/v1/summary/potential/get' \
  --data-urlencode 'token=ВАШ_КЛЮЧ' \
  --data-urlencode 'project_id=7002'

<?php
$url = 'https://tools.pixelplus.ru/projects/api/v1/summary/potential/get?' . http_build_query([
    'token' => 'ВАШ_КЛЮЧ',
    'project_id' => 7002,
]);

$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/summary/potential/get",
    params={
        "token": "ВАШ_КЛЮЧ",
        "project_id": 7002,
    },
    timeout=60,
)
print(response.json())

project_id обязательный ID проекта. Виден в адресе страницы проекта и в ответе projects/get

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

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

{
    "status": "ok",
    "code": 1,
    "msg": "success",
    "result": {
        "date": "2026-09-28",
        "potential": 18
    }
}

Интегральные оценки

GET /projects/api/v1/integrals/get

Последние значения трёх оценок проекта: внутренняя оптимизация (intopt), ссылочная масса (extopt) и поведенческие факторы (pf). С date — последние значения на эту дату. Те же оценки вместе со сводной отдаёт project/get с details=1.

Параметры query

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

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

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

Взять значения, рассчитанные не позже этой даты, ГГГГ-ММ-ДД. На pf не действует — для него всегда последнее значение.

Ответ

Объект без обёртки status/result. Если оценка ни разу не считалась — value равно N/A, а date — 1970-01-01.

intopt, extopt, pf object

value — значение оценки, date — когда рассчитана.

GET /projects/api/v1/integrals/get

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

<?php
$url = 'https://tools.pixelplus.ru/projects/api/v1/integrals/get?' . http_build_query([
    'token' => 'ВАШ_КЛЮЧ',
    'project_id' => 7002,
    'date' => '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/integrals/get",
    params={
        "token": "ВАШ_КЛЮЧ",
        "project_id": 7002,
        "date": "2026-09-30",
    },
    timeout=60,
)
print(response.json())

project_id обязательный ID проекта. Виден в адресе страницы проекта и в ответе projects/get date Взять значения, рассчитанные не позже этой даты, ГГГГ-ММ-ДД

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

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

{
    "intopt": {
        "date": "2026-09-28 06:10:44",
        "value": "72"
    },
    "extopt": {
        "date": "2026-09-21 07:02:18",
        "value": "41"
    },
    "pf": {
        "date": "1970-01-01",
        "value": "N/A"
    }
}

Ошибки

Код	Сообщение	Когда
`50`	`access error`	Токен не передан, не найден, или у его владельца нет доступа к проекту.
`52`	`wrong request data`	`visibility/get`: `to` не дата или позже сегодняшнего дня, `mode` не из списка — причина в `result.error_message`; эта проверка идёт раньше проверки токена. `visibility/change`: у проекта нет ни одного успешного апдейта.

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

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

Видимость — доля возможных переходов из поиска, которую сайт собирает своими позициями по запросам проекта, с учётом частоты запросов и весов поисковых систем. Подробнее о показателях — на «Сводке» проекта.

Если для visibility/change передан апдейт, которого нет, ответ успешный, но без сравнения: updates и search_systems_data пустые, limits и warnings нет.

Параметры читаются из query-строки; update_id и date_update принимаются и из тела POST-формы. HTTP-код при штатной ошибке — 200: успех и ошибка различаются полями status и code.

summary Сводка: видимость, потенциал и интегральные оценки проекта

Динамика видимости

Параметры query

Ответ

Изменение видимости между апдейтами

Параметры query

Ответ

Реализация потенциала трафика

Параметры query

Ответ

Интегральные оценки

Параметры query

Ответ

Ошибки

`summary` Сводка: видимость, потенциал и интегральные оценки проекта