SEO-проекты · token

`uptime` Uptime: история доступности сайта

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

Адрес: /projects/api/v1/uptime/get
Режим: синхронный
Лимиты: вызов не тратит; сбор аптайма — ~2 057 лимитов за 30 дней на проект
Глубина: до 90 дней

История доступности

GET /projects/api/v1/uptime/get

Массив интервалов за выбранный период: в каждом — процент успешных проверок и признак блокировки бота. Интервалы идут подряд без пропусков, включая те, где проверок не было.

Параметры query

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

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

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

Период выборки и шаг интервала.

day
последние 24 часа, шаг — час, date вида 2026-09-15 14:00

week
последние 7 дней, шаг — сутки

two_weeks
последние 14 дней, шаг — сутки

month
последние 30 дней, шаг — сутки

quarter
последние 90 дней, шаг — сутки

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

Ответ

result[].date string

Начало интервала: час (ГГГГ-ММ-ДД ЧЧ:00) для day, дата для остальных периодов.
result[].percent float|null

Доля проверок с кодом 200 за интервал, от 0 до 100. null — проверок не было.
result[].bot_blocked bool|null

Сайт ответил боту кодом 403 или 429 хотя бы на одной проверке за интервал. null — проверок не было.

GET /projects/api/v1/uptime/get

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

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

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

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

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

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

{
    "status": "ok",
    "code": 1,
    "msg": "success",
    "result": [
        {
            "date": "2026-09-15 10:00",
            "percent": 100,
            "bot_blocked": false
        },
        {
            "date": "2026-09-15 11:00",
            "percent": 0,
            "bot_blocked": true
        },
        {
            "date": "2026-09-15 12:00",
            "percent": null,
            "bot_blocked": null
        }
    ]
}

Ошибки

Код	Сообщение	Когда
`50`	`access error`	Токен не передан, не найден, или у его владельца нет доступа к проекту.
`51`	`wrong project id`	Проекта с таким `project_id` нет.
`52`	`wrong request data`	Недопустимое значение `period`. Список допустимых приходит в `result.message`.

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

{
    "status": "error",
    "code": 52,
    "msg": "wrong request data",
    "result": {
        "message": "Acceptable values of period: day, week, two_weeks, month, quarter"
    }
}

bot_blocked — блокировка бота

Сайт может отвечать браузеру и роботу по-разному: фильтр трафика или WAF пропускает посетителя и отдаёт ошибку боту. Тогда percent равен нулю, хотя сайт работает. bot_blocked отделяет этот случай от настоящего падения.

Значение	Что произошло	Что показывать
`true`	Сайт ответил боту кодом 403 или 429 хотя бы на одной проверке за интервал.	Не «сайт лежал», а «сайт блокирует бота» со ссылкой на инструкцию.
`false`	Блокировки не было: сайт отвечал нормально или был недоступен по другой причине.	Обычный процент доступности.
`null`	За интервал не было ни одной проверки; `percent` тоже `null`.	Прочерк, а не ноль.

Таймаут, 500, 502, 503 и прочие ошибки сервера блокировкой не считаются и дают false: сайт не работает, а не фильтрует робота. Признак ставится только по кодам 403 и 429.

Если bot_blocked равен true, владельцу сайта нужно добавить IP-адреса и User-Agent Пиксель Тулс в исключения фильтра. До этого аптайм по проекту будет нулевым, хотя посетителям сайт доступен.

Ограничения

Проверки идут только по проектам, где включена техпроверка «Общие показатели» и заполнено главное зеркало. Если проверок нет вообще, метод вернёт интервалы с percent: null.
Проект проверяется примерно раз в 21 минуту — около трёх раз в час. Поэтому для period=day процент в часе принимает значения вида 0, 33.33, 66.67 и 100.
История хранится 90 дней, старые записи удаляются — отсюда максимальная глубина quarter.
Поля date и percent не менялись при добавлении bot_blocked — старые интеграции работают без правок.

Метод принимает GET и POST, но параметры читаются из query-строки. HTTP-код всегда 200: успех и ошибка различаются полями status и code.