API-integrasjoner og utviklerguide | GEO-Score by Bloffee

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

https://api.bloffee.com/v1

Svarformat

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

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

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.

Authorization: Bearer YOUR_API_KEY_HERE

Bruke API-nøkkelen din

Inkluder API-nøkkelen som et Bearer-token i Authorization-headeren for hver forespørsel:

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

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:

GET/urls

Hent en paginert liste over alle analyserte URL-er på kontoen din.

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

GET/urls/:id

Hent de fullstendige analyseresultatene for en spesifikk URL ved hjelp av dens unike ID.

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

POST/urls

Send inn en ny URL for GEO-analyse. Returnerer analyse-ID for å hente resultater.

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

PUT/urls/:id/refresh

Utløs en ny analyse av en tidligere analysert URL.

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

GET/compare

Sammenlign GEO-score og faktoroversikter på tvers av flere URL-er side om side.

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

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)

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

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

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 er basert på abonnementsplanen din. Forespørsler som overskrider hastighetsgrensen vil motta et 429-svar med en Retry-After-header som angir når du kan fortsette.

Starter

100

forespørsler per time

Pro

1,000

forespørsler per time

Enterprise

Tilpasset

kontakt oss for grenser

Hastighetsgrenser nullstilles i et rullerende én-times vindu. Burst-forespørsler opptil 2x din timegrense er tillatt i korte perioder. 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.