API REST · v1 · Dokumentacja na żywo

API SEO dla Twojego własnego stacku

Twoje dane SEO i o widoczności AI przez czysty endpoint REST.

Pobieraj dane z Google Search Console, o rankingach i z AI Tracker prosto do swojego produktu, dashboardu lub hurtowni danych. Uwierzytelnij się kluczem Bearer z panelu, wywołaj REST `/v1` i odbierz typowany JSON — tę samą kanoniczną warstwę danych, która zasila MCP SEOcrawl AI. GA4, pełny eksport audytu witryny i wielodostępowe OAuth partnerskie pojawią się w następnej kolejności.

Zdobądź klucz API Poznaj MCP

Uwierzytelnianie Bearer · 60 req/min · Ta sama warstwa danych co MCP · Bez scrapowania

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, … }

} }

Uwierzytelnij się raz. Wywołuj REST.

Wygeneruj token Bearer w panelu i przekaż go w nagłówku Authorization. Ten sam klucz działa zarówno w API REST, jak i na serwerze MCP.

Bazowy URL

https://api.seocrawl.ai/v1

Nagłówek Authorization

Authorization: Bearer sca_live_your_token_here

Zdobądź klucz 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())

Endpointy

Jedna warstwa danych, dwie powierzchnie

Każdy endpoint REST czyta z tej samej kanonicznej warstwy, co narzędzia MCP — więc Twój dashboard i Twoi agenci AI zawsze widzą identyczne liczby. Te grupy są dostępne na żywo w v1; kolejne pokrycie pojawia się na bieżąco.

Properties

Wylistuj property Search Console, do których masz dostęp. Użyj `id` każdej property w ścieżce każdego endpointu danych.

GET/v1/propertiesNa żywo

Google Search Console

Kliknięcia, wyświetlenia, CTR i średnia pozycja — wg zapytania, strony, zakresu dat i okres do okresu.

GET/v1/properties/{id}/gsc/summaryNa żywo
GET/v1/properties/{id}/gsc/compareNa żywo
GET/v1/properties/{id}/gsc/top-keywordsNa żywo
GET/v1/properties/{id}/gsc/top-pagesNa żywo
GET/v1/properties/{id}/gsc/keywords/detailNa żywo
GET/v1/properties/{id}/gsc/pages/detailNa żywo

AI Tracker

Czytaj prompty, które monitorujesz pod kątem wzmianek o marce w ChatGPT, Claude, Gemini i Perplexity.

GET/v1/properties/{id}/ai-tracker/promptsNa żywo

Zadania

Czytaj i zapisuj zadania SEO — podłącz swoją tablicę zadań do własnego stacku do zarządzania projektami.

GET/v1/properties/{id}/tasksNa żywo
POST/v1/properties/{id}/tasksNa żywo
GET/v1/properties/{id}/tasks/{ticketId}Na żywo
PATCH/v1/properties/{id}/tasks/{ticketId}Na żywo
POST/v1/properties/{id}/tasks/{ticketId}/commentsNa żywo

GA4 i indeksowanie

Ruch, źródła odesłań z AI i status indeksowania. Złącze jest gotowe; endpointy REST są wdrażane.

GET/v1/properties/{id}/ga4/summaryWkrótce
GET/v1/properties/{id}/indexation/summaryWkrótce

Site Audit

Stan crawlingu, on-page, techniczne i listy problemów — pełny zestaw danych audytu, udostępniony przez REST.

GET/v1/properties/{id}/audit/summaryWkrótce
GET/v1/properties/{id}/audit/issuesWkrótce

Dlaczego to API

Zbudowane dla produktów, nie dla scraperów

Prawdziwe API REST z uwierzytelnianiem Bearer, zakresami i limitami zapytań — dzielące jedną kanoniczną warstwę danych z MCP, więc liczby nigdy się nie rozjeżdżają.

Czyste REST, typowany JSON

Przewidywalne zasoby, standardowe czasowniki, typowane odpowiedzi JSON i błędy zgodne z RFC (401 nieuwierzytelniony, 403 scope_required, 429 z Retry-After). Bez scrapowania HTML, bez kruchych eksportów.

Jedna kanoniczna warstwa danych

Endpointy REST i narzędzia MCP to rodzeństwo nad tymi samymi dostawcami, z parzystością testowaną w CI. Twój dashboard i Twoi agenci AI zawsze widzą identyczne kliknięcia, wyświetlenia i pozycje.

Samoobsługowe klucze

Generuj i unieważniaj tokeny Bearer w panelu w kilka sekund. Ten sam klucz sca_live_ uwierzytelnia zarówno API REST, jak i serwer MCP — jedno poświadczenie, dwie powierzchnie.

Udokumentowane limity zapytań

60 zapytań na minutę i 1 000 na godzinę na token, z jasnymi odpowiedziami 429 + Retry-After. Limity REST to osobna pula od zużycia MCP — jedno nigdy nie zagłodzi drugiego.

Dostęp z zakresami

Zgrubne zakresy odczytu i zapisu bramkują każdy endpoint, egzekwowane na firewallu ze standardowymi odpowiedziami step-up. Przyznaj kluczowi tylko to, czego potrzebuje.

Wielodostępowość, wkrótce

Przepływ Google OAuth per tenant, aby partnerzy mogli podłączyć każdą z property GSC swoich klientów pod jednym kontem — ze ścisłą izolacją danych. W aktywnym rozwoju; poproś nas o wczesny dostęp.

Zacznij w 3 krokach

Od zera do pierwszego uwierzytelnionego wywołania w kilka minut.

Wygeneruj klucz

Otwórz tokeny API w swoim panelu i wygeneruj token Bearer. Skopiuj go raz — zaczyna się od `sca_live_`.

Wyślij nagłówek

Przekazuj `Authorization: Bearer sca_live_…` przy każdym żądaniu do `https://api.seocrawl.ai/v1`. Ten sam klucz działa też z serwerem MCP.

Pobieraj dane

Wywołaj `GET /v1/properties`, aby uzyskać `id` property, a następnie odpytuj `/v1/properties/{id}/…` po wydajność GSC, prompty AI Tracker lub zadania — i przekieruj JSON prosto do swojego produktu, dashboardu lub hurtowni.

Trzy sposoby dotarcia do Twoich danych

Te same liczby, inna powierzchnia — wybierz tę, która pasuje do sposobu, w jaki budujesz.

API REST

Dla produktów, dashboardów i potoków danych. Uwierzytelnianie Bearer, typowany JSON, limity zapytań. Jesteś na tej stronie.

Serwer MCP

Dla agentów AI — Claude, ChatGPT i dowolny klient MCP odpytują Twoje dane w języku naturalnym.

Poznaj MCP

Terminal i CLI

Dla skryptów i CI/CD — steruj swoimi danymi z dowolnego agenta terminalowego obsługującego MCP.

Zobacz CLI

Porównaj wszystkie integracje

Kto buduje na API

Zespoły, które chcą mieć dane SEO i o widoczności AI wewnątrz własnych systemów.

SaaS i partnerzy

Wbuduj metryki SEO na żywo w interfejs własnego produktu. Daj swoim użytkownikom dane z Search Console i o widoczności AI bez samodzielnego budowania potoków.

Agencje

Przekieruj dane każdego klienta do własnego portalu, Looker Studio lub swojej warstwy raportowej — jeden klucz, każda property, bez ręcznych eksportów.

Zespoły danych

Umieszczaj dane z GSC, o rankingach i z AI Tracker w swojej hurtowni według harmonogramu. Łącz je z przychodami i buduj modele, których potrzebują Twoje dashboardy.

Deweloperzy

Automatyzuj kontrole i alerty, synchronizuj zadania z narzędziem PM i wpinaj monitorowanie widoczności AI w aplikacje, które już wdrażasz.

Najczęściej zadawane pytania

Czy naprawdę istnieje publiczne API SEO?

Tak — API REST `/v1` z uwierzytelnianiem Bearer jest dostępne na żywo, obejmując wydajność Search Console, property, prompty AI Tracker i zadania, z pełną publiczną dokumentacją opublikowaną pod api.seocrawl.ai/docs. Szersze pokrycie (GA4, pełny eksport audytu witryny) i wielodostępowe OAuth partnerskie pojawią się w następnej kolejności. Potrzebujesz czegoś, co nie jest jeszcze dostępne? Poproś nas o wczesny dostęp.

Jak się uwierzytelniam?

Tokenem Bearer. Wygeneruj klucz `sca_live_` w swoim panelu i wysyłaj go jako `Authorization: Bearer <key>` przy każdym żądaniu. Dla własnego konta nie ma żadnego tańca OAuth — wystarczy nagłówek.

Czy to ten sam klucz co w MCP?

Tak. Ten sam token uwierzytelnia zarówno API REST, jak i serwer MCP, ponieważ oba czytają z jednej kanonicznej warstwy danych. Jedno poświadczenie, dwie powierzchnie — i identyczne liczby po obu stronach.

Jakie są limity zapytań?

60 zapytań na minutę i 1 000 na godzinę na token. Przekrocz je, a otrzymasz `429` z nagłówkiem `Retry-After`. Limity REST są śledzone oddzielnie od zużycia MCP, więc oba nigdy nie konkurują o ten sam budżet.

Czy mogę podłączyć property Search Console moich klientów?

Ten wielodostępowy przepływ partnerski — Google OAuth per tenant, dzięki któremu możesz podłączyć każdą z property GSC swoich klientów pod własnym kontem, ze ścisłą izolacją danych — jest w aktywnym rozwoju. Jeśli budujesz integrację partnerską, skontaktuj się z nami po wczesny dostęp.

Jakie dane mogę pobrać dzisiaj?

Podsumowanie Search Console i porównania okresów, najlepsze słowa kluczowe i strony, szczegół pojedynczego słowa kluczowego/strony, listę Twoich property, prompty AI Tracker oraz pełny odczyt/zapis zadań. Odzwierciedla to, co udostępnia MCP, przez REST.

Gotów, by budować na swoich danych SEO?

Wygeneruj klucz Bearer w panelu i wykonaj pierwsze wywołanie REST w kilka minut — albo porozmawiaj z nami o dostępie partnerskim i wielodostępowym.

Zdobądź klucz API Umów demo