IZEK API · Вебмастер

API Вебмастера

Получайте показатели своих сайтов и ставьте подтверждённый сайт на переобход. Доступ ограничен владельцем аккаунта и выданными scope.

Bearer авторизация60 запросов в минутуJSON · UTF-8 формат ответа
1

Где взять токен и ID сайта

  1. Создайте приложение в личном кабинете.
  2. Запустите обычную OAuth-авторизацию, но добавьте webmaster.read или webmaster.write в параметр scope.
  3. Обменяйте code на access_token через /api/oauth/token.
  4. Выполните запрос списка сайтов. Значение поля id и есть SITE_ID. Тот же ID виден в адресе карточки сайта Вебмастера.
Запрашиваем чтение
scope=profile%20webmaster.read
Запрашиваем чтение и переобход
scope=profile%20webmaster.write
webmaster.write уже включает чтение.Не запрашивайте оба scope одновременно и не просите право записи, если интеграция только показывает статистику.
2

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

GEThttps://izek.ru/api/webmaster/sites
cURL
curl 'https://izek.ru/api/webmaster/sites' \
  -H 'Authorization: Bearer ACCESS_TOKEN'
Ответ
{
  "sites": [{
    "id": 17,
    "host": "example.ru",
    "start_url": "https://example.ru/",
    "verification_status": "verified",
    "verified_at": "2026-08-09 12:40:00",
    "known_pages": 1240,
    "indexed_pages": 1188,
    "index_percent": 96,
    "noindex_pages": 21,
    "http_errors": 8,
    "queue": {"pending": 4, "processing": 1, "failed": 2},
    "last_crawl_at": "2026-08-09 14:22:03"
  }]
}
3

Данные одного сайта

GEThttps://izek.ru/api/webmaster/sites/SITE_ID

Подставьте id из массива sites. Ответ содержит объект в поле site с тем же набором параметров.

Ответ
{"site":{"id":17,"host":"example.ru","verification_status":"verified","known_pages":1240,"indexed_pages":1188,"index_percent":96,"queue":{"pending":4,"processing":1,"failed":2}}}
4

Запрос переобхода

POSThttps://izek.ru/api/webmaster/sites/SITE_ID/reindex

Нужен scope webmaster.write. Сайт должен принадлежать пользователю и иметь статус verified.

cURL
curl -X POST 'https://izek.ru/api/webmaster/sites/17/reindex' \
  -H 'Authorization: Bearer ACCESS_TOKEN'
202 Accepted
{"ok":true,"site_id":17,"status":"queued"}
{ }

Параметры сайта

idЧисловой ID сайта. Используется вместо SITE_ID.
hostНормализованное доменное имя.
start_urlСтартовый URL, добавленный владельцем.
verification_statuspending, verified или failed.
verified_atДата подтверждения прав или null.
known_pagesСколько URL сайта известно роботу.
indexed_pagesСколько страниц участвует в поиске.
index_percentДоля проиндексированных URL, целое число от 0 до 100.
noindex_pagesКоличество страниц, исключённых директивой noindex.
http_errorsКоличество URL с HTTP-ошибками.
queue.pendingОжидают обхода.
queue.processingОбрабатываются сейчас.
queue.failedПоследняя попытка завершилась ошибкой.
last_crawl_atДата последнего обхода или null.
!

Ошибки API

401 invalid_tokenТокен отсутствует, истёк или отозван.
403 insufficient_scopeВ ответе есть required_scope с нужным правом.
404 site_not_foundID не существует или сайт принадлежит другому пользователю.
409 reindex_unavailableСайт не подтверждён, действует лимит или переобход пока невозможен. Поле message содержит пояснение.
405 method_not_allowedДля адреса выбран неверный HTTP-метод.
429 rate_limitedПревышено 60 запросов за минуту.
500 server_errorВнутренняя ошибка при постановке в очередь.