Инструменты · key

`vozrast` Индексация, возраст и дата сохранённой копии URL

Для каждого URL проверяет, есть ли он в индексе Яндекса, с какой даты и сколько дней, при желании — дату сохранённой копии в Яндексе и наличие в индексе Google. Метод асинхронный: POST ставит задачу и возвращает report_id, по нему забирается результат. То же в интерфейсе — Определение возраста документа.

Режим: асинхронный: report_id
Стоимость: 2 лимита за URL в Яндексе, +1 за дату копии, +2 за Google
Максимум: 300 URL за задачу, до 6 задач одновременно

Постановка задачи

POST /api/vozrast

Индексация в Яндексе и дата первой индексации проверяются всегда; дата копии и Google — по флагам. Дубли URL отбрасываются.

Параметры query и тело формы

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

Ключ API из настроек аккаунта. Всегда в query, в том числе у POST.
requests array обязательный

URL для проверки с протоколом http:// или https://, от 1 до 300. Массив или строка, по одному URL на строке. URL без протокола попадут в incorrect_urls.
age_saved_doc int

Определить дату сохранённой копии документа в Яндексе.

0
нет

1
да, +1 лимит за URL

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

Проверить индексацию URL в Google.

0
нет

1
да, +2 лимита за URL

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

Ответ

report_id int

ID задачи для получения результата.

POST /api/vozrast

curl -X POST 'https://tools.pixelplus.ru/api/vozrast?key=ВАШ_КЛЮЧ' \
  --data-urlencode 'requests[]=https://pixelplus.ru/' \
  --data-urlencode 'requests[]=https://pixelplus.ru/uslugi/'

<?php
$url = 'https://tools.pixelplus.ru/api/vozrast?' . http_build_query([
    'key' => 'ВАШ_КЛЮЧ',
]);

$ch = curl_init($url);
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 60,
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_POSTFIELDS => http_build_query([
        'requests' => [
            'https://pixelplus.ru/',
            'https://pixelplus.ru/uslugi/',
        ],
    ]),
]);
$response = json_decode(curl_exec($ch), true);
curl_close($ch);

print_r($response);

import requests

response = requests.post(
    "https://tools.pixelplus.ru/api/vozrast",
    params={
        "key": "ВАШ_КЛЮЧ",
    },
    data=[
        ("requests[]", "https://pixelplus.ru/"),
        ("requests[]", "https://pixelplus.ru/uslugi/"),
    ],
    timeout=60,
)
print(response.json())

requests обязательный URL для проверки с протоколом http:// или https://, от 1 до 300 · по одному на строку

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

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

{
    "report_id": 18734521
}

Получение результата

GET /api/vozrast

Пока задача выполняется, приходит [{"type":"in_progress","code":50,…}] — повторите запрос через 10–30 секунд.

Параметры query

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

Ключ API из настроек аккаунта. Всегда в query, в том числе у POST.
report_id int обязательный

ID задачи из ответа на постановку.

Ответ

correct_urls object

URL → результат проверки.
Вложенные поля
- date string
  
  Дата первой индексации ГГГГ-ММ-ДД, либо Не в индексе, либо База быстроробота — страница в выдаче, но без даты.
- days string
  
  Возраст страницы в днях от даты первой индексации; пусто, если даты нет.
- yandex int
  
  1 — в индексе Яндекса, 0 — нет, -2 — не удалось проверить.
- google int
  
  1 — в индексе Google, 0 — нет, -1 — не проверялось, -2 — не удалось проверить.
- age_saved_doc string
  
  Дата сохранённой копии ГГГГ-ММ-ДД чч:мм:сс; -1 — не определялась или не найдена.
- saved_copy_url string
  
  Ссылка на сохранённую копию в Яндексе, если age_saved_doc=1 и копия есть.
incorrect_urls null

Сейчас всегда null: невалидные URL в ответ не попадают — сверяйте correct_urls со своим списком.

GET /api/vozrast

curl -G 'https://tools.pixelplus.ru/api/vozrast' \
  --data-urlencode 'key=ВАШ_КЛЮЧ' \
  --data-urlencode 'report_id=18734521'

<?php
$url = 'https://tools.pixelplus.ru/api/vozrast?' . http_build_query([
    'key' => 'ВАШ_КЛЮЧ',
    'report_id' => 18734521,
]);

$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/api/vozrast",
    params={
        "key": "ВАШ_КЛЮЧ",
        "report_id": 18734521,
    },
    timeout=60,
)
print(response.json())

report_id обязательный ID задачи из ответа на постановку

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

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

{
    "correct_urls": {
        "https://pixelplus.ru/": {
            "date": "2014-03-12",
            "days": "4591",
            "age_saved_doc": "-1",
            "saved_copy_url": "",
            "yandex": 1,
            "google": 1
        },
        "https://pixelplus.ru/uslugi/": {
            "date": "Не в индексе",
            "days": "",
            "age_saved_doc": "-1",
            "saved_copy_url": "",
            "yandex": 0,
            "google": 1
        }
    },
    "incorrect_urls": null
}

Ошибки

Код	Сообщение	Когда
`50`	`In progress`	Задача ещё выполняется. Если известен ход, добавляются `progress` (проценты) и `time`.
`-50`	`Not set`	Пустой `requests`: `{"requests":"Not set","code":-50}`.
`-51`	`No requests data.`	Задачу пытались поставить GET-запросом без `report_id`.
`-67`	`To much requests`	Больше 300 URL.
`-60`	`To many tasks from one user. Try again later.`	Уже идут 6 задач этого метода — дождитесь их завершения.
`-4`	`Access denied`	`report_id` чужой или от другого инструмента.
`-104…-107, -125`	`Processing error и др.`	Задача завершилась без результата: ошибка обработки (`-104`), кончились лимиты (`-105`), отменена (`-106`), шла дольше 6 часов (`-107`), прочее (`-125`).
`-1, -2`	`Access denied`	Ключ не передан (HTTP `404`) или не найден (HTTP `403`).
`-68, -80…-83`	`Not enough … limits`	Не хватает дневных, часовых, недельных, месячных или годовых лимитов.

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

[
    {
        "type": "in_progress",
        "code": 50,
        "message": "In progress",
        "progress": 40,
        "time": "2026-10-06 12:00:00"
    }
]

Формат ошибок

Ошибки результата (50, -4, -104…) и -51 приходят списком объектов {type, code, message}. Ошибки проверки POST (-50, -60, -67) — объектом с ключами error или requests и code. Признак готового результата — наличие ключа correct_urls.

Если Яндекс или Google не ответили ни по одному URL, у всех URL будет -2 в соответствующем поле, а лимиты за эту проверку возвращаются.

vozrast Индексация, возраст и дата сохранённой копии URL

Постановка задачи

Параметры query и тело формы

Ответ

Получение результата

Параметры query

Ответ

Ошибки

Формат ошибок

`vozrast` Индексация, возраст и дата сохранённой копии URL