SEO-проекты · token

`project` Проект: карточка, запуск проверки и прогноз лимитов

Группа project работает с одним SEO-проектом: отдаёт его карточку, ставит на внеплановую проверку позиций, ставит на паузу и снимает с неё, отдаёт трафик и считает прогноз расхода лимитов на 30 дней вперёд. Все методы синхронные — ответ приходит сразу.

Адрес: /projects/api/v1/project/<метод>
Доступ: свои проекты и проекты с выданным доступом
Лимиты: тратит только project/parse

Карточка проекта

GET /projects/api/v1/project/get

Домен, главное зеркало, зеркала-алиасы и статус проекта. С details=1 в ответ добавляются интегральные оценки: внутренняя оптимизация, поведенческие, ссылочная масса и сводная оценка.

Параметры query

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

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

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

Добавить интегральные оценки проекта.

0
только карточка

1
карточка и оценки

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

Ответ

domain string

Домен проекта.
main_mirror string

Главное зеркало с протоколом.
aliases string

Зеркала-алиасы; пустая строка, если их нет.
status string

Статус проекта: 1 — активен.
intopt, pf, extopt, summary number

Только при details=1: внутренняя оптимизация, поведенческие, ссылочная масса, сводная оценка.

GET /projects/api/v1/project/get

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

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

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

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

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

{
    "domain": "tools.pixelplus.ru",
    "main_mirror": "https://tools.pixelplus.ru/",
    "aliases": "",
    "status": "1"
}

Внеплановая проверка позиций

GET /projects/api/v1/project/parse

Ставит запросы проекта в очередь на съём позиций, не дожидаясь расписания. Если по проекту уже идёт незакрытый апдейт, новая проверка не запускается — в ответе придёт дата начала текущего.

Проверка расходует лимиты по тарифу — столько же, сколько плановый съём по расписанию. Сколько уйдёт за месяц, показывает project/limits-forecast.

Параметры query

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

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

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

Ответ

message string

Что произошло: проверка запущена (в скобках — число запросов) или уже идёт.

GET /projects/api/v1/project/parse

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

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

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

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

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

{
    "message": "Queries of project 7002 goes to recheck (1500)"
}

Поставить проект на паузу

GET /projects/api/v1/project/stop

Останавливает плановые проверки проекта и запоминает его расписание, чтобы project/start вернул всё как было. Данные проекта не удаляются.

Параметры query

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

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

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

Ответ

В result — строка: Project successfully stopped или Project already stopped, если проект уже стоял на паузе.

GET /projects/api/v1/project/stop

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

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

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

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

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

{
    "status": "ok",
    "code": 1,
    "msg": "success",
    "result": [
        "Project successfully stopped"
    ]
}

Снять проект с паузы

GET /projects/api/v1/project/start

Возвращает расписание, которое было до паузы, и проверки снова идут по нему.

Параметры query

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

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

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

Ответ

В result — Project successfully started или Project already started.

GET /projects/api/v1/project/start

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

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

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

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

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

{
    "status": "ok",
    "code": 1,
    "msg": "success",
    "result": [
        "Project successfully started"
    ]
}

Трафик проекта

GET /projects/api/v1/project/traffic

Визиты по дням, неделям или месяцам: без ss_id — всего по Метрике, с ss_id — из одной поисковой системы. Нужна подключённая к проекту Яндекс Метрика.

Параметры query

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

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

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

Начало периода, ГГГГ-ММ-ДД. Без него — с первых данных.
to date

Конец периода включительно. Без него — по последний день.
ss_id int

Поисковая система из search-systems/get. Без него — весь трафик по Метрике.
grouping string

Шаг группировки.

d
по дням

w
по неделям (дата — первый день недели с данными)

m
по месяцам (дата — первое число)

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

Ответ

result[].date date

Дата точки.
result[].value int

Визиты за шаг.

GET /projects/api/v1/project/traffic

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

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

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

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

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

{
    "status": "ok",
    "code": 1,
    "msg": "success",
    "result": [
        {
            "date": "2026-09-01",
            "value": 1840
        },
        {
            "date": "2026-09-02",
            "value": 1912
        }
    ]
}

Прогноз расхода лимитов

GET /projects/api/v1/project/limits-forecast

Сколько лимитов спишется по проекту за 30 дней вперёд при текущих настройках. Это то же число, что калькулятор в настройках проекта и колонка «Лимитов за 30 дней» в списке проектов — расчёт один.

Параметры query

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

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

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

Ответ

result.project_id int

ID проекта из запроса.
result.days int

Горизонт прогноза в днях, всегда 30.
result.limits int

Прогноз расхода лимитов за 30 дней, округлён вверх.

GET /projects/api/v1/project/limits-forecast

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

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

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

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

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

{
    "status": "ok",
    "code": 1,
    "msg": "success",
    "result": {
        "project_id": 7002,
        "days": 30,
        "limits": 462330
    }
}

Ошибки

Код	Сообщение	Когда
`50`	`access error`	Токен не передан, не найден, или у его владельца нет доступа к проекту.
`51`	`wrong project id`	Проекта с таким `project_id` нет (`stop`, `start`, `limits-forecast`).
`52`	`wrong request data`	`traffic`: `grouping` не из `d`, `w`, `m`.
`101`	`no such project!`	`get`: проект не найден.

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

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

Что входит в прогноз лимитов

Слагаемое	Как считается
Проверка позиций	Число запросов × стоимость запроса по выбранным поисковым системам и глубине съёма × число проверок за 30 дней по расписанию.
Технические проверки	(Число запросов × 9 + 100 при сборе ссылочной массы через KeysSo) × периодичность техпроверок. Считается, только если включены рекомендации.
Отслеживание конкурентов	1 лимит на запрос в каждой поисковой системе за проверку, сколько бы доменов ни было в списке. При периодичности «каждый N-й апдейт» делится на N.
Проверка частот	Число запросов × 2 лимита (1 для точной частоты) × число проверок частот за 30 дней.
UpTime сайта	Фиксированные ~2 057 лимитов: проверка кода ответа раз в 21 минуту. Начисляется, если отмечена техпроверка «Общие показатели», заполнено главное зеркало и тариф владельца даёт доступ к UpTime.

Чего в прогнозе нет. Перепроверка скачков позиций: перепроверяются только просевшие фразы, их число заранее неизвестно. Ручные запуски проверок (в том числе через project/parse) и расход инструментов вне проекта тоже не учитываются — прогноз описывает плановый расход по расписанию.

Проект на паузе даёт "limits": 0. Прогноз считается на каждый вызов и не кэшируется: любое изменение настроек сразу отражается в ответе. Фактический расход за период отдаёт project/limits/history в REST API.

Формат ответа

Методы принимают GET и POST, но параметры читаются из query-строки. HTTP-код всегда 200: успех и ошибка различаются полями status и code в теле. project/get и project/parse при успехе отдают данные без обёртки status/result — так сложилось исторически, формат сохранён ради совместимости.

project Проект: карточка, запуск проверки и прогноз лимитов

Карточка проекта

Параметры query

Ответ

Внеплановая проверка позиций

Параметры query

Ответ

Поставить проект на паузу

Параметры query

Ответ

Снять проект с паузы

Параметры query

Ответ

Трафик проекта

Параметры query

Ответ

Прогноз расхода лимитов

Параметры query

Ответ

Ошибки

Что входит в прогноз лимитов

Формат ответа

`project` Проект: карточка, запуск проверки и прогноз лимитов