API-integrationer og udviklerguide | GEO-Score af Bloffee

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

https://api.bloffee.com/v1

Svarformat

Alle API-svar følger en konsistent JSON-struktur med statuskoder og indlejrede dataobjekter:

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

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.

Authorization: Bearer YOUR_API_KEY_HERE

Brug af din API-nøgle

Inkludér din API-nøgle som et Bearer-token i Authorization-headeren for hver anmodning:

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

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:

GET/urls

Hent en pagineret liste over alle analyserede URL'er på din konto.

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

GET/urls/:id

Få de fulde analyseresultater for en specifik URL ud fra dens unikke ID.

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

POST/urls

Indsend en ny URL til GEO-analyse. Returnerer analyse-ID'et til polling af resultater.

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

PUT/urls/:id/refresh

Udløs en frisk genanalyse af en tidligere analyseret URL.

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

GET/compare

Sammenlign GEO-scorer og faktoropdelinger på tværs af flere URL'er side om side.

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

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)

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 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

{
  "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

•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 er baseret på dit abonnement. Anmodninger, der overskrider din rate-grænse, modtager et 429-svar med en Retry-After-header, der angiver, hvornår du kan genoptage.

Starter

100

anmodninger pr. time

Pro

1,000

anmodninger pr. time

Enterprise

Tilpasset

kontakt os for grænser

Rate-grænser nulstilles på et rullende én-times-vindue. Burst-anmodninger op til 2x din time-grænse er tilladt i korte perioder. 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.