REST API · v1 · Живая документация

SEO API для вашего стека

Ваши данные по SEO и видимости в AI через обычный REST-эндпоинт.

Забирайте данные Google Search Console, позиций и AI Tracker прямо в свой продукт, дашборд или хранилище. Авторизуйтесь Bearer-ключом из панели, дёргайте REST /v1 и получайте типизированный JSON — тот же канонический слой данных, на котором работает MCP SEOcrawl AI. GA4, полные выгрузки аудита сайта и мультиклиентский партнёрский OAuth появятся дальше.

Получить ключ APIОткрыть документацию APIИзучить MCP
Claude
Codex CLI
Cursor
SEOcrawl AI REST API — curl request and typed JSON response
SEOcrawl AI REST API examples in cURL, JavaScript and Python

Авторизуйтесь один раз. Дёргайте REST.

Выпустите Bearer-токен в панели и передавайте его в заголовке Authorization. Один и тот же ключ работает и в REST API, и на сервере MCP.

Базовый URL

https://api.seocrawl.ai/v1

Заголовок Authorization

Authorization: Bearer sca_live_your_token_here
Получить ключ APIRead the API docs

Один слой данных, две поверхности

Каждый REST-эндпоинт читает тот же канонический слой, что и инструменты MCP, — ваш дашборд и ваши AI-агенты всегда видят одни и те же цифры. Эти группы уже работают в v1; покрытие расширяется постоянно.

Properties

Список ресурсов Search Console, к которым у вас есть доступ. id ресурса подставляется в путь каждого эндпоинта данных.

  • GET/v1/propertiesРаботает

Google Search Console

Клики, показы, CTR и средняя позиция — по запросу, странице, диапазону дат и в сравнении с предыдущим периодом. Подробности — на отдельной странице Google Search Console API.

  • GET/v1/properties/{id}/gsc/summaryРаботает
  • GET/v1/properties/{id}/gsc/compareРаботает
  • GET/v1/properties/{id}/gsc/top-keywordsРаботает
  • GET/v1/properties/{id}/gsc/top-pagesРаботает
  • GET/v1/properties/{id}/gsc/keywords/detailРаботает
  • GET/v1/properties/{id}/gsc/pages/detailРаботает

AI Tracker

Читайте промпты, по которым вы следите за упоминаниями бренда в ChatGPT, Claude, Gemini и Perplexity.

  • GET/v1/properties/{id}/ai-tracker/promptsРаботает

Задачи

Читайте и пишите SEO-задачи — подключите свою доску задач к собственному таск-трекеру.

  • GET/v1/properties/{id}/tasksРаботает
  • POST/v1/properties/{id}/tasksРаботает
  • GET/v1/properties/{id}/tasks/{ticketId}Работает
  • PATCH/v1/properties/{id}/tasks/{ticketId}Работает
  • POST/v1/properties/{id}/tasks/{ticketId}/commentsРаботает

GA4 и индексация

Трафик, рефереры из AI и статус индексации. Подключение готово; REST-эндпоинты в работе.

  • GET/v1/properties/{id}/ga4/summaryСкоро
  • GET/v1/properties/{id}/indexation/summaryСкоро

Site Audit

Состояние краулинга, on-page, техничка и списки ошибок — полный набор данных аудита через REST.

  • GET/v1/properties/{id}/audit/summaryСкоро
  • GET/v1/properties/{id}/audit/issuesСкоро

Сделано под продукты, а не под парсеры

Нормальный REST API с аутентификацией Bearer, скоупами и лимитами запросов. Слой данных общий с MCP, поэтому цифры не расходятся.

Чистый REST, типизированный JSON

Предсказуемые ресурсы, стандартные методы, типизированные JSON-ответы и ошибки по RFC (401 без авторизации, 403 scope_required, 429 с Retry-After). Никакого парсинга HTML и хрупких выгрузок.

Один канонический слой данных

REST-эндпоинты и инструменты MCP — близнецы поверх одних и тех же провайдеров, паритет проверяется в CI. Ваш дашборд и ваши AI-агенты всегда видят одни и те же клики, показы и позиции.

Ключи самообслуживания

Выпускайте и отзывайте Bearer-токены в панели за секунды. Один и тот же ключ sca_live_ авторизует и REST API, и MCP-сервер — одни доступы, две поверхности.

Задокументированные лимиты

60 запросов в минуту и 1 000 в час на токен, с понятным ответом 429 и заголовком Retry-After. Лимиты REST считаются отдельно от MCP, так что одно не съедает другое.

Доступ по скоупам

Крупные скоупы на чтение и запись закрывают каждый эндпоинт, проверяются на фаерволе со стандартными step-up ответами. Выдавайте ключу ровно то, что ему нужно.

Мультиклиентский доступ, скоро

Отдельный поток Google OAuth под каждого клиента: партнёр подключает ресурсы GSC всех своих клиентов под одним аккаунтом, с жёсткой изоляцией данных. В активной разработке; напишите нам про ранний доступ.

Старт в 3 шага

От нуля до первого авторизованного вызова — пара минут.

1

Выпустите ключ

Откройте токены API в панели и выпустите Bearer-токен. Скопируйте его сразу — он начинается с sca_live_.

2

Отправьте заголовок

Передавайте Authorization: Bearer sca_live_… в каждом запросе к https://api.seocrawl.ai/v1. Тот же ключ работает и с MCP-сервером.

3

Забирайте данные

Вызовите GET /v1/properties, возьмите id ресурса, дальше дёргайте /v1/properties/{id}/… за показателями GSC, промптами AI Tracker или задачами — и отправляйте JSON прямо в продукт, дашборд или хранилище.

Три способа добраться до своих данных

Цифры одни и те же, поверхности разные — берите ту, которая подходит вашему стеку.

REST API

Для продуктов, дашбордов и пайплайнов данных. Аутентификация Bearer, типизированный JSON, лимиты запросов. Вы на этой странице.

MCP-сервер

Для AI-агентов: Claude, ChatGPT и любой MCP-клиент спрашивают ваши данные обычным языком.

Изучить MCP

Терминал и CLI

Для скриптов и CI/CD: работайте со своими данными из любого терминального агента с поддержкой MCP.

Посмотреть CLI
Сравнить все интеграции

Кто строит на API

Команды, которым нужны данные по SEO и видимости в AI внутри своих систем.

SaaS и партнёры

Встройте живые SEO-метрики в интерфейс своего продукта. Отдавайте пользователям данные Search Console и видимости в AI, не собирая пайплайны самостоятельно.

Агентства

Отправляйте данные каждого клиента в свой портал, Looker Studio или собственный слой отчётности — один ключ, все ресурсы, без ручных выгрузок.

Команды данных

Заливайте данные GSC, позиций и AI Tracker в хранилище по расписанию. Джойните с выручкой и стройте модели, на которых держатся ваши дашборды.

Разработчики

Автоматизируйте проверки и алерты, синхронизируйте задачи со своим таск-трекером и встраивайте мониторинг видимости в AI в приложения, которые вы и так релизите.

Частые вопросы

У вас правда есть публичное SEO API?

Да — REST /v1 API с аутентификацией Bearer уже работает и покрывает показатели Search Console, ресурсы, промпты AI Tracker и задачи. Полная публичная документация — на api.seocrawl.ai/docs. Более широкое покрытие (GA4, полные выгрузки аудита сайта) и мультиклиентский партнёрский OAuth появятся дальше. Нужно то, чего ещё нет? Напишите нам про ранний доступ.

Как аутентифицироваться?

Bearer-токеном. Выпустите ключ sca_live_ в панели и отправляйте его как Authorization: Bearer <key> в каждом запросе. Для своего аккаунта никаких плясок с OAuth — только заголовок.

Это тот же ключ, что в MCP?

Да. Один и тот же токен авторизует и REST API, и MCP-сервер: оба читают один канонический слой данных. Одни доступы, две поверхности и одинаковые цифры.

Какие лимиты запросов?

60 запросов в минуту и 1 000 в час на токен. Превысите — придёт 429 с заголовком Retry-After. Лимиты REST считаются отдельно от MCP, так что за один бюджет они не конкурируют.

Можно подключить ресурсы Search Console моих клиентов?

Мультиклиентский партнёрский поток — Google OAuth под каждого клиента, чтобы вы подключали ресурсы GSC всех клиентов под своим аккаунтом с жёсткой изоляцией данных — в активной разработке. Если вы делаете партнёрскую интеграцию, напишите нам про ранний доступ.

Какие данные доступны сегодня?

Сводка Search Console и сравнение периодов, топ ключевых слов и страниц, детализация по одному запросу или странице, список ваших ресурсов, промпты AI Tracker и полное чтение и запись задач. Это то же, что отдаёт MCP, только через REST.

Готовы строить на своих SEO-данных?

Выпустите Bearer-ключ в панели и сделайте первый REST-вызов за пару минут — или напишите нам про партнёрский и мультиклиентский доступ.

Получить ключ APIОткрыть документацию APIЗаказать демо