API-integrationer och utvecklarguide

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

https://api.bloffee.com/v1

Svarsformat

Alla API-svar följer en konsekvent JSON-struktur med statuskoder och inbäddade dataobjekt:

{
  "status": "success",
  "data": {
    "url": "https://example.com/page",
    "geoScore": 85,
    "factors": {...}
  }
}

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.

Authorization: Bearer YOUR_API_KEY_HERE

Använda din API-nyckel

Inkludera din API-nyckel som en Bearer-token i Authorization-headern för varje förfrågan:

curl -X GET \
  https://api.bloffee.com/v1/urls \
  -H "Authorization: Bearer YOUR_API_KEY"

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:

GET/urls

Hämta en paginerad lista över alla analyserade URL:er på ditt konto.

GET https://api.bloffee.com/v1/urls?page=1&limit=50

GET/urls/:id

Hämta de fullständiga analysresultaten för en specifik URL via dess unika ID.

GET https://api.bloffee.com/v1/urls/abc123

POST/urls

Skicka in en ny URL för GEO-analys. Returnerar analys-ID:t för pollning av resultat.

POST https://api.bloffee.com/v1/urls

PUT/urls/:id/refresh

Utlös en ny omanalys av en tidigare analyserad URL.

PUT https://api.bloffee.com/v1/urls/abc123/refresh

GET/compare

Jämför GEO-poäng och faktoruppdelningar mellan flera URL:er sida vid sida.

GET https://api.bloffee.com/v1/compare?urls=id1,id2,id3

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)

const fetch = require('node-fetch');

const analyzeURL = async (url) => {
  const response = await fetch('https://api.bloffee.com/v1/urls', {
    method: 'POST',
    headers: {
      'Authorization': 'Bearer YOUR_API_KEY',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({ url })
  });

  const data = await response.json();
  console.log('GEO Score:', data.data.geoScore);
  return data;
};

analyzeURL('https://example.com/my-page');

Python

import requests

def analyze_url(url):
    headers = {
        'Authorization': 'Bearer YOUR_API_KEY',
        'Content-Type': 'application/json'
    }

    response = requests.post(
        'https://api.bloffee.com/v1/urls',
        headers=headers,
        json={'url': url}
    )

    data = response.json()
    print(f"GEO Score: {data['data']['geoScore']}")
    return data

analyze_url('https://example.com/my-page')

PHP

<?php
$url = 'https://example.com/my-page';

$data = array('url' => $url);
$options = array(
    'http' => array(
        'header'  => "Authorization: Bearer YOUR_API_KEY
" .
                     "Content-Type: application/json
",
        'method'  => 'POST',
        'content' => json_encode($data)
    )
);

$context  = stream_context_create($options);
$result = file_get_contents(
    'https://api.bloffee.com/v1/urls',
    false,
    $context
);

$response = json_decode($result, true);
echo "GEO Score: " . $response['data']['geoScore'];
?>

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

{
  "event": "analysis.complete",
  "timestamp": "2025-01-10T12:00:00Z",
  "data": {
    "url_id": "abc123",
    "url": "https://example.com/page",
    "geoScore": 85,
    "previousScore": 78,
    "factors": {
      "readability": 90,
      "comprehensiveness": 82,
      "aiOptimization": 85
    }
  }
}

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 baseras på din abonnemangsplan. 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.

Starter

100

förfrågningar per timme

Pro

1,000

förfrågningar per timme

Enterprise

Anpassad

kontakta oss för gränser

Hastighetsgränser återställs i ett rullande enhetsfönster på en timme. Burst-förfrågningar upp till 2x din timgräns tillåts under korta perioder. 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.