SEO-проекты · token

`updates` Апдейты проекта

Метод updates/get отдаёт завершённые проверки позиций проекта (апдейты) с датой окончания, от новых к старым. id апдейта нужен, чтобы получить позиции за конкретную дату в positions/get. Метод синхронный, лимиты не тратит.

Адрес: /projects/api/v1/updates/get
Доступ: свои проекты и проекты с выданным доступом
Лимиты: не тратит

Список апдейтов

GET /projects/api/v1/updates/get

Только завершённые апдейты: идущая сейчас проверка в список не попадает. Отдаётся массивом без обёртки status/result.

Параметры query

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

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

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

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

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

Сколько апдейтов отдать. 0 или без параметра — все.

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

Ответ

[].id string

ID апдейта — update_id для positions/get.
[].date string

Дата и время окончания проверки, ГГГГ-ММ-ДД ЧЧ:ММ:СС.

GET /projects/api/v1/updates/get

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

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

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

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

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

[
    {
        "id": "21762",
        "date": "2026-09-25 14:22:32"
    },
    {
        "id": "21530",
        "date": "2026-09-23 11:15:34"
    },
    {
        "id": "21083",
        "date": "2026-09-19 11:27:40"
    }
]

Ошибки

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

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

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