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

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

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

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

Отримати ключ API Дослідити MCP

Автентифікація Bearer · 60 req/min · Той самий шар даних, що й MCP · Без скрапінгу

seocrawl — REST /v1

$ curl "https://api.seocrawl.ai/v1/properties/$ID/gsc/summary?range=last_28_days" \

-H "Authorization: Bearer sca_live_…"

{ "data": {

"period": { "from": "2026-06-09", "to": "2026-07-06" },

"metrics": {

"clicks": 2388, "impressions": 811019,

"ctr": 0.00294, "position": 22.87

"metrics_diff": { "clicks": 584, … }

} }

Автентифікуйтеся один раз. Викликайте REST.

Згенеруйте токен Bearer у панелі та передайте його в заголовку Authorization. Той самий ключ працює і в REST API, і на сервері MCP.

Базовий URL

https://api.seocrawl.ai/v1

Заголовок Authorization

Authorization: Bearer sca_live_your_token_here

Отримати ключ API Read the API docs

cURLJavaScriptPython

# cURL — resolve a property id, then query it
curl https://api.seocrawl.ai/v1/properties \
  -H "Authorization: Bearer sca_live_…"

curl "https://api.seocrawl.ai/v1/properties/$ID/gsc/summary?range=last_28_days" \
  -H "Authorization: Bearer sca_live_…"

// JavaScript
const res = await fetch(
  "https://api.seocrawl.ai/v1/properties/" + id + "/gsc/summary?range=last_28_days",
  { headers: { Authorization: "Bearer sca_live_…" } }
);
const data = await res.json();

# Python
import requests
r = requests.get(
  f"https://api.seocrawl.ai/v1/properties/{id}/gsc/summary",
  params={"range": "last_28_days"},
  headers={"Authorization": "Bearer sca_live_…"},
)
print(r.json())

Ендпоінти

Один шар даних, дві поверхні

Кожен REST-ендпоінт читає з того самого канонічного шару, що й інструменти MCP — тож ваш дашборд і ваші AI-агенти завжди бачать однакові числа. Ці групи доступні наживо у v1; ширше покриття додається постійно.

Properties

Отримайте список property Search Console, до яких у вас є доступ. Використовуйте `id` кожної property у шляху кожного ендпоінта даних.

GET/v1/propertiesНаживо

Google Search Console

Кліки, покази, CTR і середня позиція — за запитом, сторінкою, діапазоном дат і період до періоду.

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Незабаром

Чому це API

Створене для продуктів, а не для скраперів

Справжнє 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 property своїх клієнтів під одним обліковим записом — зі суворою ізоляцією даних. В активній розробці; запитайте нас про ранній доступ.

Почніть за 3 кроки

Від нуля до першого автентифікованого виклику за кілька хвилин.

Згенеруйте ключ

Відкрийте токени API у своїй панелі та згенеруйте токен Bearer. Скопіюйте його один раз — він починається з `sca_live_`.

Надішліть заголовок

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

Отримуйте дані

Викличте `GET /v1/properties`, щоб отримати `id` property, потім звертайтеся до `/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 чи свій шар звітності — один ключ, кожна property, без ручних експортів.

Команди даних

Завантажуйте дані GSC, про позиції та з AI Tracker у своє сховище за розкладом. Поєднуйте їх із доходом і будуйте моделі, яких потребують ваші дашборди.

Розробники

Автоматизуйте перевірки й сповіщення, синхронізуйте завдання зі своїм PM-інструментом і вбудуйте моніторинг AI-видимості в застосунки, які ви вже випускаєте.

Часті запитання

Чи справді є публічне SEO API?

Так — REST `/v1` API з автентифікацією Bearer доступне наживо, охоплюючи продуктивність Search Console, property, промпти 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 property своїх клієнтів?

Цей багатоклієнтський партнерський потік — Google OAuth для кожного клієнта, щоб ви могли під’єднати кожну з GSC property своїх клієнтів під власним обліковим записом, зі суворою ізоляцією даних — в активній розробці. Якщо ви будуєте партнерську інтеграцію, зв’яжіться з нами щодо раннього доступу.

Які дані я можу отримати сьогодні?

Підсумок Search Console і порівняння періодів, найкращі ключові слова та сторінки, деталізацію одного ключового слова/сторінки, список ваших property, промпти AI Tracker та повне читання/запис завдань. Це дзеркалить те, що надає MCP, через REST.

Готові будувати на своїх SEO-даних?

Згенеруйте ключ Bearer у панелі та зробіть свій перший REST-виклик за лічені хвилини — або поговоріть із нами про партнерський і багатоклієнтський доступ.

Отримати ключ API Замовити демо