Zoekwoordposities controleren met de Google API (gids 2026)

Kort gezegd: Google publiceert geen API die live zoekwoordposities teruggeeft. De Search Console API geeft de gemiddelde positie voor zoekopdrachten waarvoor je eigen geverifieerde site al rankt, gratis en uit eerste hand, maar beperkt tot je eigen property en gemiddeld over de tijd. De Custom Search JSON API geeft resultaten uit een aangepaste zoekmachine, niet van google.com, dus de posities komen niet overeen met wat gebruikers zien. Voor echte live SERP-posities, ook van concurrenten, heb je een SERP API van een externe partij nodig. Deze gids toont de werkende code voor elke route en waar elke route tekortschiet.

Proberen om zoekwoordposities te controleren met de Google API is zo'n taak die opgelost lijkt tot je het echt probeert. Er bestaat geen endpoint rankings.get() en de twee Google-API's waar mensen eerst naar grijpen, beantwoorden elk een subtiel andere vraag dan de vraag die gesteld wordt. De documentatie van Search Console Search Analytics is de juiste plek om te beginnen, als je begrijpt wat “positie” daar betekent.

Heeft Google een officiële API voor zoekwoordrankings?

Nee. Google heeft nooit een API uitgebracht die een zoekwoord accepteert en je live positie op google.com teruggeeft. Dat is bewust: het geautomatiseerd bevragen van de pagina met zoekresultaten is volgens de voorwaarden van Google verboden, en het bedrijf heeft geen commercieel belang bij het leveren van infrastructuur voor het volgen van posities.

In plaats daarvan bestaan er drie onvolledige routes, elk met een harde grens:

Hoe haal ik zoekwoordposities op uit de Search Console API?

Bevraag het endpoint searchAnalytics met de dimensie query en lees het veld position uit. Dit zijn gegevens uit eerste hand rechtstreeks van Google, ze zijn gratis en er is geen limiet op het aantal zoekwoorden: je krijgt elke zoekopdracht waarvoor je site vertoningen kreeg.

Het werkende verzoek, in Python:

from google.oauth2 import service_account
from googleapiclient.discovery import build

creds = service_account.Credentials.from_service_account_file(
    "service-account.json",
    scopes=["https://www.googleapis.com/auth/webmasters.readonly"],
)
service = build("searchconsole", "v1", credentials=creds)

response = service.searchanalytics().query(
    siteUrl="https://example.com/",
    body={
        "startDate": "2026-07-01",
        "endDate": "2026-07-31",
        "dimensions": ["query", "page"],
        "rowLimit": 25000,
    },
).execute()

for row in response.get("rows", []):
    query, page = row["keys"]
    print(f"{row['position']:.1f}  {query}  ->  {page}")

De drie beperkingen waar mensen over struikelen

• Positie is een gemiddelde, geen rang. Een waarde van 7,4 betekent niet dat je op positie 7 staat; het betekent dat vertoningen waren verspreid over posities met een gemiddelde van 7,4, mogelijk variërend van 3 tot 15 over apparaten en locaties.
• Alleen je eigen site. Je kunt de positie van een concurrent niet zien. Search Console is van nature een API die aan één property is gekoppeld.
• Zoekwoorden zonder vertoningen zijn onzichtbaar. Als je op positie 60 staat en niemand zo ver heeft gescrolld, verschijnt de zoekopdracht helemaal niet in de data.

Dat derde punt is het punt dat de rapportage stilletjes ruïneert. Een zoekwoord waarvoor je nog niet in de eerste pagina's bent doorgebroken, bestaat simpelweg niet in Search Console, waardoor het onmogelijk is om met alleen deze API vooruitgang van positie 60 naar positie 20 te meten.

Kan ik de Custom Search JSON API gebruiken om rankings te controleren?

Technisch ja, zinvol nee. De Custom Search JSON API vereist dat je eerst een Programmable Search Engine aanmaakt. Zelfs wanneer die is ingesteld om het hele web te doorzoeken, past hij zijn eigen ranking en eigen beperkingen toe, dus de volgorde die hij teruggeeft is niet de volgorde van google.com.

Bovendien is hij in de gratis versie beperkt tot 100 zoekopdrachten per dag, met betaald gebruik dat per duizend zoekopdrachten wordt gefactureerd en een dagelijks maximum. Voor een handvol zoekwoorden die je af en toe controleert, is het werkbaar. Als rank tracker levert hij getallen op die gezaghebbend lijken en stilletjes onjuist zijn, wat erger is dan geen data hebben.

En Google rechtstreeks scrapen?

Doe het niet. Het geautomatiseerd bevragen van Google Search zonder toestemming is in strijd met de Servicevoorwaarden van Google en leidt bij elk volume tot IP-blokkades en CAPTCHA-muren. Naast de vraag van het beleid is de technische realiteit onaangenaam: resultaten zijn gepersonaliseerd, gelokaliseerd en steeds vaker opgebouwd met AI-functies, dus een gescrapete “positie” verschilt per datacenter, locatie en sessie, ook als er niets aan je site is veranderd.

Heb je de posities van concurrenten nodig, dan is een commerciële SERP API de route die zowel legaal is volgens de eigen overeenkomsten van de aanbieder als technisch stabiel. Het is een betaalde kostenpost, en die kosten zijn de eerlijke prijs van data die Google niet weggeeft. Bedrijven die deze pijplijn willen laten bouwen en bewaken zonder iemand in dienst te nemen, schakelen doorgaans een specialist in; onze vergelijking van de 10 beste bureaus voor data-analyse in Frankrijk noemt aanbieders die dit soort rapportage opzetten.

Wat moet je eigenlijk bouwen?

Voor de meeste teams is een hybride architectuur de pragmatische keuze, en die ziet er zo uit:

• De Search Console API als ruggengraat. Gratis, onbeperkt aantal zoekwoorden, uit eerste hand, en de enige bron die je vertelt waarvoor je echt vertoningen krijgt.
• Een SERP API voor een kleine, zorgvuldig gekozen set zoekwoorden. Je twintig of dertig commercieel cruciale termen, dagelijks gecontroleerd, inclusief de posities van concurrenten.
• Een laag voor zichtbaarheid in AI. De vraag is steeds vaker niet alleen “welke positie heb ik” maar “word ik geciteerd als iemand het een assistent vraagt”. Klassieke rank-API's beantwoorden daar niets van.

Teams die dit liever niet zelf ontwerpen, geven het doorgaans aan een specialist; onze vergelijking van de 10 beste seo-bureaus in Frankrijk beschrijft aanbieders die deze rapportagestack voor klanten beheren.

Dat laatste punt is geen zorg voor later. Wanneer een antwoord van AI de vraag in de interface oplost, komen positie tien en positie drie uit op hetzelfde resultaat: geen klik. Citaten naast posities volgen is wat onze MCP-server voor Search Console en ons platform voor zichtbaarheid in AI doen, en de documentatie beschrijft de installatie van begin tot eind.

Conclusie

Er is geen officiële Google API voor live zoekwoordposities: gebruik de Search Console API voor je eigen gemiddelde data, een SERP API van een externe partij voor exacte posities en posities van concurrenten, en laat de Custom Search JSON API voor rankingwerk volledig links liggen. Op de verkeerde bouwen is hier de meest gemaakte fout en levert een dashboard op dat met veel overtuiging onjuist is.

Wil je die pijplijn liever niet zelf bouwen en onderhouden, dan koppelt Sorank je Search Console en volgt citaten in AI op één plek.