Hoe gebruik ik de Google Search Console API?

Q: Hoe gebruik ik de Google Search Console API?

Maak een Cloud-project, schakel de API in, autoriseer met OAuth en vraag daarna prestatiegegevens, URL-inspecties en sitemaps op. Hier vind je de stappen en de quota.

Maak een project aan in de Google Cloud console, schakel de Google Search Console API in, maak OAuth 2.0-inloggegevens aan en log in met een Google-account dat toegang heeft tot de property. Daarna kun je verzoeken sturen naar vier resources: Search Analytics voor klikken, vertoningen, CTR en positie; URL Inspection voor de indexeringsstatus; Sitemaps; en Sites. API-sleutels alleen werken niet: elke aanroep heeft een OAuth-token nodig, en quota beperken hoeveel je kunt opvragen.

Wat de API wel en niet dekt

Resource	Methoden	Gebruik het voor
Search Analytics	`query`	Prestatierijen per zoekopdracht, pagina, land, apparaat, zoekweergave, datum of uur
URL Inspection	`index.inspect`	De geïndexeerde versie van één URL: dekking, laatste crawl, canonicals
Sitemaps	`list`, `get`, `submit`, `delete`	Het beheren van de sitemaps die een property heeft ingediend
Sites	`list`, `get`, `add`, `delete`	De properties in het ingelogde account

Dat is de hele API. Voor links, crawlstatistieken, het rapport Pagina-indexering en het rapport Core Web Vitals bestaat geen endpoint, dus die blijven beperkt tot de Search Console-interface. URL Inspection toont wat er in de index van Google staat, niet een live test van de pagina.

Toegang instellen

Maak in de Google Cloud console een project aan of kies een bestaand project.
Schakel de Google Search Console API in voor dat project.
Configureer het OAuth-toestemmingsscherm en maak een OAuth-client-ID aan.
Vraag een scope aan: https://www.googleapis.com/auth/webmasters.readonly om te lezen, of https://www.googleapis.com/auth/webmasters om ook sitemaps te kunnen indienen of verwijderen.
Log in met een account dat rechten heeft op de property. Voor het lezen van prestatiegegevens is minimaal leestoegang nodig; de API ziet precies wat dat account ziet.

Je eerste Search Analytics-query

POST https://www.googleapis.com/webmasters/v3/sites/sc-domain%3Aexample.com/searchAnalytics/query
Authorization: Bearer ACCESS_TOKEN
Content-Type: application/json

{
  "startDate": "2026-09-01",
  "endDate": "2026-09-30",
  "dimensions": ["query", "page"],
  "type": "web",
  "rowLimit": 25000,
  "startRow": 0
}

De site staat in het pad, URL-gecodeerd: sc-domain:example.com voor een domeinproperty, of het exacte voorvoegsel met de afsluitende schuine streep, zoals https://www.example.com/, voor een property met URL-voorvoegsel. De belangrijkste velden:

Datums zijn inclusief en in Pacific Time.
type is standaard web; de andere opties zijn image, video, news, googleNews en discover. Elk type vraagt om een eigen verzoek.
Filters staan in dimensionFilterGroups, met operators van equals en contains tot includingRegex en excludingRegex (RE2-syntaxis).
rowLimit loopt van 1 tot 25,000 (standaard 1,000); met startRow pagineer je door de rest.
dataState is standaard final; all voegt recente, nog onvolledige dagen toe en hourly_all werkt samen met de dimensie hour.

Elke rij bevat keys, clicks, impressions, ctr (0 tot 1) en position, gesorteerd op klikken, tenzij je op datum groepeert.

De limieten die bepalend zijn voor je code

50,000 rijen per dag per zoektype. Pagineer met startRow in stappen van 25,000 en stop bij een leeg antwoord. Vraag voor het maximale resultaat één dag per keer op.
Belastingquota. Groeperen of filteren op zowel pagina als zoekopdracht is het duurste verzoek, en lange datumbereiken kosten meer dan korte. Overschrijd je het kortetermijnquotum, dan vraagt Google je 15 minuten te wachten.
Aanvraagsnelheid. 1,200 query's per minuut per site en per gebruiker; 40,000 per minuut en 30,000,000 per dag per project.
Quotum voor URL Inspection. 2,000 inspecties per dag en 600 per minuut per property.
16 maanden aan historie, en gegevens zijn doorgaans twee tot drie dagen nadat de dag is afgelopen beschikbaar.
Rijen tellen niet op tot de totalen. Zeldzame zoekopdrachten worden weggelaten uit rijen op zoekopdrachtniveau, en groeperen op pagina telt vertoningen anders dan groeperen op property. Lees totalen daarom uit een verzoek zonder de dimensie query.

Veelgemaakte fouten

Als je http:// gebruikt terwijl de property https:// is, of de afsluitende schuine streep weglaat, krijg je een machtigingsfout, ook als het account wel toegang heeft.
Een URL buiten de property opvragen in URL Inspection wordt geweigerd: de URL moet onder de siteUrl vallen die je meegeeft.
Een maand gegroepeerd op zoekopdracht en pagina in één aanroep levert alleen de bovenste rijen op. Dagelijkse verzoeken leveren er meer op.

Hoe AutoPSEO helpt

Wil je liever geen OAuth en paginering onderhouden, dan maakt AutoPSEO verbinding via Google-inlog en biedt het dezelfde gegevens aan via de eigen REST API op /v1 (met een OpenAPI 3.1-document) en een MCP-server, geautoriseerd met een API-sleutel uit Account → API-sleutels. Er zijn alleen-lezen-sleutels beschikbaar, het search analytics-endpoint geeft tot 5,000 rijen per aanroep terug en de URL Inspection-tools van de app houden het Google-quotum van 2,000 per dag voor je bij. Zie MCP en API-sleutels. Wil je gegevens langer dan 16 maanden bewaren zonder zelf een pijplijn te schrijven? Lees dan hoe lang Search Console gegevens bewaart.

Bronnen: de API-referentie van Google, de Search Analytics query-methode, de gebruikslimieten, al je gegevens ophalen en de autorisatiehandleiding.