Waarom de GEO-Score API gebruiken?
Hoewel het GEO-Score-dashboard krachtig is voor handmatige analyse, ontgrendelt de API automatisering op schaal. Integreer GEO-analyse direct in je content-managementsysteem, CI/CD-pijplijn of aangepaste rapportagetools om de zichtbaarheid in AI-zoekmachines voor je hele website automatisch te monitoren.
Of je nu een solo-developer bent die je eigen workflow automatiseert of een bureau dat honderden klantsites beheert: de API biedt je programmatische toegang tot elke functie die in het dashboard beschikbaar is en meer.
API-overzicht
De GEO-Score API volgt RESTful-conventies met JSON-request- en response-bodies. Alle endpoints vereisen authenticatie via een API-sleutel en retourneren consistente responsestructuren.
Base URL
Responseformaat
Alle API-responses volgen een consistente JSON-structuur met statuscodes en geneste data-objecten:
Authenticatie
Elke API-aanvraag moet je API-sleutel bevatten in de Authorization-header. API-sleutels zijn gekoppeld aan je account en kunnen worden beheerd vanuit je dashboard-instellingen.
Je API-sleutel ophalen
Ga naar Dashboard > Instellingen > API-sleutels om een nieuwe sleutel te genereren. Je kunt meerdere sleutels aanmaken met verschillende permissies voor verschillende integraties. Elke sleutel kan individueel worden ingetrokken zonder andere te beïnvloeden.
Je API-sleutel gebruiken
Voeg je API-sleutel toe als Bearer-token in de Authorization-header van elke aanvraag:
Beschikbare endpoints
De GEO-Score API biedt endpoints voor het indienen van URL's voor analyse, ophalen van resultaten, triggeren van her-analyses en het vergelijken van meerdere URL's. Hier is een overzicht van alle beschikbare endpoints:
Haal een gepagineerde lijst op van alle geanalyseerde URL's in je account.
Haal de volledige analyseresultaten op voor een specifieke URL via zijn unieke ID.
Dien een nieuwe URL in voor GEO-analyse. Retourneert de analyse-ID om resultaten te pollen.
Trigger een nieuwe analyse van een eerder geanalyseerde URL.
Vergelijk GEO-scores en factor-breakdowns voor meerdere URL's naast elkaar.
Codevoorbeelden
Ga snel aan de slag met deze kant-en-klare codevoorbeelden in populaire programmeertalen. Kopieer, plak en pas aan voor je specifieke use-case.
JavaScript (Node.js)
Python
PHP
Webhooks
Met webhooks kan GEO-Score realtime notificaties naar je server pushen zodra belangrijke events plaatsvinden. In plaats van de API te pollen voor updates, configureer je een webhook-URL en ontvang je directe callbacks.
Webhooks instellen
Configureer je webhook-endpoint in Dashboard > Instellingen > Webhooks. Je kunt selecteren welke events notificaties triggeren en een aangepaste signing secret instellen voor payload-verificatie.
analysis.complete
Wordt geactiveerd wanneer een URL-analyse klaar is met verwerken en resultaten beschikbaar zijn.
score.changed
Wordt geactiveerd wanneer een opnieuw geanalyseerde URL een significante verandering in GEO-Score laat zien (delta > 5 punten).
report.generated
Wordt geactiveerd wanneer een gepland of on-demand rapport klaar is om te downloaden.
url.added
Wordt geactiveerd wanneer een nieuwe URL aan je account wordt toegevoegd voor tracking.
Voorbeeld webhook-payload
Automatiseringsideeën
Analyseer automatisch elke nieuwe blogpost in je CMS voordat deze live gaat
Stel Slack-notificaties in wanneer een gevolgde URL onder een GEO-Score-drempel zakt
Genereer wekelijkse PDF-rapporten en e-mail ze naar je klanten of stakeholders
Bouw een aangepast dashboard dat GEO-Score-data combineert met je analyticsplatform
Trigger een her-analyse na content-updates om de impact van je optimalisaties te meten
Maak een pre-publicatie checklist die een minimum GEO-Score vereist voordat content live gaat
Third-party integraties
GEO-Score integreert met populaire tools en platforms om naadloos in je bestaande workflow te passen. Gebruik onze native integraties of bouw je eigen via de API.
Zapier
Verbind GEO-Score met 5.000+ apps. Trigger Zaps bij voltooide analyses, scoreveranderingen of nieuwe URL's in je account.
WordPress
Installeer de GEO-Score plugin om pagina's direct vanuit de WordPress-editor te analyseren. Zie realtime GEO-scores terwijl je schrijft en publiceert.
Slack
Ontvang directe Slack-notificaties voor scoreveranderingen, voltooide analyses en wekelijkse samenvattingsrapporten in het kanaal van je keuze.
Google Sheets
Synchroniseer GEO-Score-data automatisch met Google Sheets voor aangepaste rapportages, trendanalyse en eenvoudig delen met je team.
HubSpot
Verrijk je HubSpot-contentstrategie met GEO-Score-data. Volg AI-zichtbaarheid naast je bestaande marketingmetrics.
Google Analytics
Correleer GEO-Score-verbeteringen met veranderingen in organisch verkeer. Zie hoe AI-zoekmachineoptimalisatie je echte verkeer beïnvloedt.
Rate limits
API-rate limits gelden per account en worden gedeeld door alle plannen, van het gratis niveau tot het Onbeperkte Abonnement van €29,99/maand. Aanvragen die je rate limit overschrijden krijgen een 429-response met een Retry-After-header die aangeeft wanneer je kunt hervatten.
Rate limits resetten op een rollend uur-venster. Neem contact op met support als je hogere limieten nodig hebt.
Volgende stappen
Klaar om aan de slag te gaan? Genereer je API-sleutel vanuit de dashboard-instellingen en probeer de codevoorbeelden hierboven. Onze API-documentatie bevat gedetailleerde request- en response-schema's voor elk endpoint.
Voor geavanceerde use-cases verken je ons webhook-systeem om event-driven integraties te bouwen. Gebruik het POST /urls-endpoint om pagina's voor analyse in te dienen en het GET /urls/:id-endpoint om gedetailleerde resultaten op te halen.