• Быстрый старт
    • Демо
  • УСТРОЙСТВО
    • Страницы
      • Markdown
      • Аналитика страниц
    • Фреймы
      • Поля данных
      • Сборка
    • Данные
    • Приложения
      • Данные приложения
    • Медиа
  • УПРАВЛЕНИЕ
    • Создание сайтов
    • Настройки
    • Меню
    • Приватные страницы
    • Языки
    • Свой домен
    • Пользователи
    • Стили и оформление
    • Соцсети и контакты
    • Ошибки и проблемы
  • ИНСТРУМЕНТЫ
    • SEO
    • Индексация
    • Кросспостинг
    • Аналитика
    • Кэш
    • Почта на домене
    • Редиректы
  • КЕЙСЫ
    • Загрузить HTML
    • Миграция
    • Перевод страницы
    • Чат с OpenAI
    • Справочник API
    • Общие правила
  • УСТРОЙСТВО
    • Страницы
    • Фреймы
      • Поля данных
      • Повторитель
      • Вставка фрейма и служебные блоки
      • Готовые фреймы
      • Сборка
    • Данные
    • Медиа
  • УПРАВЛЕНИЕ
    • Создание сайтов
    • Настройки
    • Меню
    • Языки
    • Свой домен
    • Пользователи
    • Кредиты
    • Автоматизация
    • Авторизация
      • Состояние API
      • Сессия посетителя
    • Стили и оформление
    • Соцсети и контакты
    • Ошибки и проблемы
  • ИНСТРУМЕНТЫ
    • SEO
      • Семантика
    • Индексация
    • Кросспостинг
    • Аналитика
    • Кэш
    • Почта на домене
    • Редиректы
OnPress OnPress
Документация Справочник API Контакты
Войти Начать
Документация Справочник API Контакты Войти
    • Быстрый старт
    • Демо
  • УСТРОЙСТВО
    • Страницы
      • Markdown
      • Аналитика страниц
    • Фреймы
      • Поля данных
      • Сборка
    • Данные
    • Приложения
      • Данные приложения
    • Медиа
  • УПРАВЛЕНИЕ
    • Создание сайтов
    • Настройки
    • Меню
    • Приватные страницы
    • Языки
    • Свой домен
    • Пользователи
    • Стили и оформление
    • Соцсети и контакты
    • Ошибки и проблемы
  • ИНСТРУМЕНТЫ
    • SEO
    • Индексация
    • Кросспостинг
    • Аналитика
    • Кэш
    • Почта на домене
    • Редиректы
  • КЕЙСЫ
    • Загрузить HTML
    • Миграция
    • Перевод страницы
    • Чат с OpenAI
    • Справочник API
    • Общие правила
  • УСТРОЙСТВО
    • Страницы
    • Фреймы
      • Поля данных
      • Повторитель
      • Вставка фрейма и служебные блоки
      • Готовые фреймы
      • Сборка
    • Данные
    • Медиа
  • УПРАВЛЕНИЕ
    • Создание сайтов
    • Настройки
    • Меню
    • Языки
    • Свой домен
    • Пользователи
    • Кредиты
    • Автоматизация
    • Авторизация
      • Состояние API
      • Сессия посетителя
    • Стили и оформление
    • Соцсети и контакты
    • Ошибки и проблемы
  • ИНСТРУМЕНТЫ
    • SEO
      • Семантика
    • Индексация
    • Кросспостинг
    • Аналитика
    • Кэш
    • Почта на домене
    • Редиректы
Справочник API Инструменты
Markdown
Открыть в ИИ
  • Открыть в ChatGPT
  • Открыть в Claude
  • Открыть в Gemini
  • Открыть в Perplexity
  • Открыть в Grok
  • Открыть в DeepSeek

SEO

API проверяет SEO сайта и управляет файлами для поисковых систем. Сценарии — в гайде. Отправка страниц на индексацию — на странице «Индексация».

info

API — https://onpress.pro/api/v2, SITE — id сайта, OP_TOKEN — токен op_XXXX. Пути на этой странице начинаются с $API/site/$SITE. Токен и права — в «Авторизации», общий формат — в «Общих правилах».

Эндпоинты

Профильные операции /data/… возвращают результат в items[0]; наружные name, origin: "system" и total: 1 описывают системные данные. Названия полей результата ниже относятся к items[0]. Неподдерживаемый метод дает 405 wrong_method_for_source, пробный прогон без поддержки — 400 dry_run_not_supported. Прежние URL продолжают работать со своим форматом ответа.

МетодПутьДействие
PUT/data/seo.auditПроверить SEO сайта
GET/data/seo.auditПрочитать итог проверки
GET/data/seo.pagesПроверить страницы
PUT/data/seo.linksЗапустить проверку ссылок
GET/data/seo.linksПрочитать проверку ссылок
GET/data/seo.link_graphПолучить граф ссылок
GET/data/seo.index_statusПроверить индексацию страницы
PUT/data/seo.index_statusПроверить индексацию нескольких страниц
GET/data/seoПрочитать SEO-настройки
PATCH/data/seoИзменить SEO-настройки
GET/data/seo.appПрочитать карточку приложения
PATCH/data/seo.appИзменить карточку приложения
GET/data/seo.sitemapПрочитать состояние карты
PUT/data/seo.sitemapОтправить карту сайта
GET/data/seo.sitemap.urlsПрочитать адреса карты
GET/data/seo.robotsПрочитать robots.txt
PUT/data/seo.robotsЗаписать robots.txt
DELETE/data/seo.robotsВернуть шаблон robots.txt
GET/data/seo.llmsПрочитать llms.txt
PUT/data/seo.llmsЗаписать llms.txt
DELETE/data/seo.llmsУдалить llms.txt
GET/data/seo.llms.buildПоказать результат сборки llms.txt
PUT/data/seo.llms.buildСобрать llms.txt
GET/data/seo.indexnowПрочитать состояние IndexNow
PUT/data/seo.indexnowОтправить адреса в IndexNow
GET/data/seo.serpПрочитать настройки проверки позиций
PUT/data/seo.serpИзменить настройки проверки позиций
PUT/data/seo.serp.keyПодключить ключ SerpApi
DELETE/data/seo.serp.keyОтключить ключ SerpApi
GET/data/seo.serp.queriesПрочитать поисковые запросы
PUT/data/seo.serp.queriesДобавить поисковый запрос
DELETE/data/seo.serp.queriesУдалить поисковый запрос
PUT/data/seo.serp.syncВзять запросы из ключей страниц
GET/data/seo.serp.positions?id={id}Прочитать историю позиций
PUT/data/seo.serp.checkПроверить позицию запроса

Проверить SEO сайта

PUT /data/seo.audit

Проверяет весь чеклист раздела SEO на сервере и сохраняет итог: SEO-настройки и настройки сайта, тему, языки и главные, набор author, счетчики и консоли, файлы robots.txt и llms.txt, визиты ботов и обход страниц. Подробнее в гайде.

curl -s -X PUT "$API/site/$SITE/data/seo.audit" -H "Authorization: Bearer $OP_TOKEN"

Дополнительных полей строки запроса нет.

Ответ

Длится столько же, сколько обход страниц: от секунд до минуты; второй POST, пока идет первый, получает его результат. Источник, который не ответил, переводит свои пункты в unknown и называется в errors, остальные пункты считаются.

{
  "success": true,
  "name": "seo.audit",
  "origin": "system",
  "total": 1,
  "items": [
    {
      "site_id": "x9HTLHECq",
      "checked": true,
      "format": 1,
      "checked_at": "2026-09-29T09:25:16.998Z",
      "took_ms": 1202,
      "site_url": "https://example.com",
      "totals": {
        "counted": 38,
        "ok": 19,
        "todo": 16,
        "warn": 3,
        "na": 1,
        "unknown": 0
      },
      "sitemap": {
        "url": "https://example.com/sitemap_index.xml",
        "consoles": {
          "gsc": {
            "state": "not_connected"
          },
          "ywm": {
            "state": "not_connected"
          }
        },
        "error": null
      },
      "files": {
        "robots": {
          "state": "ok",
          "http": 200,
          "url": "https://example.com/robots.txt"
        },
        "llms": {
          "state": "none",
          "http": 404,
          "url": "https://example.com/llms.txt"
        }
      },
      "bots": {
        "…": "…"
      },
      "errors": [],
      "checks": [
        {
          "id": "identity",
          "group": "Basics",
          "status": "ok",
          "title": {
            "key": "seo.checks.identity.title"
          },
          "why": {
            "key": "seo.checks.identity.why"
          },
          "summary": "Example",
          "fields": [
            {
              "label": {
                "key": "seo.checks.identity.fields.title"
              },
              "value": "Example"
            }
          ],
          "fix": {
            "title": "…",
            "command": "curl -X PATCH …"
          }
        }
      ]
    }
  ]
}
Поле ответаОписание
checked_at, took_msкогда прошла проверка и сколько длилась
totalscounted, ok, todo, warn, na, unknown; na и unknown в counted не входят
sitemapадрес карты сайта и что о ней знают Search Console и Вебмастер — в форме GET /data/seo.sitemap
filesживые robots.txt и llms.txt: robots.state — ok, warn (закрывает весь сайт Disallow: /, так бывает у закрытого сайта) или fail (не отдается, http); llms.state — ok, none (404, файл не собран) или fail
botsкогда поисковые и ИИ-боты последний раз заходили за robots.txt и картой сайта
errorsисточники, которые не ответили
checksпункты чеклиста, см. пункты проверки

Пункт: id, group (Basics, Indexing, Languages, Markup, Speed, Pages — в консоли «Контент»), status — ok, todo (сделать), warn (требует внимания), na (неприменимо), unknown (источник не ответил); summary, fields, note, rows — строки таблицы пункта, pages — страницы с нарушением; fix — готовая команда curl с этим сайтом; builtin: true — то, что платформа делает сама. Тексты — не фразы, а ключи словаря консоли: {"key", "params"}, {"list": […]}, {"join": […], "sep"}, {"age": iso}; простая строка — значение как есть.

Своих отказов у эндпоинта нет: сломанный источник не останавливает проверку, а попадает в errors.

Ошибки

Общие коды — на странице «Ошибки».

Прочитать итог проверки

GET /data/seo.audit

Отдает сохраненный итог без новой проверки — раздел SEO консоли при открытии делает ровно этот вызов. Подробнее в гайде.

curl -s "$API/site/$SITE/data/seo.audit" -H "Authorization: Bearer $OP_TOKEN"

Параметр адресации передается в строке запроса; тела нет.

Ответ

Ответ — в форме PUT /data/seo.audit и еще два поля, прочитанные вживую: running: true, пока идет проверка, и access — состояние «сайт открыт / закрыт» (closed, supported, reason, url, retry_after; null, если прочитать не удалось). До первой проверки — checked: false, checked_at: null, checks: [].

Ошибки

Общие коды — на странице «Ошибки».

Проверить страницы

GET /data/seo.pages

Обходит опубликованные страницы по HTTP и читает ту разметку, которую сервер отдает на самом деле: до 2000 страниц, 8 одновременно, 15 с на страницу. Подробнее в гайде.

curl -s "$API/site/$SITE/data/seo.pages?lang=ru" -H "Authorization: Bearer $OP_TOKEN"

Параметры запроса

ПолеТипОбязательноеПо умолчаниюОписание
langstringнетallязык страниц

Ответ

Пункты pages-*, headings, images-alt и keywords проверки считаются по этому же обходу.

{
  "success": true,
  "name": "seo.pages",
  "origin": "system",
  "total": 1,
  "items": [
    {
      "site_id": "x9HTLHECq",
      "lang": "ru",
      "checked_at": "2026-10-28T06:37:00.882Z",
      "took_ms": 2808,
      "totals": {
        "pages": 35,
        "crawled": 35,
        "checked": 30,
        "skipped_noindex": 5,
        "unreachable": 0
      },
      "meta": {
        "count": 0,
        "pages": []
      },
      "lengths": {
        "count": 22,
        "title_max": 65,
        "description_max": 165,
        "pages": [
          {
            "id": 6231,
            "url": "/ru/docs/",
            "long": [
              "title"
            ],
            "title_text": "…"
          }
        ]
      },
      "headings": {
        "count": 3,
        "pages": [
          {
            "id": 6234,
            "url": "/ru/docs/install/",
            "problems": [
              {
                "kind": "many_h1",
                "count": 2,
                "text": "Установка"
              }
            ],
            "outline": [
              "…"
            ]
          }
        ]
      },
      "noindex": {
        "count": 5,
        "pages": [
          {
            "id": 6240,
            "url": "/ru/errors/",
            "status": 404
          }
        ]
      },
      "unreachable": [],
      "signals": {
        "pages": 30,
        "canonical": {
          "…": "…"
        },
        "schema": {
          "…": "…"
        },
        "images": {
          "…": "…"
        },
        "preload": {
          "…": "…"
        },
        "hreflang": {
          "…": "…"
        },
        "og": {
          "…": "…"
        },
        "redirects": {
          "…": "…"
        },
        "not_found": {
          "…": "…"
        }
      },
      "summary": {
        "…": "…"
      },
      "pages": [
        "…"
      ]
    }
  ]
}

meta.pages[] — страницы с пустым <title> или meta description (missing, title_text, description_text). lengths.pages[] — title длиннее title_max или описание длиннее description_max (long, тексты и длины). headings.pages[] — нарушения заголовков. noindex.pages[] — страницы, которые отдаются с noindex, с кодом ответа; на заголовки они не проверяются. unreachable — открытые страницы, ответившие не 2xx (reason: http_error, timeout, unreachable, not_html). signals — то, что платформа делает сама: canonical (with, self, other, missing), redirects, not_found, schema, images (img, webp, without_webp), preload, hreflang (missing_return), home.x_default, og; списки режутся до 50 адресов. Больше 2000 страниц — в totals появляется truncated_at.

Ошибки

КодHTTPКогдаЧто делать
unknown_language422такого языка на сайте нет; языки — в languagesвозьмите слаг из ответа
no_public_pages409ни у одной опубликованной страницы нет адресаопубликуйте страницы

Запустить проверку ссылок

PUT /data/seo.links

Ставит фоновую проверку ссылок и сразу возвращает HTTP 202. Подробнее в гайде.

curl -s -X PUT "$API/site/$SITE/data/seo.links" -H "Authorization: Bearer $OP_TOKEN"

Дополнительных полей строки запроса нет.

Ответ

{
  "success": true,
  "name": "seo.links",
  "origin": "system",
  "total": 1,
  "items": [
    {
      "status": "running",
      "started_at": "2026-10-30T12:00:00Z"
    }
  ]
}

Ошибки

КодHTTPКогдаЧто делать
check_running409на сайте уже идет проверкадождитесь итога в GET /data/seo.links
checks_busy429сервер проверяет ссылки других сайтовповторите через несколько минут

Прочитать проверку ссылок

GET /data/seo.links

Отдает состояние или итог фоновой проверки ссылок. Подробнее в гайде.

curl -s "$API/site/$SITE/data/seo.links" -H "Authorization: Bearer $OP_TOKEN"

Параметр адресации передается в строке запроса; тела нет.

Ответ

Ответ GET: status — none (проверки не было), running, done, failed, interrupted; started_at, finished_at; в итоге — dead, wrong_lang, unconfirmed и totals. Причина мертвой ссылки — http_404, http_410, http_5xx, dns, soft_404; неподтвержденной — timeout, tls, redirect_loop или код ответа, который закрывает страницу от роботов.

Ошибки

КодHTTPКогдаЧто делать
check_running409на сайте уже идет проверкадождитесь итога в GET /data/seo.links
checks_busy429сервер проверяет ссылки других сайтовповторите через несколько минут

Получить граф ссылок

GET /data/seo.link_graph

Строит граф внутренних ссылок по телам опубликованных страниц: входящие и исходящие ссылки, сироты и вес страницы. Подробнее в гайде.

curl -s "$API/site/$SITE/data/seo.link_graph?lang=ru" -H "Authorization: Bearer $OP_TOKEN"

Параметры запроса

ПолеТипОбязательноеПо умолчаниюОписание
langstringнетallязык страниц
fresh1нет—пересчитать мимо кэша

Ответ

Граф кэшируется и пересчитывается сам, когда меняются страницы.

{
  "success": true,
  "name": "seo.link_graph",
  "origin": "system",
  "total": 1,
  "items": [
    {
      "site_id": "x9HTLHECq",
      "lang": "ru",
      "scope": "body",
      "cached": false,
      "built_at": "2026-10-28T06:37:00.882Z",
      "weight": {
        "method": "…",
        "iterations": 20,
        "damping": 0.85,
        "scale": "…"
      },
      "summary": {
        "pages": 120,
        "orphans": 4,
        "avg_inbound": 3.2,
        "site_pages": 120,
        "site_edges": 410,
        "site_unresolved_links": 2
      },
      "pages": [
        {
          "id": 6231,
          "url": "/ru/docs/",
          "lang": "ru",
          "inbound": 12,
          "inbound_links": 15,
          "outbound": 8,
          "outbound_links": 9,
          "orphan": false,
          "front": false,
          "weight": 4.1
        }
      ]
    }
  ]
}

Ошибки

КодHTTPКогдаЧто делать
unknown_language422такого языка на сайте нетвозьмите слаг из languages
polylang_inactive409lang передан сайту с одним языкомуберите lang
too_many_pages413опубликовано больше 5000 страниц—

Проверить индексацию страницы

GET /data/seo.index_status

Отдает вердикт Search Console URL Inspection по одной странице. Подробнее в гайде.

curl -s "$API/site/$SITE/data/seo.index_status?ref=5776" -H "Authorization: Bearer $OP_TOKEN"

Параметры запроса

ПолеТипОбязательноеПо умолчаниюОписание
refstringда—Id, слаг или путь страницы, обязательно
refreshboolнетfalseспросить Google заново; не чаще раза в час на страницу
langstringнет—язык, если слаг есть в нескольких языках

Ответ

Результат держится сутки.

Ответ: property — ресурс Search Console, quota — остаток квоты, page (у POST — pages и summary: total, live, cached, deferred, failed). У страницы — verdict, coverage_state, indexing_state, robots_txt_state, page_fetch_state, last_crawl_time, google_canonical, checked_at, source (live, cache, none). Квота — 1900 проверок в сутки на ресурс; что не влезло в квоту, в POST приходит с deferred, а не отказом всего пакета.

Ошибки

КодHTTPКогдаЧто делать
ref_required, refs_required400нет ref или пустой refsпередайте страницу
too_many_refs400больше 100 страницразбейте на части
invalid_ref400элемент refs не число и не строкаисправьте список
unknown_field400в теле POST поле кроме refs, refresh, langуберите поле
page_not_found404страницы нетпроверьте ref
not_published409страница не опубликованаопубликуйте ее
gsc_not_connected409Search Console не подключенаPUT /data/settings/gsc
gsc_quota_exhausted429квота на сутки кончилась; Retry-Afterповторите после срока
gsc_busy503Google не ответил в срокповторите запрос

Проверить индексацию нескольких страниц

PUT /data/seo.index_status

Отдает вердикты Search Console URL Inspection для списка до 100 страниц. Подробнее в гайде.

curl -s -X PUT "$API/site/$SITE/data/seo.index_status" -H "Authorization: Bearer $OP_TOKEN" -H 'Content-Type: application/json' -d '{"refs": [5776]}'

Тело запроса

ПолеТипОбязательноеПо умолчаниюОписание
refsarrayда—До 100 id, слагов или путей, обязательно
refreshboolнетfalseспросить Google заново; не чаще раза в час на страницу
langstringнет—язык, если слаг есть в нескольких языках

Ответ

Результат держится сутки.

Ответ: property — ресурс Search Console, quota — остаток квоты, page (у POST — pages и summary: total, live, cached, deferred, failed). У страницы — verdict, coverage_state, indexing_state, robots_txt_state, page_fetch_state, last_crawl_time, google_canonical, checked_at, source (live, cache, none). Квота — 1900 проверок в сутки на ресурс; что не влезло в квоту, в POST приходит с deferred, а не отказом всего пакета.

Ошибки

КодHTTPКогдаЧто делать
ref_required, refs_required400нет ref или пустой refsпередайте страницу
too_many_refs400больше 100 страницразбейте на части
invalid_ref400элемент refs не число и не строкаисправьте список
unknown_field400в теле POST поле кроме refs, refresh, langуберите поле
page_not_found404страницы нетпроверьте ref
not_published409страница не опубликованаопубликуйте ее
gsc_not_connected409Search Console не подключенаPUT /data/settings/gsc
gsc_quota_exhausted429квота на сутки кончилась; Retry-Afterповторите после срока
gsc_busy503Google не ответил в срокповторите запрос

Прочитать SEO-настройки

GET /data/seo

Возвращает настройки SEO, общие для сайта. Подробнее в гайде.

curl -s "$API/site/$SITE/data/seo" -H "Authorization: Bearer $OP_TOKEN"

Параметр адресации передается в строке запроса; тела нет.

Ответ

{
  "success": true,
  "name": "seo",
  "origin": "system",
  "total": 1,
  "items": [
    {
      "site_id": "SITE_ID",
      "seo": {
        "separator": "sc-dash",
        "separator_char": "-",
        "sitemap": {
          "enabled": true,
          "entries_per_page": 1000
        }
      }
    }
  ]
}

Полный состав seo и допустимые значения — в описании записи. Постраничные SEO-поля описывает справочник «Страницы».

Ошибки

Общие коды — на странице «Ошибки».

Изменить SEO-настройки

PATCH /data/seo

API использует SEO-настройки сайта — разделитель и шаблоны заголовков, метаописания, флаги noindex, хлебные крошки, организацию для SEO-графа, Open Graph, карту сайта; Передайте только изменяемые разделы. Подробнее в гайде.

curl -s -X PATCH "$API/site/$SITE/data/seo" \
  -H "Authorization: Bearer $OP_TOKEN" -H 'Content-Type: application/json' \
  -d '{"sitemap": {"enabled": true}}'

Тело запроса

ПолеТипОбязательноеПо умолчаниюОписание
separatorstringнетбез измененияКлюч из чтения, например sc-dash.
titlesobjectнетбез измененияШаблоны home, page, post, 404, author, archive, search.
metadescobjectнетбез измененияШаблоны home, page, post, author, archive.
noindexobjectнетбез измененияarchive, author, author_noposts, карты post_types, taxonomies.
attachmentsobjectнетбез измененияredirect_to_parent.
breadcrumbsobjectнетбез измененияenabled, separator, home, prefix, bold_last.
organizationobjectнетбез измененияtype, name, alternate_name, logo, person_user_id, person_name, person_logo.
socialobjectнетбез измененияopen_graph, twitter, twitter_card, default_image, profiles.
sitemapobjectнетбез измененияenabled, entries_per_page, author.
index_nowobjectнетбез измененияenabled, key. Для отправки адресов используйте /data/seo.indexnow.

Ответ

Постраничные title, description и noindex здесь не живут: они в свойствах страницы.

{
  "success": true,
  "name": "seo",
  "origin": "system",
  "total": 1,
  "items": [
    {
      "site_id": "x9HTLHECq",
      "changed": [
        "sitemap.enabled"
      ],
      "seo": {
        "separator": "sc-dash",
        "separator_char": "-",
        "sitemap": {
          "enabled": true,
          "entries_per_page": 1000,
          "author": false,
          "index_url": "https://example.com/sitemap_index.xml",
          "…": "…"
        },
        "robots_url": "https://example.com/robots.txt",
        "…": "…"
      },
      "cache": {
        "…": "…"
      }
    }
  ]
}
РазделКлючи
separatorстрока — ключ разделителя: sc-dash, sc-pipe, sc-middot…
titlesшаблоны: home, page, post, 404, author, archive, search
metadeschome, page, post, author, archive
noindexarchive, author, author_noposts (bool), post_types, taxonomies — карты {имя: да или нет}
attachmentsredirect_to_parent (bool)
breadcrumbsenabled, bold_last (bool), separator, home, prefix
organizationtype (company, person), name, alternate_name, logo (id картинки), person_user_id, person_name, person_logo (id); при чтении — logo_id, logo_url, person_logo_id
socialopen_graph, twitter (bool), twitter_card (summary, summary_large_image), default_image (id картинки), profiles — facebook, twitter (без @), instagram, linkedin, youtube, wikipedia, mastodon, pinterest, other (массив адресов); при чтении — default_image_id
sitemapenabled, author (bool; не действует — архивов авторов нет), entries_per_page (1–10 000); при чтении еще post_types, taxonomies, governed_by, index_url
index_nowenabled, key; при чтении еще supported. Отправка IndexNow идет через PUT /data/seo.indexnow, этот раздел ее не включает

При чтении рядом еще separator_char и robots_url. Ответ записи — changed (измененные ключи), seo после записи и cache. Состав карты сайта задают noindex.post_types и noindex.taxonomies, в карте только страницы. Свою организацию лучше задавать в данных — PATCH /data/site.organization: пока там пусто name, узел Organization строится из раздела organization этого эндпоинта.

Передайте хотя бы одно поле. Типы вложенных полей и допустимые значения — в описании ответа.

Ошибки

КодHTTPКогдаЧто делать
nothing_to_change400пустое телопришлите раздел
unknown_field400незнакомый раздел или ключ, в том числе незнакомая соцсеть или тип записей; допустимые — в messageуберите поле
invalid_{раздел}, invalid_{ключ}400раздел не объект или значение не той формы: строка, целое число, да/нетисправьте значение
invalid_separator400не ключ вида sc-dashвозьмите ключ из чтения
invalid_organization_type400type не company и не personисправьте тип
invalid_logo, invalid_default_image400картинки с таким id на сайте нетвозьмите id из GET /media
invalid_person_user400пользователя person_user_id нетпроверьте id
invalid_twitter_card400не summary и не summary_large_imageисправьте значение
invalid_profiles400social.profiles не объект или other не массивисправьте профили
invalid_entries_per_page400не от 1 до 10 000исправьте число
sitemap_composition_readonly400прислан sitemap.post_types или sitemap.taxonomiesсостав карты задают noindex.post_types и noindex.taxonomies
invalid_index_now_key400index_now.key не 8–128 знаков a-f0-9 и не "auto"исправьте ключ
index_now_key_missing400index_now.enabled: true без ключапришлите key
index_now_unsupported409index_now.enabled: trueотправляйте адреса через PUT /data/seo.indexnow
yoast_missing409SEO-настройки на сайте недоступны—

Прочитать карточку приложения

GET /data/seo.app

Возвращает карточку приложения и варианты значений app.choices. Подробнее в гайде.

curl -s "$API/site/$SITE/data/seo.app" -H "Authorization: Bearer $OP_TOKEN"

Параметр адресации передается в строке запроса; тела нет.

Ответ

{
  "success": true,
  "name": "seo.app",
  "origin": "system",
  "total": 1,
  "items": [
    {
      "site_id": "SITE_ID",
      "app": {
        "enabled": true,
        "name": "Example",
        "category": "BrowserApplication",
        "operating_systems": [],
        "currency": "USD",
        "rating_value": null,
        "rating_count": null
      }
    }
  ]
}

Поля карточки — в описании записи.

Ошибки

Общие коды — на странице «Ошибки».

Изменить карточку приложения

PATCH /data/seo.app

Карточка приложения — узел SoftwareApplication на главной. Подробнее в гайде.

curl -s -X PATCH "$API/site/$SITE/data/seo.app" \
  -H "Authorization: Bearer $OP_TOKEN" -H 'Content-Type: application/json' \
  -d '{"name": "Example", "category": "WebApplication", "operating_systems": ["Chrome", "Windows"], "price": 0, "currency": "USD", "rating_value": 4.8, "rating_count": 127}'

Тело запроса

ПолеТипОбязательноеПо умолчаниюОписание
enabledboolнетtrueвыводить узел; выключенный не выводится при любых полях
namestringнет—название приложения, обязательно для вывода
descriptionstringнет—описание
categorystringнетBrowserApplicationapplicationCategory, одно из choices.category
operating_systemsstring[]нет[]платформы из choices.operating_systems: Chrome, Firefox, Edge, Safari, Opera, Brave, Windows, macOS, Linux, Android, iOS; выходят строкой через запятую
pricenumberнет—цена, 0 и больше; 0 — бесплатно
currencystringнетUSDвалюта из choices.currency
rating_valuenumberнет—оценка от 1 до 5, обязательна для вывода
rating_countintegerнет—число оценок, от 1, обязательно для вывода

Ответ

Тема выводит узел, когда карточка включена и заполнены name, rating_value и rating_count; картинка узла — иконка сайта. PATCH принимает любое подмножество полей, null или "" очищают поле.

{
  "success": true,
  "name": "seo.app",
  "origin": "system",
  "total": 1,
  "items": [
    {
      "site_id": "x9HTLHECq",
      "changed": [
        "name",
        "category",
        "operating_systems",
        "price",
        "rating_value",
        "rating_count"
      ],
      "app": {
        "enabled": true,
        "name": "Example",
        "description": "",
        "category": "WebApplication",
        "operating_systems": [
          "Chrome",
          "Windows"
        ],
        "price": 0,
        "currency": "USD",
        "rating_value": 4.8,
        "rating_count": 127,
        "image": "https://example.com/…/icon-512.png",
        "missing": [],
        "output": true,
        "choices": {
          "category": {
            "BrowserApplication": "Browser Application",
            "BusinessApplication": "Business Application",
            "EducationalApplication": "Educational Application",
            "UtilitiesApplication": "Utilities Application",
            "WebApplication": "Web Application"
          },
          "operating_systems": {
            "Chrome": "Google Chrome",
            "Windows": "Windows",
            "…": "…"
          },
          "currency": {
            "USD": "USD",
            "EUR": "EUR",
            "GBP": "GBP",
            "RUB": "RUB"
          }
        }
      },
      "cache": {
        "…": "…"
      }
    }
  ]
}

GET отдает app в той же форме без changed и cache. missing — каких из трех обязательных полей не хватает, output — выйдет ли узел на главной, choices — допустимые значения, их задает тема сайта. changed называет только реально изменившиеся поля; после записи кэш страниц сбрасывается, узел виден на главной сразу.

Ошибки

КодHTTPКогдаЧто делать
nothing_to_change400в теле ни одного поляпришлите хотя бы одно
unknown_field400поле вне спискауберите поле
invalid_enabled400не да/нетпришлите true или false
invalid_name, invalid_description400не строкапришлите строку
invalid_category, invalid_currency400значение вне choicesвозьмите значение из choices
invalid_operating_systems400не массив строк или платформа вне choicesвозьмите ключи из choices.operating_systems
invalid_price, invalid_rating_value, invalid_rating_count400число вне диапазонаисправьте число
theme_fields_missing409тема сайта не знает настроек приложения—

Прочитать состояние карты

GET /data/seo.sitemap

Возвращает сведения Search Console и Вебмастера о карте сайта. Подробнее в гайде.

curl -s "$API/site/$SITE/data/seo.sitemap" -H "Authorization: Bearer $OP_TOKEN"

Параметр адресации передается в строке запроса; тела нет.

Ответ

{
  "success": true,
  "name": "seo.sitemap",
  "origin": "system",
  "total": 1,
  "items": [
    {
      "site_id": "SITE_ID",
      "sitemap": "https://example.com/sitemap_index.xml",
      "gsc": {
        "state": "not_submitted",
        "known": []
      },
      "ywm": {
        "state": "not_added",
        "known": []
      }
    }
  ]
}

Поля сервисов и состояния — в описании отправки карты.

Ошибки

Общие коды — на странице «Ошибки».

Отправить карту сайта

PUT /data/seo.sitemap

GET отдает, что Search Console и Вебмастер знают о карте сайта sitemap_index.xml; POST отправляет карту в подключенные консоли. Подробнее в гайде.

curl -s -X PUT "$API/site/$SITE/data/seo.sitemap" \
  -H "Authorization: Bearer $OP_TOKEN" -H 'Content-Type: application/json' \
  -d '{"service": "all"}'

Тело запроса

ПолеТипОбязательноеПо умолчаниюОписание
servicestringнетallgsc, ywm или all
sitemap_urlstringнеткарта сайтаабсолютный адрес карты

Ответ

Отправляет сам сайт через подключенную аналитику.

{
  "success": true,
  "name": "seo.sitemap",
  "origin": "system",
  "total": 1,
  "items": [
    {
      "site_id": "x9HTLHECq",
      "service": "all",
      "sitemap": "https://example.com/sitemap_index.xml",
      "gsc": {
        "state": "submitted",
        "sitemap": "https://example.com/sitemap_index.xml"
      },
      "ywm": {
        "state": "already",
        "already": true,
        "sitemap": "https://example.com/sitemap_index.xml",
        "sitemap_id": "d1a3d870-ab57-32f5-bc04-fec6d92f3bb2"
      }
    }
  ]
}

Ответ по каждому сервису, поле state. Google при чтении: submitted (last_submitted, last_downloaded, is_pending, errors, warnings) или not_submitted (known — какие карты Google знает); при отправке — submitted, Google перечитает карту. Яндекс при чтении: added (sitemap_id, added_date) или not_added (known); при отправке — added или already: отдельного «перечитай» у Вебмастера нет, добавленные карты он обходит сам. Отказ сервиса — тоже state: not_connected (не подключен), not_verified (сайт не подтвержден, 401/403), api_error (code, message — как ответил сервис). Итог проверки несет то же состояние в sitemap.consoles.

Ошибки

КодHTTPКогдаЧто делать
invalid_service400service не gsc, ywm или allисправьте значение
invalid_sitemap_url400не абсолютный адрес http(s)пришлите полный адрес

Прочитать адреса карты

GET /data/seo.sitemap.urls

Отдает все адреса, которые сайт отдает поисковикам в карте: индекс sitemap_index.xml и каждую дочернюю карту из него. Подробнее в гайде.

curl -s "$API/site/$SITE/data/seo.sitemap.urls" -H "Authorization: Bearer $OP_TOKEN"

Параметр адресации передается в строке запроса; тела нет.

Ответ

Список читается с самого сайта в момент запроса и совпадает с XML строка в строку, в том же порядке.

{
  "success": true,
  "name": "seo.sitemap.urls",
  "origin": "system",
  "total": 1,
  "items": [
    {
      "site_id": "x9HTLHECq",
      "sitemap": "https://example.com/sitemap_index.xml",
      "total": 73,
      "sitemaps": [
        {
          "url": "https://example.com/page-sitemap.xml",
          "path": "/page-sitemap.xml",
          "lastmod": "2026-10-03T10:30:00+00:00",
          "status": 200,
          "count": 73
        }
      ],
      "urls": [
        {
          "loc": "https://example.com/",
          "images": 0,
          "lastmod": "2026-09-12T17:48:01+00:00",
          "sitemap": "/page-sitemap.xml"
        },
        {
          "loc": "https://example.com/primery/",
          "images": 2,
          "lastmod": "2026-09-12T18:04:47+00:00",
          "sitemap": "/page-sitemap.xml"
        }
      ],
      "took_ms": 516
    }
  ]
}

total — сколько адресов в картах; у дочерней карты, которая не ответила, — error и count: 0; images — сколько картинок у адреса в карте.

Ошибки

КодHTTPКогдаЧто делать
sitemap_unavailable502индекс карты не ответил; sitemap, status, при обрыве — reasonпроверьте карту в GET /data/seo и повторите
site_home_missing409у сайта нет адреса—

Прочитать robots.txt

GET /data/seo.robots

Возвращает текст robots.txt и признаки его состояния. Подробнее в гайде.

curl -s "$API/site/$SITE/data/seo.robots" -H "Authorization: Bearer $OP_TOKEN"

Параметр адресации передается в строке запроса; тела нет.

Ответ

{
  "success": true,
  "name": "seo.robots",
  "origin": "system",
  "total": 1,
  "items": [
    {
      "site_id": "SITE_ID",
      "content": "User-agent: *\n",
      "url": "https://example.com/robots.txt",
      "site_closed": false,
      "custom": false,
      "default_content": "User-agent: *\n"
    }
  ]
}

custom показывает наличие собственного текста, default_content — шаблон сайта.

Ошибки

Общие коды — на странице «Ошибки».

Записать robots.txt

PUT /data/seo.robots

GET отдает robots.txt, который сайт отдает сейчас, PUT записывает свой текст, DELETE возвращает общий шаблон сети: закрыты служебные разделы, ленты, поиск, /page/, плюс Sitemap: своей карты. Подробнее в гайде.

curl -s -X PUT "$API/site/$SITE/data/seo.robots" \
  -H "Authorization: Bearer $OP_TOKEN" -H 'Content-Type: application/json' \
  -d '{"content": "User-agent: *\nDisallow: /private/\n"}'

Тело запроса

ПолеТипОбязательноеПо умолчаниюОписание
contentstringда—PUT: текст файла до 64 КБ, обязательно

Ответ

Свой текст отдается как есть, строка Sitemap: дописывается, только если ее в тексте нет.

{
  "success": true,
  "name": "seo.robots",
  "origin": "system",
  "total": 1,
  "items": [
    {
      "site_id": "x9HTLHECq",
      "content": "User-agent: *\nDisallow: /private/\n\nSitemap: https://example.com/sitemap_index.xml\n",
      "custom": true,
      "default_content": "User-agent: *\n…",
      "url": "https://example.com/robots.txt",
      "site_closed": false,
      "changed": true,
      "warnings": []
    }
  ]
}

Строка — пустая, # комментарий или Директива: значение. Незнакомая директива, правило до первого User-agent и Sitemap не абсолютным адресом запись не останавливают — они в warnings (line, text, message). У закрытого сайта robots.txt отдает User-agent: * / Disallow: / без Sitemap: (site_closed: true), свой текст сохраняется и возвращается при открытии.

Ошибки

КодHTTPКогдаЧто делать
invalid_robots400строка не той формы; errors (line, text, message) и warningsисправьте строки
invalid_content400не строка или управляющие символыпришлите текст
empty_content400пустой текствернуть шаблон — DELETE /data/seo.robots
too_large413больше 64 КБ; limitсократите текст

Вернуть шаблон robots.txt

DELETE /data/seo.robots

Возвращает шаблон robots.txt. Подробнее в гайде.

curl -s -X DELETE "$API/site/$SITE/data/seo.robots" -H "Authorization: Bearer $OP_TOKEN"

Дополнительных полей строки запроса нет.

Ответ

{
  "success": true,
  "name": "seo.robots",
  "origin": "system",
  "total": 1,
  "items": [
    {
      "site_id": "SITE_ID",
      "content": "User-agent: *\n",
      "url": "https://example.com/robots.txt",
      "site_closed": false,
      "custom": false,
      "default_content": "User-agent: *\n",
      "changed": true
    }
  ]
}

Ошибки

Общие коды — на странице «Ошибки».

Прочитать llms.txt

GET /data/seo.llms

Возвращает текст llms.txt и признаки его состояния. Подробнее в гайде.

curl -s "$API/site/$SITE/data/seo.llms" -H "Authorization: Bearer $OP_TOKEN"

Параметр адресации передается в строке запроса; тела нет.

Ответ

{
  "success": true,
  "name": "seo.llms",
  "origin": "system",
  "total": 1,
  "items": [
    {
      "site_id": "SITE_ID",
      "content": "# Example\n",
      "url": "https://example.com/llms.txt",
      "site_closed": false,
      "exists": true,
      "auto": false
    }
  ]
}

exists показывает наличие файла, auto — автоматическое обновление собранного текста.

Ошибки

Общие коды — на странице «Ошибки».

Записать llms.txt

PUT /data/seo.llms

GET отдает llms.txt сайта, PUT записывает свой текст, DELETE снимает текст — /llms.txt снова отвечает 404. Подробнее в гайде.

curl -s -X PUT "$API/site/$SITE/data/seo.llms" \
  -H "Authorization: Bearer $OP_TOKEN" -H 'Content-Type: application/json' \
  -d '{"content": "# Example\n\n## Pages\n\n- [Тарифы](https://example.com/pricing.md): цены и планы.\n"}'

Тело запроса

ПолеТипОбязательноеПо умолчаниюОписание
contentstringда—PUT: текст файла до 64 КБ, обязательно

Ответ

Своего умолчания нет: без текста файл отвечает 404, собрать его по страницам — PUT /data/seo.llms.build.

Ответ: content, exists, auto (текст собран сборкой и пересобирается сам), url, site_closed; у записи — еще changed и warnings (первая строка не # Название — предупреждение). Свой текст, сохраненный PUT, автоматическим не бывает и сам не меняется; вернуть автоматику — снова вызвать сборку. У закрытого сайта /llms.txt отвечает 404, что бы ни было сохранено.

Ошибки

КодHTTPКогдаЧто делать
invalid_content400не строка или управляющие символыпришлите текст
empty_content400пустой текстснять текст — DELETE /data/seo.llms
too_large413больше 64 КБ; limitсократите текст

Удалить llms.txt

DELETE /data/seo.llms

Удаляет текст llms.txt. Подробнее в гайде.

curl -s -X DELETE "$API/site/$SITE/data/seo.llms" -H "Authorization: Bearer $OP_TOKEN"

Дополнительных полей строки запроса нет.

Ответ

После удаления публичный файл отвечает 404.

{
  "success": true,
  "name": "seo.llms",
  "origin": "system",
  "total": 1,
  "items": [
    {
      "site_id": "SITE_ID",
      "content": "",
      "url": "https://example.com/llms.txt",
      "site_closed": false,
      "exists": false,
      "auto": false,
      "changed": true
    }
  ]
}

Ошибки

Общие коды — на странице «Ошибки».

Показать результат сборки llms.txt

GET /data/seo.llms.build

Собирает предварительный текст llms.txt без записи. Подробнее в гайде.

curl -s "$API/site/$SITE/data/seo.llms.build" -H "Authorization: Bearer $OP_TOKEN"

Параметр адресации передается в строке запроса; тела нет.

Ответ

{
  "success": true,
  "name": "seo.llms.build",
  "origin": "system",
  "total": 1,
  "items": [
    {
      "site_id": "SITE_ID",
      "content": "# Example\n",
      "pages": 1,
      "bytes": 10,
      "saved": false,
      "dry_run": true,
      "url": "https://example.com/llms.txt"
    }
  ]
}

Состав страниц и ограничения — в описании сборки.

Ошибки

Общие коды — на странице «Ошибки».

Собрать llms.txt

PUT /data/seo.llms.build

Собирает llms.txt в формате llmstxt.org по опубликованным страницам всех языков и сохраняет; GET /data/seo.llms.build или {"dry_run": true} показывают результат без записи. Подробнее в гайде.

curl -s -X PUT "$API/site/$SITE/data/seo.llms.build" -H "Authorization: Bearer $OP_TOKEN"

Тело запроса

ПолеТипОбязательноеПо умолчаниюОписание
dry_runboolнетfalseпоказать текст без записи

Ответ

Каждая ссылка ведет на markdown-копию страницы — адрес с .md. Собрать разом llms.txt и все markdown-копии — PUT /data/seo.markdown.

{
  "success": true,
  "name": "seo.llms.build",
  "origin": "system",
  "total": 1,
  "items": [
    {
      "site_id": "x9HTLHECq",
      "content": "# Example\n\n## Pages\n\n- [Тарифы](https://example.com/pricing.md): …",
      "pages": 60,
      "bytes": 18140,
      "saved": true,
      "dry_run": false,
      "url": "https://example.com/llms.txt"
    }
  ]
}

Не попадают страницы с noindex, без фрейма, под паролем, служебная 404 и страницы с неопубликованным родителем. Разделы: сначала страницы без раздела, потом по разделу на каждую корневую страницу с детьми, в конце записи. До 600 ссылок, из них записей до 100; если текст не укладывается в 64 КБ, сначала укорачиваются описания, потом хвосты разделов. Собранный текст помечается auto: true и пересобирается сам после каждой публикации, правки, снятия с публикации, переноса и удаления страницы. Флаг «не индексировать сайт» сборку не останавливает.

Ошибки

КодHTTPКогдаЧто делать
too_large413собранный текст не уложился в 64 КБзакройте лишние страницы noindex

Прочитать состояние IndexNow

GET /data/seo.indexnow

Возвращает состояние ключа, файла подтверждения и последние отправки. Подробнее в гайде.

curl -s "$API/site/$SITE/data/seo.indexnow" -H "Authorization: Bearer $OP_TOKEN"

Параметр адресации передается в строке запроса; тела нет.

Ответ

{
  "success": true,
  "name": "seo.indexnow",
  "origin": "system",
  "total": 1,
  "items": [
    {
      "site_id": "SITE_ID",
      "host": "example.com",
      "endpoint": "https://api.indexnow.org/indexnow",
      "key": {
        "configured": true,
        "location": "https://example.com/KEY.txt",
        "served": true
      },
      "log": []
    }
  ]
}

key содержит configured, source, location, served; при ошибке файла — status и error. log содержит последние 50 отправок.

Ошибки

Общие коды — на странице «Ошибки».

Отправить адреса в IndexNow

PUT /data/seo.indexnow

POST бесплатно отправляет адреса сайта в IndexNow, оттуда их получают Bing, Яндекс, Seznam, Naver и другие участники протокола; GET отдает ключ, файл подтверждения на домене и журнал последних отправок. Подробнее в гайде.

curl -s -X PUT "$API/site/$SITE/data/seo.indexnow" \
  -H "Authorization: Bearer $OP_TOKEN" -H 'Content-Type: application/json' \
  -d '{"urls": ["https://example.com/", "/pricing/"]}'

Тело запроса

ПолеТипОбязательноеПо умолчаниюОписание
urlsarrayнет—полные адреса или пути сайта (/about/), до 50 000; нужен urls или all
allboolнетfalseвсе опубликованные страницы всех языков, кроме закрытых noindex и паролем (skipped_hidden — сколько пропущено)
dry_runboolнетfalseпроверить адреса и ключ без отправки

Ответ

Ключ один на сеть, файл https://<домен>/<ключ>.txt сайт отдает сам и перед отправкой проверяет. Автоотправки при публикации нет.

{
  "success": true,
  "name": "seo.indexnow",
  "origin": "system",
  "total": 1,
  "items": [
    {
      "site_id": "x9HTLHECq",
      "host": "example.com",
      "mode": "urls",
      "dry_run": false,
      "count": 2,
      "sent": 2,
      "rejected": [],
      "batches": [
        {
          "count": 2,
          "status": 200,
          "ok": true,
          "took_ms": 412
        }
      ],
      "key_location": "https://example.com/01a6….txt"
    }
  ]
}

Адрес чужого хоста, в том числе www-варианта, не уходит, а возвращается в rejected с причиной (foreign_host, invalid_url, invalid_scheme, not_a_string). Адреса уходят пачками по 10 000. GET отдает host, endpoint, key (configured, source, location, served; файл не отдается — status и error: http_status — домен ответил не 200, content_mismatch — в файле другой ключ, timeout, unreachable) и log — последние 50 отправок.

Ошибки

КодHTTPКогдаЧто делать
urls_required400нет ни urls, ни allпередайте одно из двух
conflicting_fields400переданы и urls, и allоставьте одно
invalid_urls400urls не массивпришлите массив
no_urls400ни одного адреса этого сайта; host, rejectedпроверьте домен в адресах
too_many_urls413больше 50 000 адресовразбейте на части
indexnow_not_configured409у сети нет ключа IndexNow—
indexnow_key_file_missing409файл ключа не отдается с доменапроверьте key в GET /data/seo.indexnow
indexnow_bad_request, indexnow_key_rejected, indexnow_url_rejected, indexnow_quota, indexnow_network502IndexNow отказал или не ответил; batchesповторите позже

Прочитать настройки проверки позиций

GET /data/seo.serp

Позиции сайта в выдаче Google и Яндекса по запросам снимает SerpApi; на этих эндпоинтах стоит страница «Позиции» раздела SEO консоли. Подробнее в гайде.

curl -s "$API/site/$SITE/data/seo.serp" -H "Authorization: Bearer $OP_TOKEN"

Параметры запроса

ПолеТипОбязательноеПо умолчаниюОписание
refresh1нет—Перечитать остаток поисков своего ключа без расхода поисков.

Ответ

API отдает способ съема, плановую проверку, маску ключа, цену, лимиты и расход. Способ, свой ключ и суточные счетчики принадлежат владельцу токена и общие для всех его сайтов; запросы и история позиций принадлежат сайту.

{
  "success": true,
  "name": "seo.serp",
  "origin": "system",
  "total": 1,
  "items": [
    {
      "mode": "credits",
      "auto": false,
      "key": null,
      "platform": {
        "configured": true
      },
      "credits": {
        "action": "serp_position",
        "price": 1,
        "available": 20,
        "balance": 20,
        "topup_path": "/settings/credits"
      },
      "limits": {
        "max_queries_per_site": 50,
        "max_checks_per_day": 50,
        "manual_cooldown_minutes": 60,
        "manual_checks_per_hour": 10,
        "min_interval_days": 7,
        "platform_max_depth": 30,
        "own_max_depth": 100,
        "concurrency": 2,
        "queue_max": 20
      },
      "budget": {
        "mode": "credits",
        "auto": false,
        "queries_total": 0,
        "planned_checks_month": 0,
        "planned_checks_month_site": 0,
        "checks_today": 0,
        "manual_last_hour": 0,
        "price": 1,
        "planned_credits_month": 0,
        "credits_available": 20,
        "credits_known": true,
        "allowance_today": 50
      }
    }
  ]
}

Способы. За кредиты кредит сначала резервируется, списывается после сохранения позиции, в том числе когда сайт не нашелся в пределах глубины, и возвращается, если съем не удался. Один поиск — страница из десяти результатов; съем останавливается, как только нашелся адрес сайта или его поддомена, поэтому позиция в топ-10 стоит один поиск, а запрос глубиной 30 — до трех. Позиция за пределами глубины сохраняется как position: null. Плановая проверка использует интервалы запросов и доступные лимиты аккаунта.

ЛимитПредел
запросов на сайт50
снятых позиций в сутки на пользователя50 — плановые и ручные вместе, сутки по UTC
как часто снимается запросinterval_days от 7 до 90
ручная проверка одного запросараз в 60 минут
ручных проверок на пользователя10 в час, по одной за раз
глубиназа кредиты — до 30, свой ключ — до 100
одновременных съемов на сервере2, еще 20 ждут в очереди

platform.configured — есть ли на сервере ключ платформы; credits — цена позиции, баланс и страница пополнения. budget: queries_total (запросов на всех сайтах пользователя), planned_checks_month и planned_checks_month_site, checks_today, manual_last_hour, allowance_today; за кредиты — price, planned_credits_month, credits_available, credits_known; своим ключом — searches_total, searches_left, searches_used, days_left, reserve, per_day, spent_today, planned_searches_month, planned_searches_until_reset, fits и max_queries_weekly.

Ошибки

КодHTTPКогдаЧто делать
invalid_mode422не credits и не ownисправьте значение
invalid_auto422не boolпришлите true или false
own_key_required409own без привязанного ключапривяжите ключ PUT /data/seo.serp.key

Изменить настройки проверки позиций

PUT /data/seo.serp

Позиции сайта в выдаче Google и Яндекса по запросам снимает SerpApi; на этих эндпоинтах стоит страница «Позиции» раздела SEO консоли. Подробнее в гайде.

curl -s -X PUT "$API/site/$SITE/data/seo.serp" -H "Authorization: Bearer $OP_TOKEN" -H 'Content-Type: application/json' -d '{"mode": "credits", "auto": false}'

Тело запроса

ПолеТипОбязательноеПо умолчаниюОписание
modestringнетcreditscredits — ключ платформы, 1 кредит за снятую позицию; own — свой ключ SerpApi, платформа ничего не списывает
autoboolнетfalseплановая проверка по interval_days; смена mode без auto переключает и ее: own включает, credits выключает

Ответ

GET отдает способ съема, плановую проверку, свой ключ, цену, лимиты и расход, PUT меняет способ и плановую проверку. Способ, свой ключ и суточные счетчики принадлежат владельцу токена и общие для всех его сайтов; запросы и история позиций принадлежат сайту.

{
  "success": true,
  "name": "seo.serp",
  "origin": "system",
  "total": 1,
  "items": [
    {
      "mode": "credits",
      "auto": false,
      "key": null,
      "platform": {
        "configured": true
      },
      "credits": {
        "action": "serp_position",
        "price": 1,
        "available": 20,
        "balance": 20,
        "topup_path": "/settings/credits"
      },
      "limits": {
        "max_queries_per_site": 50,
        "max_checks_per_day": 50,
        "manual_cooldown_minutes": 60,
        "manual_checks_per_hour": 10,
        "min_interval_days": 7,
        "platform_max_depth": 30,
        "own_max_depth": 100,
        "concurrency": 2,
        "queue_max": 20
      },
      "budget": {
        "mode": "credits",
        "auto": false,
        "queries_total": 0,
        "planned_checks_month": 0,
        "planned_checks_month_site": 0,
        "checks_today": 0,
        "manual_last_hour": 0,
        "price": 1,
        "planned_credits_month": 0,
        "credits_available": 20,
        "credits_known": true,
        "allowance_today": 50
      }
    }
  ]
}

Способы. За кредиты кредит сначала резервируется, списывается после сохранения позиции, в том числе когда сайт не нашелся в пределах глубины, и возвращается, если съем не удался. Один поиск — страница из десяти результатов; съем останавливается, как только нашелся адрес сайта или его поддомена, поэтому позиция в топ-10 стоит один поиск, а запрос глубиной 30 — до трех. Позиция за пределами глубины сохраняется как position: null. Плановая проверка использует интервалы запросов и доступные лимиты аккаунта.

ЛимитПредел
запросов на сайт50
снятых позиций в сутки на пользователя50 — плановые и ручные вместе, сутки по UTC
как часто снимается запросinterval_days от 7 до 90
ручная проверка одного запросараз в 60 минут
ручных проверок на пользователя10 в час, по одной за раз
глубиназа кредиты — до 30, свой ключ — до 100
одновременных съемов на сервере2, еще 20 ждут в очереди

platform.configured — есть ли на сервере ключ платформы; credits — цена позиции, баланс и страница пополнения. budget: queries_total (запросов на всех сайтах пользователя), planned_checks_month и planned_checks_month_site, checks_today, manual_last_hour, allowance_today; за кредиты — price, planned_credits_month, credits_available, credits_known; своим ключом — searches_total, searches_left, searches_used, days_left, reserve, per_day, spent_today, planned_searches_month, planned_searches_until_reset, fits и max_queries_weekly.

Ошибки

КодHTTPКогдаЧто делать
invalid_mode422не credits и не ownисправьте значение
invalid_auto422не boolпришлите true или false
own_key_required409own без привязанного ключапривяжите ключ PUT /data/seo.serp.key

Подключить ключ SerpApi

PUT /data/seo.serp.key

PUT привязывает свой ключ SerpApi — один на пользователя для всех сайтов, новый заменяет прежний; DELETE отвязывает: способ возвращается на credits, плановая проверка своим ключом выключается, история позиций остается. Подробнее в гайде.

curl -s -X PUT "$API/site/$SITE/data/seo.serp.key" \
  -H "Authorization: Bearer $OP_TOKEN" -H 'Content-Type: application/json' \
  -d '{"api_key": "ВАШ_КЛЮЧ_SERPAPI"}'

Тело запроса

ПолеТипОбязательноеПо умолчаниюОписание
api_keystringда—приватный ключ SerpApi, от 32 до 128 латинских букв и цифр, обязательно

Ответ

При привязке ключ проверяется бесплатным запросом сведений об аккаунте SerpApi.

Ответ — как у GET /data/seo.serp. Ключ хранится зашифрованным и обратно не отдается: key — mask (•••• и последние четыре знака), status (ok, exhausted — поиски кончились, invalid — SerpApi ключ не принимает), status_message, plan, searches_total, searches_left, searches_used, hourly_limit, renewal_date, refreshed_at.

Ошибки

КодHTTPКогдаЧто делать
invalid_api_key422ключ не той формы или SerpApi его отвергпроверьте ключ в кабинете SerpApi
serpapi_unavailable502SerpApi не ответил на проверкуповторите запрос
key_not_found404DELETE: отвязывать нечего—
serp_key_unreadable500сохраненный ключ не расшифровалсяпривяжите ключ заново
serp_not_configured503на сервере не настроено хранение ключей—

Отключить ключ SerpApi

DELETE /data/seo.serp.key

Отключает ключ SerpApi и возвращает режим credits, сохраняя запросы и историю. Подробнее в гайде.

curl -s -X DELETE "$API/site/$SITE/data/seo.serp.key" -H "Authorization: Bearer $OP_TOKEN"

Дополнительных полей строки запроса нет.

Ответ

{
  "success": true,
  "name": "seo.serp.key",
  "origin": "system",
  "total": 1,
  "items": [
    {
      "mode": "credits",
      "auto": false,
      "key": null
    }
  ]
}

Форма ответа — как у чтения настроек.

Ошибки

КодHTTPКогдаЧто делать
key_not_found404Ключ не привязан.Прочитайте настройки.

Прочитать поисковые запросы

GET /data/seo.serp.queries

Возвращает запросы сайта с позициями, историей и расходом. Подробнее в гайде.

curl -s "$API/site/$SITE/data/seo.serp.queries" -H "Authorization: Bearer $OP_TOKEN"

Параметр адресации передается в строке запроса; тела нет.

Ответ

{
  "success": true,
  "name": "seo.serp.queries",
  "origin": "system",
  "total": 1,
  "items": [
    {
      "depths": [
        10,
        20,
        30
      ],
      "limits": {
        "max_queries_per_site": 50
      },
      "queries": [],
      "budget": {
        "queries_total": 0
      }
    }
  ]
}

Поля queries[] — в описании добавления запроса.

Ошибки

Общие коды — на странице «Ошибки».

Добавить поисковый запрос

PUT /data/seo.serp.queries

GET отдает запросы сайта с последней позицией, изменением и историей, POST добавляет запрос. Подробнее в гайде.

curl -s -X PUT "$API/site/$SITE/data/seo.serp.queries" \
  -H "Authorization: Bearer $OP_TOKEN" -H 'Content-Type: application/json' \
  -d '{"query": "чат бот онлайн", "lang": "ru"}'

Тело запроса

ПолеТипОбязательноеПо умолчаниюОписание
querystringда—текст от 2 до 400 знаков, обязательно
langstringнет—язык страницы; из него берутся страна и язык выдачи: ru → ru/ru, en → us/en; без него — us/en
gl, hlstringнетиз langстрана (две буквы) и язык выдачи
enginestringнетgooglegoogle или yandex
devicestringнетdesktopdesktop или mobile
depthintнет3010, 20, 30, 50 или 100; за кредиты — не больше 30
interval_daysintнет7от 7 до 90
page_idintнет—страница сайта, к которой относится запрос

Ответ

{
  "success": true,
  "name": "seo.serp.queries",
  "origin": "system",
  "total": 1,
  "items": [
    {
      "query": {
        "id": 23,
        "query": "чат бот онлайн",
        "engine": "google",
        "gl": "ru",
        "hl": "ru",
        "device": "desktop",
        "lang": "ru",
        "page_id": null,
        "source": "manual",
        "depth": 30,
        "interval_days": 7,
        "last_checked_at": null,
        "last_error": "",
        "checked": false,
        "position": null,
        "url": null,
        "previous_position": null,
        "delta": null,
        "history": [],
        "expected_searches_per_month": 12.9
      }
    }
  ]
}

Ответ GET: queries (сначала взятые из ключей страниц), depths — глубины, доступные в текущем способе, limits, budget. У запроса: source (page — из ключа страницы, manual — добавлен руками), checked, position и url последнего съема, previous_position, delta (положительное — поднялся; null, если одна из позиций вне топа), history — последние 12 съемов {at, position}, expected_searches_per_month.

Ошибки

КодHTTPКогдаЧто делать
invalid_query, invalid_engine, invalid_gl, invalid_hl, invalid_depth422значение не той формы; поле — в fieldисправьте поле
depth_not_allowed422глубже 30 за кредиты; maxуменьшите глубину или привяжите свой ключ
invalid_interval422не целое от 7 до 90; minисправьте интервал
query_exists409такой запрос с тем же поисковиком, страной, языком и устройством уже есть; id—
too_many_queries409на сайте уже 50 запросов; limitснимите ненужный

Удалить поисковый запрос

DELETE /data/seo.serp.queries

Снимает запрос вместе с историей позиций и отвечает {"success": true, "name": "seo.serp.queries", "origin": "system", "total": 1, "items": [{"id": 23}]}. Подробнее в гайде.

curl -s -X DELETE "$API/site/$SITE/data/seo.serp.queries" -H "Authorization: Bearer $OP_TOKEN" \
  -H 'Content-Type: application/json' -d '{"id": "23"}'

Поля адресации в теле запроса

ПолеТипОбязательноеПо умолчаниюОписание
idstringда—Id ресурса из ответа чтения.

Дополнительных полей строки запроса нет.

Ответ

Снимает запрос вместе с историей позиций и отвечает {"success": true, "name": "seo.serp.queries", "origin": "system", "total": 1, "items": [{"id": 23}]}. Подробнее в гайде.

Ошибки

КодHTTPКогдаЧто делать
query_not_found404запроса нет на этом сайтевозьмите id из GET /data/seo.serp.queries

Взять запросы из ключей страниц

PUT /data/seo.serp.sync

Берет первый ключ каждой опубликованной страницы (свойство focus_keyword) и заводит запрос на языке страницы. Подробнее в гайде.

curl -s -X PUT "$API/site/$SITE/data/seo.serp.sync" -H "Authorization: Bearer $OP_TOKEN"

Дополнительных полей строки запроса нет.

Ответ

Запросы, чей ключ со страницы пропал, выключаются, история остается; сверх 50 запросов на сайт не добавляет.

Ответ: pages_with_keyword, added, kept, disabled, skipped_over_limit, limit. Своих отказов нет.

Ошибки

Общие коды — на странице «Ошибки».

Прочитать историю позиций

GET /data/seo.serp.positions?id={id}

Отдает query и positions от старых к новым: at, position (null — вне топа), url — найденный адрес сайта, searches — сколько поисков ушло. Подробнее в гайде.

curl -s "$API/site/$SITE/data/seo.serp.positions?id=23&limit=100" -H "Authorization: Bearer $OP_TOKEN"

Параметры запроса

ПолеТипОбязательноеПо умолчаниюОписание
idstringда—Id ресурса из ответа чтения.

Параметры запроса

ПолеТипОбязательноеПо умолчаниюОписание
limitintнет100сколько съемов, не больше 500

Ответ

Отдает query и positions от старых к новым: at, position (null — вне топа), url — найденный адрес сайта, searches — сколько поисков ушло. Подробнее в гайде.

Ошибки

КодHTTPКогдаЧто делать
query_not_found404запроса нет на этом сайтевозьмите id из GET /data/seo.serp.queries

Проверить позицию запроса

PUT /data/seo.serp.check

Снимает позицию сразу; платит тот, кто вызвал: кредитом или поиском своего ключа. Подробнее в гайде.

curl -s -X PUT "$API/site/$SITE/data/seo.serp.check" -H "Authorization: Bearer $OP_TOKEN" \
  -H 'Content-Type: application/json' -d '{"id": "23"}'

Поля адресации в теле запроса

ПолеТипОбязательноеПо умолчаниюОписание
idstringда—Id ресурса из ответа чтения.

Дополнительных полей строки запроса нет.

Ответ

Ответ: searches, credits (1 за кредиты, 0 своим ключом), mode и query с новой позицией.

При любом отказе ничего не снято и не списано; причина последнего отказа, кроме лимитов и нехватки кредитов, остается в last_error запроса.

Ошибки

КодHTTPКогдаЧто делать
insufficient_credits402не хватает кредитов; required, available, topup_pathпополните баланс
check_cooldown429запрос проверяли руками меньше 60 минут назад; retry_after_sec, cooldown_minutesподождите
manual_hourly_limit42910 ручных проверок за час; retry_after_secподождите
daily_limit_reached42950 позиций за сутки; limit, usedдождитесь 00:00 UTC
queue_full429очередь сервера полна; retry_after_secповторите через минуту
check_in_progress409идет другая ваша проверкадождитесь ее
no_own_key409способ own без ключапривяжите ключ
invalid_api_key409привязанный ключ перестал работатьпривяжите рабочий
no_searches_left409поиски кончились, в том числе посреди съема — тогда результат не сохраняетсядождитесь сброса тарифа
serpapi_failed502SerpApi не справился; kind: throttled, network, failedповторите позже
platform_key_missing503на сервере не настроен ключ платформыснимайте своим ключом
credits_unavailable503кредиты недоступныповторите позже
query_not_found404запроса нет на этом сайте—

Пункты проверки

Своего хранилища у чеклиста нет: все, что он показывает, лежит в настройках сайта, SEO-настройках, теме и страницах и правится там же. Пункты canonical, redirects, not-found и карта сайта собраны в один tech-basics, Метрика, GA4, Search Console и Вебмастер — в counters, проверки H1 и уровней — в headings. Пункты группы Languages есть только на многоязычном сайте; на одноязычном homes стоит последним пунктом «Основы».

ПунктГруппаЧто проверяетЧем чинить
identityBasicsназвание сайтаPUT /data/settings/name
site-iconBasicsиконка сайта: favicon и логотип организации в разметкеPUT /data/settings/icon
homesBasicsу каждого языка опубликованная главнаяPUT /data/site.front_page, перевод главной
countersIndexingМетрика, GA4, Search Console, Вебмастер; статус — худший из четырехPUT /data/settings/{field}, поля metrika, ga, gsc, webmaster
tech-basicsIndexingкарта сайта XML, canonical на саму страницу, 301 после переноса, 404 с noindexкарта — PATCH /data/seo sitemap.enabled; остальное платформа делает сама
auto-sitemap-hreflang, auto-hreflang, auto-x-defaultLanguagesкарта с альтернативами языков, hreflang с обратными ссылками, x-default на основной языкделает платформа
schema-websiteMarkupWebSite на главной: name, url, descriptionописание — PATCH /data/site.settings
schema-organizationMarkupOrganization на главной: name, url, logo, желательно sameAsPATCH /data/site.organization, PATCH /data/site.socials
schema-pageMarkupWebPage главной и Article первой статьисвойство seo_description, набор author
schema-authorMarkupPerson автора статьи и ProfilePagePUT /data/author
schema-breadcrumbsMarkupBreadcrumbList с name у каждого звенавложенность страниц: свойство url с родителем
schema-howtoMarkupHowTo с шагами по порядкуфрейм howto или текст страницы
schema-faqMarkupFAQPage, один узел на страницублок вопросов на странице
schema-appMarkupSoftwareApplication: name и offers или aggregateRatingPATCH /data/seo.app
schema-ogMarkupog:title, og:description, og:url, og:type, og:image, twitter:cardPATCH /data/seo social
auto-webpSpeedкартинки отдаются в WebPделает платформа
auto-lcp-preloadSpeedpreload и fetchpriority="high" у картинки первого экранаделает платформа
auto-web-vitalsSpeedLCP, INP, CLS домена из Chrome UX Report—
page-cacheSpeedстраницы отдаются из кэшаделает платформа
keywordsPagesключ страницы стоит в <title> и meta descriptionсвойства seo_title, seo_description
pages-metaPagesу страниц есть <title> и meta descriptionseo_title, seo_description
pages-lengthPagestitle не длиннее 65 знаков, описание — 165seo_title, seo_description
headingsPagesровно один H1 и уровни без пропусковтело страницы
pages-noindexPagesкакие страницы закрыты noindexсвойство noindex
images-altPagesу картинок тела есть alt![alt](url) в теле страницы
contactsPagesполитика, условия, контакты и контакты в подвале по каждому языкупубликация страниц, набор footer

Страницы чинит публикация Markdown с нужными свойствами или текстом — POST /pages/markdown или точечно PATCH /pages/{ref}/markdown. Готовые команды по каждой странице — в fix пункта, до 25 страниц; сайт в них назван в пути, /site/{site_id}/…, а настройки сайта правятся через данные — site.settings, site.organization, site.socials. Например, вписать ключ в title и описание страницы 6949:

curl -s -X POST "$API/site/$SITE/pages/markdown" \
  -H "Authorization: Bearer $OP_TOKEN" -H 'Content-Type: application/json' \
  -d '{"markdown": "---\nid: 6949\nfocus_keyword: \"чат бот\"\nseo_title: \"Чат бот онлайн без регистрации\"\nseo_description: \"Бесплатный чат бот: …\"\n---\n\n<тело из выгрузки без изменений>"}'

homes. Строка на язык: lang, is_default, id, title, url, status, reason. Строка в порядке, когда по / сайт показывает страницу, у языка она есть среди переводов главной, опубликована, у нее есть фрейм и ее адрес отвечает 200 без редиректа этой самой страницей. Иначе reason: posts (вместо страницы — лента записей), noPage (главной на языке нет), notPage, notPublished, noFrame, wrongPage (по адресу другая страница), redirect, closed (сайт закрыт), unreachable, http. Нет главной языка — POST /pages/markdown с translation_of: <id главной> и lang или привязка готовой страницы PATCH /data/translations; нет фрейма — PATCH /pages/{ref} с frame; по адресу другая страница или редирект — POST /cache/flush.

counters. «Метрика» в порядке, когда у сайта есть номер счетчика, «Google Analytics» — measurement ID, «Search Console» и «Вебмастер» — когда права подтверждены (verified: true). Строка в консоли ведет в «Аналитика → Счетчики».

tech-basics. В rows — строка на каждую часть, status ok или warn; сломано хоть что-то — весь пункт не ok. У строки карты — url индекса, count адресов (сумма <url> по дочерним картам живого индекса) и bots — когда боты последний раз забирали карту. Подтверждение остальных частей — signals.canonical, signals.redirects и signals.not_found обхода. На сайте публичны только страницы: архивов авторов, дат, вложений, рубрик и меток, их лент и типа записей post нет (он остается только там, где уже есть опубликованные записи) — такие адреса отвечают 404 и в карту сайта не попадают.

keywords. Проверяются опубликованные страницы обхода, у которых задан ключ — свойство focus_keyword; несколько ключей — через запятую, точку с запятой или с новой строки. Title и Description сверяются с отданной разметкой: фразой целиком по границам слов, без учета регистра и диакритики (é = e), кавычки, тире и знаки препинания отбрасываются; в китайском, японском, тайском и бирманском — вхождением без границ слов. Статус: все страницы с ключом в порядке — ok, есть нарушения — todo, ключ не задан ни у одной — na. Строка: id, title, lang, url, keywords, title_ok, description_ok (null, когда страница не открылась, причина в reason), missing, seen (title, description), status; нарушения идут первыми.

headings. В полях — «Ровно один H1: N из N» и «Уровни без пропусков: N из N», в pages — страницы с нарушениями, статус — худший из двух. problems[].kind: no_h1, many_h1 (count, text второго), jump — скачок уровня (from, to, text), рядом outline — лестница заголовков. Навигация, подвал и боковая колонка не учитываются; H1 — первая строка # … в теле или заголовок, который печатает фрейм.

images-alt. Картинки тела каждой открытой страницы обхода, без шапки, меню, подвала и боковой колонки. Нет атрибута alt — нарушение; alt="" засчитывается только декоративной картинке (role="presentation" или aria-hidden="true"). В rows — src, file, alt (null — атрибута нет, "" — пустой), page. Alt вписывается в тело страницы: ![alt](url) становится <img alt="alt">.

contacts. По каждому языку опубликованы политика конфиденциальности, условия использования и страница контактов, а в подвале главной — почта или телефон (mailto:, tel:) и ссылки на оба документа. Документ находится по слагу страницы языка: privacy, privacy-policy, polite, politika…, политика…; terms, terms-of-use, oferta, оферта; contacts, contact, kontakty, контакты. Строка: lang, is_default, privacy, terms, contacts ({id, title, url} или null), footer_contact, footer_legal, status, reason. Подвал из набора footer правится PUT /data/footer с тем же lang; набора нет — 404 source_not_found, подвал тогда задан фреймом.

Schema-разметка. Пункты schema-* показывают не настройки, а то, что сайт отдает: узлы JSON-LD и теги Open Graph, снятые с живых страниц без кук. Страницы-образцы: главная, первая статья (Article, BlogPosting, NewsArticle), страница с вопросами, страница автора (ProfilePage), страница с крошками и одна внутренняя. Статус: узел есть и обязательные поля заполнены — ok; обязательное поле пустое или ссылка {"@id": …} ведет на объект, которого нет на странице, — warn; узла нет, хотя он нужен, — todo; к сайту не относится — na; образец не открылся — unknown. В rows — строка на образец: page (home, article, faq, profile, breadcrumbs, app, inner), label, id, lang, url, status, title — тип узла, language (json или markup), code — узел как есть или мета-теги строками (null — узла нет), missing, recommended, refs, note. Код режется на 24 КБ.

Отдельные узлы. Organization строит кто-то один: пока в site.organization пусто name, узел выводит SEO-граф из раздела organization /data/seo с sameAs из social.profiles; как только name заполнено, сайт выводит узел из site.organization (логотип — иконка сайта, sameAs — site.socials), поле «Источник» говорит, какой действует. Person тема собирает из набора author только на страницах, чей фрейм объявил набор: набор есть, а Person не выводит ни одна страница — todo. BreadcrumbList строится по вложенности страниц, первое звено — главная языка; плоский сайт — na. HowTo печатает фрейм howto в теле страницы; без него платформа собирает узел из трех и больше подзаголовков «Шаг 1…» или нумерованного списка от трех пунктов под H2/H3 со словом инструкции, а шаги фрейма steps важнее текста. Два FAQPage или два HowTo на странице — warn.

Скорость. auto-webp — warn, если есть картинки не в WebP, в pages до 50 страниц (note — сколько картинок не в WebP), всего — pages_total. auto-web-vitals — по порогам CrUX по p75 (телефоны, если есть): все «хорошо» — ok, есть «нужно улучшить» — warn, есть «плохо» — todo (LCP хорошо ≤ 2,5 с, плохо > 4 с), данных нет — na. page-cache — главная и две страницы обхода по два захода без кук, второй обязан прийти из кэша; в rows — адрес, status, ttfb_ms.

Данные сайта для SEO

Название, иконка, описание, главная, счетчики, организация, соцсети, автор и подвал — это данные сайта, и пишутся они через /data; поля и отказы — на странице Настройки сайта. Например, заполнить описание сайта, которое идет в узел WebSite:

curl -s -X PATCH "$API/site/$SITE/data/site.settings" \
  -H "Authorization: Bearer $OP_TOKEN" -H 'Content-Type: application/json' \
  -d '{"description": "Бесплатный ИИ-чат без регистрации"}'
ЧтоЭндпоинтПункт проверкиПодробно
название сайтаPUT /data/settings/nameidentityполя настроек
иконка: favicon и логотип в разметкеPUT /data/settings/iconsite-iconполя настроек
сайт открыт или закрытPUT /data/settings/closedaccess в GET /data/seo.auditполя настроек
описание и видимость поисковикам blog_publicPATCH /data/site.settingsschema-websitesite.settings
главная сайта и языковPUT /data/site.front_pagehomesглавная
Метрика, GA4, Search Console, ВебмастерPUT /data/settings/{field}, поля metrika, ga, gsc, webmastercountersсчетчики
организацияPATCH /data/site.organizationschema-organizationорганизация
соцсети: sameAs и twitter:sitePATCH /data/site.socialsschema-organization, schema-ogсоцсети
автор статейPUT /data/authorschema-authorсправочник данных
контакты и документы в подвалеPUT /data/footer с langcontactsсправочник данных

Закрытый сайт (closed: true) отвечает посетителям 503 с X-Robots-Tag: noindex, robots.txt отдает Disallow: /, карты сайта отвечают 503, llms.txt — 404. Трафик по страницам из Search Console и GA4 — GET /pages/{ref}/traffic, рекомендации по странице — поле advice того же ответа.

arrow_backНазад
Кросспостинг
Далееarrow_forward
Семантика
На этой странице
  • Эндпоинты
    • Проверить SEO сайта
      • Ответ
        • Ошибки
      • Прочитать итог проверки
        • Ответ
          • Ошибки
        • Проверить страницы
          • Параметры запроса
            • Ответ
              • Ошибки
            • Запустить проверку ссылок
              • Ответ
                • Ошибки
              • Прочитать проверку ссылок
                • Ответ
                  • Ошибки
                • Получить граф ссылок
                  • Параметры запроса
                    • Ответ
                      • Ошибки
                    • Проверить индексацию страницы
                      • Параметры запроса
                        • Ответ
                          • Ошибки
                        • Проверить индексацию нескольких страниц
                          • Тело запроса
                            • Ответ
                              • Ошибки
                            • Прочитать SEO-настройки
                              • Ответ
                                • Ошибки
                              • Изменить SEO-настройки
                                • Тело запроса
                                  • Ответ
                                    • Ошибки
                                  • Прочитать карточку приложения
                                    • Ответ
                                      • Ошибки
                                    • Изменить карточку приложения
                                      • Тело запроса
                                        • Ответ
                                          • Ошибки
                                        • Прочитать состояние карты
                                          • Ответ
                                            • Ошибки
                                          • Отправить карту сайта
                                            • Тело запроса
                                              • Ответ
                                                • Ошибки
                                              • Прочитать адреса карты
                                                • Ответ
                                                  • Ошибки
                                                • Прочитать robots.txt
                                                  • Ответ
                                                    • Ошибки
                                                  • Записать robots.txt
                                                    • Тело запроса
                                                      • Ответ
                                                        • Ошибки
                                                      • Вернуть шаблон robots.txt
                                                        • Ответ
                                                          • Ошибки
                                                        • Прочитать llms.txt
                                                          • Ответ
                                                            • Ошибки
                                                          • Записать llms.txt
                                                            • Тело запроса
                                                              • Ответ
                                                                • Ошибки
                                                              • Удалить llms.txt
                                                                • Ответ
                                                                  • Ошибки
                                                                • Показать результат сборки llms.txt
                                                                  • Ответ
                                                                    • Ошибки
                                                                  • Собрать llms.txt
                                                                    • Тело запроса
                                                                      • Ответ
                                                                        • Ошибки
                                                                      • Прочитать состояние IndexNow
                                                                        • Ответ
                                                                          • Ошибки
                                                                        • Отправить адреса в IndexNow
                                                                          • Тело запроса
                                                                            • Ответ
                                                                              • Ошибки
                                                                            • Прочитать настройки проверки позиций
                                                                              • Параметры запроса
                                                                                • Ответ
                                                                                  • Ошибки
                                                                                • Изменить настройки проверки позиций
                                                                                  • Тело запроса
                                                                                    • Ответ
                                                                                      • Ошибки
                                                                                    • Подключить ключ SerpApi
                                                                                      • Тело запроса
                                                                                        • Ответ
                                                                                          • Ошибки
                                                                                        • Отключить ключ SerpApi
                                                                                          • Ответ
                                                                                            • Ошибки
                                                                                          • Прочитать поисковые запросы
                                                                                            • Ответ
                                                                                              • Ошибки
                                                                                            • Добавить поисковый запрос
                                                                                              • Тело запроса
                                                                                                • Ответ
                                                                                                  • Ошибки
                                                                                                • Удалить поисковый запрос
                                                                                                  • Поля адресации в теле запроса
                                                                                                    • Ответ
                                                                                                      • Ошибки
                                                                                                    • Взять запросы из ключей страниц
                                                                                                      • Ответ
                                                                                                        • Ошибки
                                                                                                      • Прочитать историю позиций
                                                                                                        • Параметры запроса
                                                                                                          • Параметры запроса
                                                                                                            • Ответ
                                                                                                              • Ошибки
                                                                                                            • Проверить позицию запроса
                                                                                                              • Поля адресации в теле запроса
                                                                                                                • Ответ
                                                                                                                  • Ошибки
                                                                                                                • Пункты проверки
                                                                                                                  • Данные сайта для SEO
                                                                                                                  1. Главная
                                                                                                                  2. Docs
                                                                                                                  3. Документация OnPress v2
                                                                                                                  4. Справочник API
                                                                                                                  5. SEO
                                                                                                                  © 2026 OnPress ИП Зуев И.В. ИНН: 360408359441 info@onpress.pro Политика конфиденциальности Публичная оферта
                                                                                                                  • Visa
                                                                                                                  • Mastercard
                                                                                                                  • Сбер Pay
                                                                                                                  • T-Pay