API Search Console · REST v1 · Dokumentacja na żywo

API Google Search Console dla Twojego własnego stacku

Dane o wydajności z Twojego Search Console przez czysty endpoint REST.

Pobieraj kliknięcia, wyświetlenia, CTR i średnią pozycję — wg zapytania, strony i zakresu dat — prosto z Google Search Console do swojego produktu, dashboardu lub hurtowni danych. Podłącz GSC raz wewnątrz SEOcrawl AI, wygeneruj klucz Bearer w panelu i wywołuj REST /v1 — bez budowania własnego OAuth Google. To ta sama kanoniczna warstwa danych, która zasila MCP SEOcrawl AI, więc Twoje liczby zawsze się zgadzają. Pokrycie indeksowania i inspekcja URL trafią do REST w następnej kolejności; przez MCP są już dostępne.

Zdobądź klucz APIZobacz dokumentację APIPoznaj MCP
Claude
Codex CLI
Cursor
API Google Search Console od SEOcrawl AI — żądanie curl i typowana odpowiedź JSON z kliknięciami, wyświetleniami, CTR i pozycją.
Przykłady żądań do API Google Search Console w cURL, JavaScript i Python.

Ustal property. Pobieraj dane z GSC.

Wygeneruj token Bearer w panelu i przekaż go w nagłówku Authorization. Raz ustal id property Search Console, a potem odpytuj jej wydajność przez REST. 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 APIRead the API docs

Wszystkie metryki Search Console, przez REST

Kliknięcia, wyświetlenia, CTR i średnia pozycja — wg zapytania, strony, zakresu dat i okres do okresu. Każdy endpoint jest powiązany z property: najpierw ustal jej id, a potem czytaj dane z Search Console. Te grupy GSC są dostępne na żywo w v1; pokrycie indeksowania i inspekcja URL są dziś w MCP, a do REST trafią w następnej kolejności.

Property

Wylistuj property Search Console podłączone do Twojego konta. Użyj id każdej property w ścieżce każdego endpointu GSC.

  • GET/v1/propertiesNa żywo

Wydajność

Łączne kliknięcia, wyświetlenia, CTR i średnia pozycja dla zakresu dat — plus różnica względem poprzedniego okresu dla tego samego okna.

  • GET/v1/properties/{id}/gsc/summaryNa żywo
  • GET/v1/properties/{id}/gsc/compareNa żywo

Zapytania

Zapytania, na które się wyświetlasz, z metrykami dla każdego z nich — oraz pełna dzienna historia dowolnego słowa kluczowego.

  • GET/v1/properties/{id}/gsc/top-keywordsNa żywo
  • GET/v1/properties/{id}/gsc/keywords/detailNa żywo

Strony

Twoje najskuteczniejsze adresy URL wraz z metrykami Search Console — oraz pełny dzienny rozkład wydajności dowolnej strony.

  • GET/v1/properties/{id}/gsc/top-pagesNa żywo
  • GET/v1/properties/{id}/gsc/pages/detailNa żywo

Pokrycie indeksowania

To, co Google naprawdę indeksuje: stany pokrycia i historia indeksowania. Dziś dostępne w MCP; endpointy REST są w trakcie wdrażania.

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

Inspekcja URL

Inspekcja pojedynczego adresu URL — pokrycie, ostatnie crawlowanie i stan indeksowania jednej strony. Już dostępna przez MCP; REST w następnej kolejności.

  • GET/v1/properties/{id}/url-inspectionWkrótce

Prawdziwe dane Search Console, stworzone dla produktów

Twoja rzeczywista wydajność w Google Search Console — a nie szacunki firm trzecich — przez czyste API REST z uwierzytelnianiem Bearer i limitami zapytań, dzielące jedną kanoniczną warstwę danych z MCP, więc liczby nigdy się nie rozjeżdżają.

Prosto z Search Console

Kliknięcia, wyświetlenia, CTR i średnia pozycja pobierane z Twojej własnej property GSC — prawdziwe liczby, które raportuje Google, a nie modelowane czy scrapowane szacunki. Przewidywalne zasoby, standardowe czasowniki, typowany JSON i błędy zgodne z RFC.

Bez budowania OAuth Google

Podłącz Search Console raz wewnątrz SEOcrawl AI i czytaj je jednym kluczem Bearer sca_live_. Pomiń projekt w Google Cloud, ekran zgody i odświeżanie tokenów — generuj i unieważniaj klucze w panelu w kilka sekund.

Jedna kanoniczna warstwa danych

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

Granularność zapytań i stron

Czytaj sumy dla całej property albo zejdź niżej: najlepsze zapytania, najlepsze strony, dzienny trend jednego słowa kluczowego czy historia jednego adresu URL — te same wymiary, które widzisz w Search Console, dostępne po HTTP.

Porównanie okresów w standardzie

Poproś o zakres (last_7_days, last_28_days, last_3_months, last_year) albo o jawne daty from/to i od razu dostajesz porównanie okresów — bez drugiego wywołania i bez liczenia dat po stronie klienta, żeby uzgodnić różnice.

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.

Zacznij w 3 krokach

Od zera do pierwszego wywołania Search Console w kilka minut.

1

Wygeneruj klucz

Podłącz Search Console w SEOcrawl AI, otwórz tokeny API i wygeneruj token Bearer. Skopiuj go raz — zaczyna się od sca_live_.

2

Ustal property

Wywołaj GET /v1/properties z Authorization: Bearer sca_live_…, aby uzyskać id (UUID) property Search Console, którą chcesz czytać.

3

Pobieraj dane z GSC

Uderz w /v1/properties/{id}/gsc/summary?range=last_28_days po sumy albo w /gsc/top-keywords, /gsc/top-pages i endpointy /detail — i przekieruj JSON prosto do swojego produktu, dashboardu lub hurtowni.

Trzy sposoby dotarcia do Twoich danych z Search Console

Te same liczby z GSC, 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 — pełne API SEO dodaje na tym samym kluczu endpointy o rankingach i widoczności w AI.

Serwer MCP

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

Poznaj MCP

Terminal i CLI

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

Zobacz CLI
Porównaj wszystkie integracje

Kto buduje na API Search Console

Zespoły, które chcą mieć prawdziwe dane o wydajności z GSC we własnych systemach.

Agencje

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

SaaS i partnerzy

Wbuduj metryki Search Console na żywo w interfejs własnego produktu. Daj swoim użytkownikom kliknięcia, wyświetlenia i pozycje bez samodzielnego podpinania API Google.

Zespoły danych

Umieszczaj kliknięcia, wyświetlenia, CTR i pozycję z GSC w swojej hurtowni według harmonogramu. Łącz je z przychodami i buduj modele, których potrzebują Twoje dashboardy.

Deweloperzy

Automatyzuj monitorowanie zapytań i stron, ustaw alerty na spadki pozycji i wpinaj dane z Search Console w aplikacje oraz procesy, które już wdrażasz.

Najczęściej zadawane pytania

Czy to oficjalne API Search Console od Google?

Nie. To własne API REST SEOcrawl AI z uwierzytelnianiem Bearer, działające na danych Search Console, które już podłączyłeś do swojego konta. Podłączasz GSC raz wewnątrz SEOcrawl AI, a potem czytasz kliknięcia, wyświetlenia, CTR i pozycję jednym czystym kluczem sca_live_ — bez budowania projektu w Google Cloud, ekranu zgody OAuth czy odświeżania tokenów. Liczby to Twoje prawdziwe liczby z Search Console; API i uwierzytelnianie są nasze.

Jakie dane z Search Console mogę pobrać dzisiaj?

Sumy dla zakresu dat (kliknięcia, wyświetlenia, CTR, średnia pozycja), porównania okresów, Twoje najlepsze zapytania i strony z metrykami oraz pełny dzienny szczegół jednego słowa kluczowego lub jednej strony — plus listę Twoich podłączonych property. Pokrycie indeksowania i inspekcja URL na żywo są już dostępne przez MCP; ich endpointy REST pojawią się w następnej kolejności. A jeśli wolisz przeczytać konto, zamiast je odpytywać, audyt Google Search Console obejmuje te same dane w jednym prompcie.

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.

Jakie zakresy dat są obsługiwane?

Każdy endpoint GSC przyjmuje albo range (last_7_days, last_28_days, last_3_months lub last_year), albo jawną parę from/to. Endpoint gsc/compare zwraca to samo okno porównane z poprzednim okresem, więc różnice dostajesz bez drugiego wywołania.

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 to ten sam klucz i te same dane co w MCP?

Tak. Ten sam token sca_live_ uwierzytelnia zarówno API REST, jak i serwer MCP, a oba czytają z jednej kanonicznej warstwy danych — więc liczby z Search Console, które pobierasz przez REST, są identyczne z tym, co widzą Twoi agenci AI przez MCP. Jedno poświadczenie, dwie powierzchnie.

Gotów budować na swoich danych z Search Console?

Podłącz GSC raz, wygeneruj klucz Bearer w panelu i wykonaj pierwsze wywołanie REST do Search Console w kilka minut — albo poznaj MCP dla agentów AI.

Zdobądź klucz APIZobacz dokumentację APIUmów demo