Hvorfor bruke GEO-Score API?
Selv om GEO-Score-dashbordet er kraftig for manuell analyse, åpner API-et opp for automatisering i stor skala. Integrer GEO-analyse direkte i innholdsstyringssystemet, CI/CD-pipelinen eller egne rapporteringsverktøy for å overvåke AI-søkesynlighet på hele nettstedet ditt automatisk.
Enten du er en enkeltutvikler som automatiserer din egen arbeidsflyt eller et byrå som administrerer hundrevis av kundenettsteder, gir API-et deg programmatisk tilgang til alle funksjoner som er tilgjengelige i dashbordet og mer.
API-oversikt
GEO-Score API følger RESTful-konvensjoner med JSON-forespørsels- og svarobjekter. Alle endepunkter krever autentisering via API-nøkkel og returnerer konsistente svarstrukturer.
Base-URL
Svarformat
Alle API-svar følger en konsistent JSON-struktur med statuskoder og nøstede dataobjekter:
Autentisering
Hver API-forespørsel må inkludere API-nøkkelen din i Authorization-headeren. API-nøkler er knyttet til kontoen din og kan administreres fra dashbordinnstillingene.
Få tak i API-nøkkelen din
Naviger til Dashboard > Settings > API Keys for å generere en ny nøkkel. Du kan opprette flere nøkler med ulike tillatelser for ulike integrasjoner. Hver nøkkel kan tilbakekalles individuelt uten å påvirke andre.
Bruke API-nøkkelen din
Inkluder API-nøkkelen som et Bearer-token i Authorization-headeren for hver forespørsel:
Tilgjengelige endepunkter
GEO-Score API gir endepunkter for å sende inn URL-er for analyse, hente resultater, utløse re-analyser og sammenligne flere URL-er. Her er et sammendrag av alle tilgjengelige endepunkter:
Hent en paginert liste over alle analyserte URL-er på kontoen din.
Hent de fullstendige analyseresultatene for en spesifikk URL ved hjelp av dens unike ID.
Send inn en ny URL for GEO-analyse. Returnerer analyse-ID for å hente resultater.
Utløs en ny analyse av en tidligere analysert URL.
Sammenlign GEO-score og faktoroversikter på tvers av flere URL-er side om side.
Kodeeksempler
Kom raskt i gang med disse klare-til-bruk-kodeeksemplene i populære programmeringsspråk. Kopier, lim inn og tilpass for ditt spesifikke bruksområde.
JavaScript (Node.js)
Python
PHP
Webhooks
Webhooks lar GEO-Score sende sanntidsvarsler til serveren din når viktige hendelser inntreffer. I stedet for å spørre API-et om oppdateringer, konfigurer en webhook-URL og motta umiddelbare tilbakekall.
Sette opp webhooks
Konfigurer ditt webhook-endepunkt i Dashboard > Settings > Webhooks. Du kan velge hvilke hendelser som utløser varsler og angi en egendefinert signeringsnøkkel for verifisering av nyttelast.
analysis.complete
Utløses når en URL-analyse er ferdig behandlet og resultatene er tilgjengelige.
score.changed
Utløses når en re-analysert URL viser en betydelig GEO-Score-endring (delta > 5 poeng).
report.generated
Utløses når en planlagt eller forespurt rapport er klar for nedlasting.
url.added
Utløses når en ny URL legges til kontoen din for sporing.
Eksempel på webhook-nyttelast
Automatiseringsideer
Analyser automatisk hvert nytt blogginnlegg som publiseres i CMS-et før det går live
Sett opp Slack-varsler når en sporet URL faller under en GEO-Score-terskel
Generer ukentlige PDF-rapporter og send dem på e-post til kunder eller interessenter
Bygg et tilpasset dashbord som kombinerer GEO-Score-data med analyseplattformen din
Utløs re-analyse etter innholdsoppdateringer for å måle effekten av optimaliseringene dine
Lag en sjekkliste før publisering som krever en minimum GEO-Score før innhold går live
Tredjepartsintegrasjoner
GEO-Score integreres med populære verktøy og plattformer for å passe sømløst inn i din eksisterende arbeidsflyt. Bruk våre innebygde integrasjoner eller bygg dine egne ved hjelp av API-et.
Zapier
Koble GEO-Score til over 5 000 apper. Utløs Zaps når analyser fullføres, ved score-endringer eller når nye URL-er legges til på kontoen din.
WordPress
Installer GEO-Score-plugin-en for å analysere sider direkte fra WordPress-editoren. Se GEO-score i sanntid mens du skriver og publiserer.
Slack
Motta umiddelbare Slack-varsler om score-endringer, fullførte analyser og ukentlige sammendragsrapporter i din valgte kanal.
Google Sheets
Synkroniser GEO-Score-data automatisk til Google Sheets for tilpasset rapportering, trendanalyse og enkel deling med teamet ditt.
HubSpot
Berik HubSpot-innholdsstrategien din med GEO-Score-data. Spor AI-synlighet sammen med dine eksisterende markedsføringsmålinger.
Google Analytics
Korreler GEO-Score-forbedringer med endringer i organisk trafikk. Se hvordan AI-søkeoptimalisering påvirker den faktiske trafikken din.
Hastighetsgrenser
API-hastighetsgrenser gjelder per konto og deles av alle planer, fra det gratis nivået til det ubegrensede abonnementet på €29,99/måned. Forespørsler som overskrider hastighetsgrensen vil motta et 429-svar med en Retry-After-header som angir når du kan fortsette.
Hastighetsgrenser nullstilles i et rullerende én-times vindu. Kontakt support hvis du trenger høyere grenser.
Neste steg
Klar til å komme i gang? Generer API-nøkkelen din fra dashbordinnstillingsiden og prøv kodeeksemplene over. API-dokumentasjonen vår inkluderer detaljerte forespørsels- og svar-skjemaer for hvert endepunkt.
For avanserte bruksområder, utforsk webhook-systemet vårt for å bygge hendelsesdrevne integrasjoner. Bruk POST /urls-endepunktet for å sende inn sider for analyse og GET /urls/:id-endepunktet for å hente detaljerte resultater.