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.

Claude
Codex CLI
Cursor
SEOcrawl AI REST API — curl request and typed JSON response
SEOcrawl AI REST API examples in cURL, JavaScript and Python

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

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. Wszystkie szczegóły na dedykowanej stronie API Google Search Console.

  • 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

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.

1

Wygeneruj klucz

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

2

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.

3

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

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.