Hvorfor bruge GEO-Score API'en?
Selvom GEO-Score-dashboardet er kraftfuldt til manuel analyse, låser API'en op for automatisering i stor skala. Integrer GEO-analyse direkte i dit indholdshåndteringssystem, CI/CD-pipeline eller brugerdefinerede rapporteringsværktøjer for automatisk at overvåge AI-søgesynlighed på tværs af hele din hjemmeside.
Uanset om du er en solo-udvikler, der automatiserer dit eget workflow, eller et bureau, der administrerer hundredvis af kundesites, giver API'en dig programmatisk adgang til hver funktion, der er tilgængelig i dashboardet, og mere.
API-oversigt
GEO-Score API'en følger RESTful-konventioner med JSON-anmodnings- og svarindhold. Alle endpoints kræver godkendelse via API-nøgle og returnerer konsistente svarstrukturer.
Base URL
Svarformat
Alle API-svar følger en konsistent JSON-struktur med statuskoder og indlejrede dataobjekter:
Godkendelse
Hver API-anmodning skal inkludere din API-nøgle i Authorization-headeren. API-nøgler er knyttet til din konto og kan administreres fra dine dashboardindstillinger.
Få din API-nøgle
Naviger til Dashboard > Indstillinger > API-nøgler for at generere en ny nøgle. Du kan oprette flere nøgler med forskellige tilladelser til forskellige integrationer. Hver nøgle kan tilbagekaldes individuelt uden at påvirke andre.
Brug af din API-nøgle
Inkludér din API-nøgle som et Bearer-token i Authorization-headeren for hver anmodning:
Tilgængelige endpoints
GEO-Score API'en leverer endpoints til at indsende URL'er til analyse, hente resultater, udløse genanalyser og sammenligne flere URL'er. Her er et resumé af alle tilgængelige endpoints:
Hent en pagineret liste over alle analyserede URL'er på din konto.
Få de fulde analyseresultater for en specifik URL ud fra dens unikke ID.
Indsend en ny URL til GEO-analyse. Returnerer analyse-ID'et til polling af resultater.
Udløs en frisk genanalyse af en tidligere analyseret URL.
Sammenlign GEO-scorer og faktoropdelinger på tværs af flere URL'er side om side.
Kodeeksempler
Kom hurtigt i gang med disse klar-til-brug-kodeeksempler i populære programmeringssprog. Kopiér, indsæt og tilpas til din specifikke use case.
JavaScript (Node.js)
Python
PHP
Webhooks
Webhooks gør det muligt for GEO-Score at sende realtidsmeddelelser til din server, når vigtige hændelser opstår. I stedet for at polle API'en for opdateringer, konfigurer en webhook-URL og modtag øjeblikkelige callbacks.
Opsætning af webhooks
Konfigurer dit webhook-endpoint i Dashboard > Indstillinger > Webhooks. Du kan vælge hvilke hændelser, der udløser meddelelser, og indstille en brugerdefineret signeringshemmelighed til payload-verifikation.
analysis.complete
Udløses når en URL-analyse er færdigbehandlet, og resultater er tilgængelige.
score.changed
Udløses når en genanalyseret URL viser en betydelig GEO Score-ændring (delta > 5 point).
report.generated
Udløses når en planlagt eller on-demand rapport er klar til download.
url.added
Udløses når en ny URL tilføjes til din konto til sporing.
Eksempel på webhook-payload
Automatiseringsidéer
Analysér automatisk hvert nyt blogindlæg, der publiceres i dit CMS, før det går i luften
Opsæt Slack-meddelelser, når en sporet URL falder under en GEO Score-tærskel
Generér ugentlige PDF-rapporter, og send dem på e-mail til dine kunder eller stakeholders
Byg et brugerdefineret dashboard, der kombinerer GEO Score-data med din analyseplatform
Udløs genanalyse efter indholdsopdateringer for at måle effekten af dine optimeringer
Opret en præpubliceringstjekliste, der kræver en minimum-GEO Score, før indhold går i luften
Tredjepartsintegrationer
GEO-Score integreres med populære værktøjer og platforme for at passe sømløst ind i dit eksisterende workflow. Brug vores native integrationer eller byg din egen ved hjælp af API'en.
Zapier
Forbind GEO-Score til 5.000+ apps. Udløs Zaps ved analysefuldførelse, score-ændringer eller nye URL'er tilføjet til din konto.
WordPress
Installer GEO-Score-pluginnet for at analysere sider direkte fra WordPress-editoren. Se realtids GEO-scorer, mens du skriver og publicerer.
Slack
Modtag øjeblikkelige Slack-meddelelser om score-ændringer, gennemførte analyser og ugentlige opsummeringsrapporter i din valgte kanal.
Google Sheets
Synkronisér automatisk GEO Score-data til Google Sheets til brugerdefineret rapportering, trendanalyse og let deling med dit team.
HubSpot
Berig din HubSpot-indholdsstrategi med GEO Score-data. Spor AI-synlighed sammen med dine eksisterende marketingmetrikker.
Google Analytics
Korrelér GEO Score-forbedringer med ændringer i organisk trafik. Se hvordan AI-søgeoptimering påvirker din virkelige trafik.
Rate-grænser
API rate-grænser gælder pr. konto og deles af alle planer, fra det gratis niveau til det ubegrænsede abonnement til €29,99/måned. Anmodninger, der overskrider din rate-grænse, modtager et 429-svar med en Retry-After-header, der angiver, hvornår du kan genoptage.
Rate-grænser nulstilles på et rullende én-times-vindue. Kontakt support, hvis du har brug for højere grænser.
Næste skridt
Klar til at komme i gang? Generér din API-nøgle fra dashboardets indstillingsside, og prøv kodeeksemplerne ovenfor. Vores API-dokumentation inkluderer detaljerede anmodnings- og svarschemaer for hvert endpoint.
For avancerede use cases, udforsk vores webhook-system for at bygge hændelsesdrevne integrationer. Brug POST /urls-endpointet til at indsende sider til analyse og GET /urls/:id-endpointet til at hente detaljerede resultater.