Search Console API: data ophalen en SEO-rapportage automatiseren

Met de Search Console API haal je gegevens uit Google Search Console automatisch op voor SEO-rapportages, dashboards en controles. Je koppelt een Google Cloud-project aan een Search Console-property, autoriseert toegang met OAuth en vraagt vervolgens data op, bijvoorbeeld per dag, zoekopdracht, pagina, apparaat of land. De API is vooral nuttig zodra handmatige exports tijd kosten of je data structureel wilt combineren met andere bronnen.

Wat is de Search Console API?

De Search Console API is de programmeerbare toegang tot gegevens uit Google Search Console. In plaats van gegevens handmatig te exporteren, kan een script, dashboard of eigen applicatie op vaste momenten data opvragen.

De belangrijkste toepassing is de Search Analytics-query. Daarmee vraag je prestatiegegevens op, zoals klikken, vertoningen, CTR en gemiddelde positie. Je kunt de resultaten uitsplitsen met dimensies, waaronder datum, query, pagina, land, apparaat en zoektype.

Daarnaast biedt de API functies voor propertytoegang, sitemaps en URL-inspectie. Zie de API daarom niet als vervanging van SEO-analyse, maar als een betrouwbare technische laag onder terugkerende rapportage en monitoring.

Wanneer is de Search Console API geschikt?

Voor een eenmalige analyse is een export vanuit Search Console meestal sneller. De API wordt interessant wanneer je dezelfde data terugkerend nodig hebt, de gegevens wilt combineren of afwijkingen automatisch wilt signaleren.

Situatie	Beste keuze	Praktische actie
Je wilt eenmalig prestaties van een pagina of periode bekijken	Handmatige export uit Search Console	Exporteer de tabel en analyseer de belangrijkste pagina's en zoekopdrachten.
Je wilt maandelijks hetzelfde SEO-overzicht maken	Search Console API	Plan een dagelijkse of periodieke query en voed daarmee je rapportagebestand of dashboard.
Je wilt data combineren met leads, omzet of CRM-status	Search Console API plus eigen datakoppeling	Koppel zoekprestaties op paginaniveau aan je eigen meet- en conversiedata.
Je wilt historische data op grote schaal analyseren met SQL	BigQuery-bulkexport	Onderzoek of de doorlopende export naar BigQuery past bij je technische inrichting en kostenstructuur.
Je wilt indexeringsproblemen onderzoeken	Search Console-interface en URL-inspectie	Controleer individuele URL's en combineer dit met de aanpak voor 404- en soft-404-fouten.

Welke data kun je ophalen?

Search Analytics

Dit is het meest gebruikte onderdeel. Je vraagt prestatiegegevens op voor een gekozen periode en uitsplitsing. Voorbeelden zijn dagelijkse klikken per pagina, zoekopdrachten per apparaat of prestaties per land.

Sitemaps

Je kunt sitemapgegevens opvragen en beheren voor properties waarvoor je de juiste rechten hebt. Dit is nuttig wanneer je technische controles wilt opnemen in een vaste beheerworkflow.

URL-inspectie

Met URL-inspectie controleer je de status van een specifieke URL. Gebruik dit voor gerichte technische controles, niet als vervanging voor een brede analyse van je indexeringsrapport.

Search Console API instellen: stappenplan

1. Controleer de property en je toegang. Gebruik een Google-account met passende toegang tot de Search Console-property. Kies exact de property die je wilt rapporteren, bijvoorbeeld een domeinproperty of URL-prefixproperty.
2. Maak een project in Google Cloud. Dit project vormt de technische omgeving voor je koppeling en autorisatie.
3. Activeer de Search Console API. Zoek in de API-bibliotheek van je Cloud-project naar de Search Console API en schakel deze in.
4. Richt OAuth in. Maak OAuth-inloggegevens en bepaal welke toepassing de autorisatie uitvoert. OAuth zorgt ervoor dat de koppeling alleen data kan opvragen waarvoor de geautoriseerde gebruiker toegang heeft.
5. Vraag een toegangstoken aan. Doorloop de autorisatiestroom met het Google-account dat toegang heeft tot de property. Bewaar tokens veilig en geef ze nooit mee in publieke code of documenten.
6. Voer een eerste Search Analytics-query uit. Begin klein: vraag data op voor een korte, afgeronde periode en één dimensie, bijvoorbeeld datum.
7. Controleer de uitkomst in de interface. Vergelijk richting en totalen met Search Console, maar verwacht niet dat iedere uitsplitsing identiek of volledig is. Raadpleeg altijd de gekozen dimensies, filters en datastatus.
8. Automatiseer pas na validatie. Sla de resultaten op in een spreadsheet, database of dataplatform en plan de taak pas daarna in.

Een eerste Search Analytics-query

Een query bestaat uit een property, een start- en einddatum, eventuele dimensies en filters. Dit voorbeeld vraagt dagelijkse webzoekdata op. Vervang de property door de exacte notatie van jouw Search Console-property.

{
  "startDate": "2025-01-01",
  "endDate": "2025-01-31",
  "dimensions": ["date"],
  "type": "web",
  "rowLimit": 25000
}

De response bevat rijen met een sleutel voor de gekozen dimensie en statistieken zoals klikken, vertoningen, CTR en positie. Voeg niet meteen alle dimensies toe. Elke extra uitsplitsing vergroot het aantal mogelijke rijen en maakt controle lastiger.

Belangrijke parameters en keuzes

• startDate en endDate: kies een afgesloten periode als je stabiele rapportages wilt. Recente data kan nog veranderen.
• dimensions: bepaal de uitsplitsing, zoals date, page, query, device of country.
• dimensionFilterGroups: beperk resultaten, bijvoorbeeld tot één pagina, land of apparaat.
• type: specificeer het zoektype dat je wilt analyseren.
• aggregationType: kies bewust hoe Google de resultaten moet samenvoegen.
• rowLimit en startRow: gebruik deze voor het ophalen van grotere resultaatsets in delen.
• dataState: bepaal of je uitsluitend definitieve data gebruikt of ook recente data wilt meenemen. Lees de actuele documentatie voordat je dit voor besluitvorming inzet.

Python-voorbeeld: dagelijkse data ophalen

Onderstaand voorbeeld laat de kern van een Search Analytics-aanroep zien. De authenticatie is bewust niet opgenomen: richt OAuth eerst veilig in volgens de Google-documentatie. Installeer en beheer benodigde bibliotheken binnen je eigen ontwikkelomgeving.

from googleapiclient.discovery import build

service = build("searchconsole", "v1", credentials=credentials)
property_url = "sc-domain:voorbeeld.nl"

body = {
    "startDate": "2025-01-01",
    "endDate": "2025-01-31",
    "dimensions": ["date", "page"],
    "type": "web",
    "rowLimit": 25000,
    "startRow": 0
}

response = service.searchanalytics().query(
    siteUrl=property_url,
    body=body
).execute()

for row in response.get("rows", []):
    print(row["keys"], row["clicks"], row["impressions"], row["ctr"], row["position"])

Wil je ook zoekopdrachten meenemen? Voeg dan query toe aan dimensions. Houd er rekening mee dat uitsplitsingen met query's gevoelig zijn voor onvolledige rijen en privacybeperkingen. Gebruik zulke data daarom als analysemateriaal, niet als absoluut totaalbeeld.

Paginering, limieten en datakwaliteit

De API retourneert resultaten in rijen. Voor uitgebreide datasets moet je meerdere verzoeken uitvoeren met startRow en de resultaten samenvoegen. Google documenteert voor Search Analytics een limiet van maximaal 50.000 rijen per dag en zoektype bij het ophalen van alle prestatiegegevens. Daarnaast gelden quota voor API-verzoeken.

Een goed script stopt daarom niet na één response. Laat het herhalen totdat een batch geen rijen meer oplevert, log fouten en bewaar wanneer de gegevens zijn opgehaald. Ontwerp je rapportage bovendien zo dat een tijdelijke mislukte run geen bestaande, gecontroleerde data overschrijft.

Let ook op deze datakwaliteitsprincipes:

• Recente gegevens kunnen nog niet volledig beschikbaar zijn of veranderen.
• Rijen met lage volumes of privacygevoelige combinaties zijn niet altijd beschikbaar.
• Een optelling van gedetailleerde rijen hoeft niet gelijk te zijn aan een totaal zonder dimensies.
• De API levert voornamelijk de best presterende rijen terug. Trek daarom geen harde conclusies over alle longtailzoekopdrachten.
• Vergelijk altijd dezelfde property, periode, zoektype en filters als je API-resultaten controleert tegen de interface.

Praktische automatiseringen voor mkb-bedrijven

Begin niet met een groot dashboard, maar met één vraag die je periodiek wilt beantwoorden. Bijvoorbeeld: welke belangrijke dienstenpagina's verliezen organische zichtbaarheid, welke pagina's krijgen meer vertoningen maar minder klikken, of welke content verdient een update?

• Maak een weekoverzicht van klikken en vertoningen per belangrijke landingspagina.
• Signaleer pagina's waarvan zichtbaarheid verandert en plan een inhoudelijke controle.
• Combineer paginadata met formulier- of leadgegevens uit je eigen meetomgeving.
• Leg SEO-signalen naast betaalde zoekcampagnes om kansen in zoekintentie en landingspagina's te herkennen. Voor de betaalde kant kun je terecht bij onze Google Ads SEA-campagnes.
• Gebruik een vaste dataset voor managementrapportage, zodat definities en periodes consistent blijven.

De API toont zoekprestaties, maar geen bedrijfsresultaat op zichzelf. Koppel rapportage daarom aan duidelijke website- en marketingdoelen. LYNX helpt bedrijven met de samenhang tussen website, SEO, SEA en conversieoptimalisatie via onze diensten voor online groei.

Veelgemaakte fouten

• De verkeerde property gebruiken: een domeinproperty en URL-prefixproperty kunnen een andere scope hebben.
• Een onvolledige API-response als totaal beschouwen: controleer dimensies, row limits, filters en paginering.
• Te recente data rapporteren als definitief: hanteer een vaste verwerkingstijd voordat je conclusies trekt.
• Tokens of client secrets onveilig opslaan: gebruik beveiligd configuratiebeheer en beperk toegang.
• SEO-data verwarren met conversiedata: Search Console laat zoekprestaties zien. Voor zakelijke waarde heb je aanvullende analytics- en CRM-data nodig.
• Automatiseren zonder controle: valideer eerst de query en leg vast welke definities het dashboard gebruikt.

Conclusie

De Search Console API is de juiste keuze als je Search Console-data terugkerend, reproduceerbaar en geautomatiseerd wilt gebruiken. Start met een beperkte query, controleer de resultaten in de interface en breid daarna uit naar periodieke rapportage. Kies BigQuery-bulkexport wanneer je structureel grote hoeveelheden historische data met SQL wilt analyseren. Kies een handmatige export wanneer de vraag eenmalig en overzichtelijk is.

Wil je van zoekdata naar een meetbare aanpak voor je website en campagnes? Bespreek je website of online groeikansen met LYNX Media.