Search Console API · REST v1 · Live docs

Google Search Console API voor je eigen stack

Je Search Console-prestatiedata, via een schoon REST-endpoint.

Haal kliks, vertoningen, CTR en gemiddelde positie — per zoekopdracht, pagina en datumbereik — rechtstreeks uit Google Search Console naar je product, dashboard of data warehouse. Koppel GSC één keer in SEOcrawl AI, maak een Bearer-sleutel aan vanuit je dashboard en roep REST /v1 aan — zonder zelf Google-OAuth te bouwen. Het is dezelfde canonieke datalaag die de MCP van SEOcrawl AI aandrijft, dus je cijfers kloppen altijd met elkaar. Indexdekking en URL-inspectie komen hierna naar REST; via de MCP zijn ze al live.

Claude
Codex CLI
Cursor
Google Search Console API van SEOcrawl AI — een curl-request en de getypte JSON-respons met kliks, vertoningen, CTR en positie.
Voorbeeldrequests voor de Google Search Console API in cURL, JavaScript en Python.

Bepaal je property. Haal je GSC-data op.

Maak een Bearer-token aan vanuit je dashboard en geef het mee in de Authorization-header. Bepaal één keer de id van je Search Console-property en bevraag daarna de prestaties via REST. Dezelfde sleutel werkt op de REST-API én op de MCP-server.

Basis-URL

https://api.seocrawl.ai/v1

Authorization-header

Authorization: Bearer sca_live_your_token_here

Elke Search Console-metric, via REST

Kliks, vertoningen, CTR en gemiddelde positie — per zoekopdracht, pagina, datumbereik en periode-op-periode. Elk endpoint hangt aan een property: bepaal eerst de id van de property en lees daarna de Search Console-data. Deze GSC-groepen zijn live in v1; indexdekking en URL-inspectie zitten vandaag in de MCP en landen hierna op REST.

Properties

Toon de Search Console-properties die aan je account gekoppeld zijn. Gebruik de id van elke property in het pad van elk GSC-endpoint.

  • GET/v1/propertiesLive

Prestaties

Totale kliks, vertoningen, CTR en gemiddelde positie voor een datumbereik — plus het verschil met de vorige periode voor datzelfde venster.

  • GET/v1/properties/{id}/gsc/summaryLive
  • GET/v1/properties/{id}/gsc/compareLive

Zoekopdrachten

De zoekopdrachten waarop je scoort, met metrics per zoekopdracht — en de volledige daggeschiedenis van elk afzonderlijk keyword.

  • GET/v1/properties/{id}/gsc/top-keywordsLive
  • GET/v1/properties/{id}/gsc/keywords/detailLive

Pagina's

Je best presterende URL's met hun Search Console-metrics — en de volledige dagelijkse uitsplitsing van elke afzonderlijke pagina.

  • GET/v1/properties/{id}/gsc/top-pagesLive
  • GET/v1/properties/{id}/gsc/pages/detailLive

Indexdekking

Wat Google echt indexeert: dekkingsstatussen en indexatiegeschiedenis. Vandaag beschikbaar in de MCP; de REST-endpoints worden uitgerold.

  • GET/v1/properties/{id}/indexation/summaryBinnenkort

URL-inspectie

Inspectie per URL — dekking, laatste crawl en indexeringsstatus van één pagina. Nu al beschikbaar via de MCP; REST volgt.

  • GET/v1/properties/{id}/url-inspectionBinnenkort

Echte Search Console-data, gebouwd voor producten

Je werkelijke prestaties in Google Search Console — geen schattingen van derden — via een schone REST-API met Bearer-auth en rate limits, op één canonieke datalaag samen met de MCP zodat de cijfers elkaar nooit tegenspreken.

Rechtstreeks uit Search Console

Kliks, vertoningen, CTR en gemiddelde positie uit je eigen GSC-property — de echte cijfers die Google rapporteert, geen gemodelleerde of gescrapete schattingen. Voorspelbare resources, standaardwerkwoorden, getypte JSON en RFC-conforme fouten.

Geen Google-OAuth te bouwen

Koppel Search Console één keer in SEOcrawl AI en lees het daarna uit met één sca_live_ Bearer-sleutel. Geen Google Cloud-project, geen toestemmingsscherm, geen token-refresh — sleutels maak en trek je in seconden in vanuit je dashboard.

Eén canonieke datalaag

De REST-GSC-endpoints en de GSC-tools van de MCP zijn broers en zussen boven dezelfde provider, met pariteit getest in CI. Je dashboard en je AI-agents zien altijd identieke kliks, vertoningen en posities.

Granulair per zoekopdracht en pagina

Lees de totalen van een property of duik het detail in: topzoekopdrachten, toppagina's, de dagtrend van één keyword of de geschiedenis van één URL — dezelfde dimensies die je in Search Console ziet, adresseerbaar via HTTP.

Periodevergelijking ingebouwd

Vraag een range (last_7_days, last_28_days, last_3_months, last_year) of expliciete from/to-datums op en krijg de periodevergelijking er meteen bij — geen tweede call en geen datumrekenwerk in de client om verschillen kloppend te krijgen.

Gedocumenteerde rate limits

60 requests per minuut en 1.000 per uur per token, met duidelijke 429-responses plus Retry-After. De REST-limieten zijn een aparte pot, los van je MCP-verbruik — de een legt de ander nooit droog.

Begin in 3 stappen

Van nul naar je eerste Search Console-call in een paar minuten.

1

Maak een sleutel aan

Koppel Search Console in SEOcrawl AI, open API-tokens en genereer een Bearer-token. Kopieer het meteen — het begint met sca_live_.

2

Bepaal je property

Roep GET /v1/properties aan met Authorization: Bearer sca_live_… om de id (een UUID) op te halen van de Search Console-property die je wilt uitlezen.

3

Haal je GSC-data op

Roep /v1/properties/{id}/gsc/summary?range=last_28_days aan voor de totalen, of /gsc/top-keywords, /gsc/top-pages en de /detail-endpoints — en stuur de JSON rechtstreeks je product, dashboard of warehouse in.

Drie manieren om bij je Search Console-data te komen

Dezelfde GSC-cijfers, een ander oppervlak — kies wat past bij hoe je bouwt.

REST-API

Voor producten, dashboards en datapipelines. Bearer-auth, getypte JSON, rate limits. Je bent er nu — de volledige SEO-API voegt met dezelfde sleutel ranking- en AI-zichtbaarheidsendpoints toe.

MCP-server

Voor AI-agents — Claude, ChatGPT en elke MCP-client bevragen je Search Console-data in natuurlijke taal.

Verken de MCP

Terminal & CLI

Voor scripts en CI/CD — bestuur je GSC-data vanuit elke MCP-compatibele terminalagent.

Bekijk de CLI

Wie er bouwt op de Search Console API

Teams die echte GSC-prestatiedata in hun eigen systemen willen.

Bureaus

Pomp de Search Console-data van elke klant naar een eigen portaal, naar Looker Studio of naar je rapportagelaag — één sleutel, alle properties, geen handmatige GSC-exports.

SaaS & partners

Bouw live Search Console-metrics in je eigen productinterface in. Geef je gebruikers kliks, vertoningen en posities zonder zelf Googles API te bedraden.

Datateams

Land GSC-kliks, -vertoningen, -CTR en -positie volgens schema in je warehouse. Koppel ze aan omzet en bouw de modellen die je dashboards nodig hebben.

Ontwikkelaars

Automatiseer de monitoring van zoekopdrachten en pagina's, sla alarm bij posities die wegzakken en knoop Search Console-data aan de apps en workflows die je toch al draait.

Veelgestelde vragen

Is dit de officiële Search Console API van Google?

Nee. Dit is de eigen, Bearer-geauthenticeerde REST-API van SEOcrawl AI op de Search Console-data die je al aan je account hebt gekoppeld. Je koppelt GSC één keer in SEOcrawl AI en leest daarna kliks, vertoningen, CTR en positie uit met één sca_live_-sleutel — zonder zelf een Google Cloud-project, een OAuth-toestemmingsscherm of token-refresh te bouwen. De cijfers zijn je echte Search Console-cijfers; de API en de authenticatie zijn van ons.

Welke Search Console-data kan ik vandaag ophalen?

Totalen voor een datumbereik (kliks, vertoningen, CTR, gemiddelde positie), periodevergelijkingen, je topzoekopdrachten en toppagina's met metrics, en het volledige dagelijkse detail van één keyword of één pagina — plus de lijst met je gekoppelde properties. Indexdekking en live URL-inspectie zijn nu al beschikbaar via de MCP; hun REST-endpoints volgen hierna. Wil je het account liever lezen dan bevragen, dan dekt de Google Search Console-audit dezelfde data in één prompt.

Hoe authenticeer ik?

Met een Bearer-token. Maak een sca_live_-sleutel aan vanuit je dashboard en stuur hem mee als Authorization: Bearer <sleutel> bij elk request. Voor je eigen account is er geen OAuth-dans — alleen de header.

Welke datumbereiken worden ondersteund?

Elk GSC-endpoint accepteert óf een range (last_7_days, last_28_days, last_3_months of last_year) óf een expliciet from/to-paar. Het endpoint gsc/compare geeft datzelfde venster terug vergeleken met de voorgaande periode, dus je krijgt de verschillen zonder tweede call.

Wat zijn de rate limits?

60 requests per minuut en 1.000 per uur per token. Ga je eroverheen, dan krijg je een 429 met een Retry-After-header. De REST-limieten worden apart van je MCP-verbruik geteld, dus de twee concurreren nooit om hetzelfde budget.

Is het dezelfde sleutel en dezelfde data als bij de MCP?

Ja. Hetzelfde sca_live_-token authenticeert zowel de REST-API als de MCP-server, en allebei lezen ze uit één canonieke datalaag — de Search Console-cijfers die je via REST ophaalt zijn dus identiek aan wat je AI-agents via de MCP zien. Eén credential, twee oppervlakken.

Klaar om op je Search Console-data te bouwen?

Koppel GSC één keer, maak een Bearer-sleutel aan vanuit je dashboard en doe binnen enkele minuten je eerste Search Console-REST-call — of verken de MCP voor AI-agents.