Varför använda GEO-Score API:et?
Medan GEO-Score-instrumentpanelen är kraftfull för manuell analys, låser API:et upp automatisering i stor skala. Integrera GEO-analys direkt i ditt innehållshanteringssystem, CI/CD-pipeline eller anpassade rapporteringsverktyg för att automatiskt övervaka AI-söksynlighet över hela din webbplats.
Oavsett om du är en ensam utvecklare som automatiserar ditt eget arbetsflöde eller en byrå som hanterar hundratals klientwebbplatser, ger API:et dig programmatisk åtkomst till varje funktion som finns i instrumentpanelen och mer.
API-översikt
GEO-Score API:et följer RESTful-konventioner med JSON-förfrågnings- och svarskroppar. Alla endpoints kräver autentisering via API-nyckel och returnerar konsekventa svarsstrukturer.
Bas-URL
Svarsformat
Alla API-svar följer en konsekvent JSON-struktur med statuskoder och inbäddade dataobjekt:
Autentisering
Varje API-förfrågan måste innehålla din API-nyckel i Authorization-headern. API-nycklar är knutna till ditt konto och kan hanteras från dina instrumentpanelinställningar.
Skaffa din API-nyckel
Navigera till Dashboard > Inställningar > API-nycklar för att generera en ny nyckel. Du kan skapa flera nycklar med olika behörigheter för olika integrationer. Varje nyckel kan återkallas individuellt utan att påverka andra.
Använda din API-nyckel
Inkludera din API-nyckel som en Bearer-token i Authorization-headern för varje förfrågan:
Tillgängliga endpoints
GEO-Score API:et tillhandahåller endpoints för att skicka in URL:er för analys, hämta resultat, utlösa omanalyser och jämföra flera URL:er. Här är en sammanfattning av alla tillgängliga endpoints:
Hämta en paginerad lista över alla analyserade URL:er på ditt konto.
Hämta de fullständiga analysresultaten för en specifik URL via dess unika ID.
Skicka in en ny URL för GEO-analys. Returnerar analys-ID:t för pollning av resultat.
Utlös en ny omanalys av en tidigare analyserad URL.
Jämför GEO-poäng och faktoruppdelningar mellan flera URL:er sida vid sida.
Kodexempel
Kom igång snabbt med dessa färdiga kodexempel i populära programmeringsspråk. Kopiera, klistra in och anpassa för ditt specifika användningsfall.
JavaScript (Node.js)
Python
PHP
Webhooks
Webhooks låter GEO-Score skicka realtidsmeddelanden till din server när viktiga händelser inträffar. Istället för att polla API:et efter uppdateringar, konfigurera en webhook-URL och få omedelbara återanrop.
Konfigurera webhooks
Konfigurera din webhook-endpoint i Dashboard > Inställningar > Webhooks. Du kan välja vilka händelser som utlöser meddelanden och ange en anpassad signeringshemlighet för verifiering av nyttolast.
analysis.complete
Utlöses när en URL-analys är klar och resultaten är tillgängliga.
score.changed
Utlöses när en omanalyserad URL visar en betydande GEO-poängförändring (delta > 5 poäng).
report.generated
Utlöses när en schemalagd eller direktbeställd rapport är redo att laddas ner.
url.added
Utlöses när en ny URL läggs till på ditt konto för spårning.
Exempel på webhook-nyttolast
Automatiseringsidéer
Analysera automatiskt varje nytt blogginlägg som publiceras i ditt CMS innan det går live
Konfigurera Slack-meddelanden när någon spårad URL hamnar under ett GEO-poängtröskelvärde
Generera veckovisa PDF-rapporter och e-posta dem till dina klienter eller intressenter
Bygg en anpassad instrumentpanel som kombinerar GEO-poängdata med din analysplattform
Utlös omanalys efter innehållsuppdateringar för att mäta effekten av dina optimeringar
Skapa en pre-publiceringschecklista som kräver en minsta GEO-poäng innan innehåll går live
Tredjepartsintegrationer
GEO-Score integreras med populära verktyg och plattformar för att passa sömlöst in i ditt befintliga arbetsflöde. Använd våra inbyggda integrationer eller bygg dina egna med API:et.
Zapier
Anslut GEO-Score till 5 000+ appar. Utlös Zaps vid analysslutförande, poängförändringar eller nya URL:er som läggs till på ditt konto.
WordPress
Installera GEO-Score-plugin-programmet för att analysera sidor direkt från WordPress-redigeraren. Se GEO-poäng i realtid medan du skriver och publicerar.
Slack
Få omedelbara Slack-meddelanden för poängförändringar, slutförda analyser och veckovisa sammanfattningsrapporter i din valda kanal.
Google Sheets
Synkronisera automatiskt GEO-poängdata till Google Sheets för anpassad rapportering, trendanalys och enkel delning med ditt team.
HubSpot
Berika din HubSpot-innehållsstrategi med GEO-poängdata. Spåra AI-synlighet tillsammans med dina befintliga marknadsföringsmått.
Google Analytics
Korrelera GEO-poängförbättringar med förändringar i organisk trafik. Se hur AI-sökoptimering påverkar din verkliga trafik.
Hastighetsgränser
API-hastighetsgränser gäller per konto och delas av alla planer, från den gratis nivån till den obegränsade prenumerationen för €29,99/månad. Förfrågningar som överskrider din hastighetsgräns får ett 429-svar med en Retry-After-header som anger när du kan återuppta.
Hastighetsgränser återställs i ett rullande enhetsfönster på en timme. Kontakta support om du behöver högre gränser.
Nästa steg
Redo att komma igång? Generera din API-nyckel från instrumentpanelens inställningssida och prova kodexemplen ovan. Vår API-dokumentation innehåller detaljerade förfrågnings- och svarsscheman för varje endpoint.
För avancerade användningsfall, utforska vårt webhook-system för att bygga händelsestyrda integrationer. Använd POST /urls-endpointen för att skicka in sidor för analys och GET /urls/:id-endpointen för att hämta detaljerade resultat.