SEO-проекты · token

`audit` Аудит: результаты техпроверок и история robots.txt

Группа отдаёт результаты технического аудита проекта — то, что видно на вкладке «Аудит»: индексацию в Яндексе и Google, коды ответа страниц, скорость загрузки, зеркала, поддомены, ссылочный профиль и историю изменений robots.txt. Методы синхронные и ничего не запускают — отдают результаты последних плановых техпроверок.

Адрес: /projects/api/v1/audit/<метод>, /projects/api/v1/service-robotstxt/get
Режим: синхронный
Лимиты: вызов не тратит

Все результаты аудита

GET /projects/api/v1/audit/get

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

Формат ответа служебный: это внутренняя структура страницы аудита, без обёртки status/result, и она меняется вместе с интерфейсом. Для интеграций надёжнее audit/pages, audit/getsummary и audit/robots.

Параметры query

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

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

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

Ответ

Ключ верхнего уровня — слаг проверки. Блоки есть, только если проверка включена и хотя бы раз отработала.

tools_dates object

Дата последнего результата каждой проверки, ДД.ММ.ГГГГ, ключ — слаг.
fast-audit object

Быстрый аудит: индексация в Яндексе и Google и её изменение, SEO-теги, срок регистрации домена.
server-response object

Коды ответа проверенных страниц.
speedtest object

Скорость загрузки и размер документов.
indexed-domains, poisk-zerkal, struktura, seo-tags, analiz-saitov, affiliation object

Поддомены, зеркала, структура сайта, SEO-теги, SSL и прочие показатели, аффилированность.
links object

Ссылочный профиль: распределения анкоров и данные для графиков (строки JSON).
global-warning, server-response-warning bool

Есть ли проблемы в аудите в целом и в кодах ответа.

GET /projects/api/v1/audit/get

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

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

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

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

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

{
    "tools_dates": {
        "fast-audit": "28.09.2026",
        "server-response": "28.09.2026",
        "links": "21.09.2026"
    },
    "fast-audit": {
        "index_test": 1240,
        "index_test_site": 1310,
        "google_index": 980,
        "google_index_inurl": 1015,
        "index_test_delta": 12,
        "warning": false
    },
    "server-response": [
        {
            "url": "https://example.ru/",
            "code": 200
        }
    ],
    "global-warning": true
}

Индексация страниц в Яндексе и Google

GET /projects/api/v1/audit/pages

Число страниц сайта в индексе Яндекса и Google по последнему быстрому аудиту и изменение с прошлой проверки. Нужен результат быстрого аудита — он входит в технические проверки проекта.

Параметры query

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

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

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

Ответ

Объект без обёртки status/result. Вместо числа может прийти NotIndex — значение не удалось получить.

index_yandex int|string

Страниц в индексе Яндекса.
index_yandex_site int|string

Должно быть число страниц по оператору site:, но сейчас дублирует index_yandex.
delta_yandex, delta_yandex_site int|null

Изменение с прошлой проверки; null, если не изменилось.
index_google, index_google_inurl int|string

Страниц в индексе Google: по site: и по inurl:.
delta_google, delta_google_inurl int|null

Изменение с прошлой проверки; null, если не изменилось.
date string

Дата проверки, ДД.ММ.ГГГГ.

GET /projects/api/v1/audit/pages

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

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

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

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

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

{
    "index_yandex": 1240,
    "index_yandex_site": 1240,
    "delta_yandex": 12,
    "delta_yandex_site": null,
    "index_google": 980,
    "index_google_inurl": 1015,
    "delta_google": -4,
    "delta_google_inurl": null,
    "date": "28.09.2026"
}

Сводка предупреждений

GET /projects/api/v1/audit/getsummary

Есть ли проблемы по двум проверкам: поиск поддоменов (indexed-domains — предупреждение, если поддоменов не найдено) и коды ответа страниц (server-response — предупреждение, если хоть одна страница ответила не 200). Остальные проверки в сводку не входят.

Параметры query

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

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

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

Ответ

Массив без обёртки status/result; пустой, если обе проверки не включены или ещё не отработали.

[].ID string

Слаг проверки: indexed-domains или server-response.
[].title string

Всегда пустая строка.
[].warning bool

Есть ли проблема.
[].date string

Дата проверки, ДД.ММ.ГГГГ.

GET /projects/api/v1/audit/getsummary

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

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

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

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

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

[
    {
        "ID": "indexed-domains",
        "title": "",
        "warning": false,
        "date": "28.09.2026"
    },
    {
        "ID": "server-response",
        "title": "",
        "warning": true,
        "date": "28.09.2026"
    }
]

История robots.txt

GET /projects/api/v1/audit/robots

Все сохранённые версии robots.txt проекта, отличия каждой от предыдущей и URL, закрытые от индексации по последней проверке. Новая версия сохраняется, только когда файл изменился.

Параметры query

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

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

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

Ответ

result.robots_warning bool

Последняя версия отличается от предыдущей.
result.robots_txt[] object

Сохранённые версии robots.txt, от новой к старой.
Вложенные поля
- id string
  
  ID версии.
- project_id string
  
  ID проекта.
- robots string
  
  Текст файла целиком.
- dt string
  
  Когда версия сохранена, ГГГГ-ММ-ДД ЧЧ:ММ:СС.
result.robots_compare object

Отличия каждой версии от предыдущей, ключ — ID версии. Названия перевёрнуты: old — строки, которые в этой версии появились, new — строки, которые из неё удалены. У самой старой версии оба списка пустые.
result.robots_urls_list[] object

До 100 URL, закрытых в robots.txt, по последней проверке: url, правило rule, дата dt.

GET /projects/api/v1/audit/robots

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

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

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

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

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

{
    "status": "ok",
    "code": 1,
    "msg": "success",
    "result": {
        "robots_warning": true,
        "robots_txt": [
            {
                "id": "5121",
                "project_id": "7002",
                "robots": "User-agent: *\nDisallow: /admin/\nDisallow: /search/\nSitemap: https://example.ru/sitemap.xml",
                "dt": "2026-09-28 04:12:09"
            },
            {
                "id": "4870",
                "project_id": "7002",
                "robots": "User-agent: *\nDisallow: /admin/\nSitemap: https://example.ru/sitemap.xml",
                "dt": "2026-08-14 03:55:41"
            }
        ],
        "robots_compare": {
            "5121": {
                "old": [
                    "Disallow: /search/"
                ],
                "new": []
            },
            "4870": {
                "old": [],
                "new": []
            }
        },
        "robots_urls_list": [
            {
                "url": "https://example.ru/search/?q=1",
                "dt": "2026-09-28",
                "pid": "7002",
                "rule": "Disallow: /search/"
            }
        ]
    }
}

Последние изменения robots.txt (служебный)

GET /projects/api/v1/service-robotstxt/get

Облегчённый вариант audit/robots: только последние limit версий и их отличия, без списка закрытых URL, плюс имя и домен проекта.

Метод служебный, сделан для внешнего сервиса: формат ответа не такой, как у остальных методов группы, — без code и msg, а ошибка доступа приходит текстом в message.

Параметры query

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

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

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

Сколько последних версий отдать.

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

Ответ

id string

project_id из запроса как есть.
name, domain string

Название и домен проекта.
result.warnings bool

Последняя версия отличается от предыдущей.
result.tools_result.robots_txt[] object

Версии файла, как в audit/robots.
result.tools_result.robots_compare object

Отличия версий; old — добавленные строки, new — удалённые.
status string

success или error.

GET /projects/api/v1/service-robotstxt/get

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

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

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

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

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

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

{
    "id": "7002",
    "name": "Мой сайт",
    "domain": "example.ru",
    "result": {
        "warnings": true,
        "tools_result": {
            "robots_txt": [
                {
                    "id": "5121",
                    "project_id": "7002",
                    "robots": "User-agent: *\nDisallow: /admin/\nDisallow: /search/\nSitemap: https://example.ru/sitemap.xml",
                    "dt": "2026-09-28 04:12:09"
                },
                {
                    "id": "4870",
                    "project_id": "7002",
                    "robots": "User-agent: *\nDisallow: /admin/\nSitemap: https://example.ru/sitemap.xml",
                    "dt": "2026-08-14 03:55:41"
                }
            ],
            "robots_compare": {
                "5121": {
                    "old": [
                        "Disallow: /search/"
                    ],
                    "new": []
                },
                "4870": {
                    "old": [],
                    "new": []
                }
            }
        }
    },
    "status": "success"
}

Ошибки

Код	Сообщение	Когда
`50`	`access error`	Токен не передан, не найден, или у его владельца нет доступа к проекту.
`666`	`something is going wrong`	`audit/pages`: у проекта нет результата быстрого аудита — проверка не включена в настройках проекта или ещё не отработала.
`—`	`Access denied`	`service-robotstxt/get`: нет доступа к проекту. Приходит как `{"status": "error", "message": "Access denied", "name": null, "domain": null}`.

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

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

Откуда данные

Методы читают сохранённые результаты плановых техпроверок проекта: что проверять и как часто, задаётся в настройках проекта, в разделе технических проверок. Если проверка выключена, её блока в ответе нет. Сами вызовы ничего не перепроверяют и лимитов не тратят.

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

Обёртку status/code/msg/result использует только audit/robots. audit/get, audit/pages и audit/getsummary при успехе отдают данные без обёртки, service-robotstxt/get — в своём формате. Так сложилось исторически, формат сохранён ради совместимости. Параметры читаются из query-строки; service-robotstxt/get принимает их и из тела POST-формы.

audit Аудит: результаты техпроверок и история robots.txt

Все результаты аудита

Параметры query

Ответ

Индексация страниц в Яндексе и Google

Параметры query

Ответ

Сводка предупреждений

Параметры query

Ответ

История robots.txt

Параметры query

Ответ

Последние изменения robots.txt (служебный)

Параметры query

Ответ

Ошибки

Откуда данные

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

`audit` Аудит: результаты техпроверок и история robots.txt