API Integraties & Ontwikkelaarshandleiding

Waarom de GEO-Score API Gebruiken?

Hoewel het GEO-Score dashboard krachtig is voor handmatige analyse, ontgrendelt de API automatisering op schaal. Integreer GEO-analyse direct in uw contentmanagementsysteem, CI/CD pipeline of aangepaste rapportagetools om AI-zoekvindbaarheid over uw hele website automatisch te monitoren.

Of u nu een solo-ontwikkelaar bent die uw eigen workflow automatiseert of een bureau dat honderden klantsites beheert, de API geeft u programmatische toegang tot elke functie die beschikbaar is in het dashboard en meer.

API Overzicht

De GEO-Score API volgt RESTful conventies met JSON request en response bodies. Alle endpoints vereisen authenticatie via API-sleutel en retourneren consistente response structuren.

Basis URL

https://api.bloffee.com/v1

Response Formaat

Alle API responses volgen een consistente JSON-structuur met statuscodes en geneste data objecten:

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

Authenticatie

Elke API request moet uw API-sleutel in de Authorization header bevatten. API-sleutels zijn beperkt tot uw account en kunnen beheerd worden vanuit uw dashboard instellingen.

Uw API-sleutel Verkrijgen

Navigeer naar Dashboard > Instellingen > API-sleutels om een nieuwe sleutel te genereren. U kunt meerdere sleutels aanmaken met verschillende rechten voor verschillende integraties. Elke sleutel kan individueel worden ingetrokken zonder anderen te beïnvloeden.

Authorization: Bearer YOUR_API_KEY_HERE

Uw API-sleutel Gebruiken

Neem uw API-sleutel op als Bearer token in de Authorization header van elke request:

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

Beschikbare Endpoints

De GEO-Score API biedt endpoints voor het indienen van URL's voor analyse, het ophalen van resultaten, het triggeren van heranalyses en het vergelijken van meerdere URL's. Hier is een samenvatting van alle beschikbare endpoints:

GET/urls

Haal een gepagineerde lijst op van alle geanalyseerde URL's in uw account.

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

GET/urls/:id

Haal de volledige analyseresultaten op voor een specifieke URL op basis van het unieke ID.

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

POST/urls

Dien een nieuwe URL in voor GEO-analyse. Retourneert het analyse-ID voor polling resultaten.

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

PUT/urls/:id/refresh

Trigger een nieuwe heranalyse van een eerder geanalyseerde URL.

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

GET/compare

Vergelijk GEO-scores en factoranalyses van meerdere URL's naast elkaar.

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

Codevoorbeelden

Begin snel met deze gebruiksklare codevoorbeelden in populaire programmeertalen. Kopieer, plak en pas aan voor uw specifieke 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 stellen GEO-Score in staat om realtime notificaties naar uw server te pushen wanneer belangrijke gebeurtenissen plaatsvinden. In plaats van de API te pollen voor updates, configureert u een webhook URL en ontvangt u directe callbacks.

Webhooks Instellen

Configureer uw webhook endpoint in Dashboard > Instellingen > Webhooks. U kunt selecteren welke gebeurtenissen notificaties triggeren en een aangepast signing secret instellen voor payload verificatie.

analysis.complete Geactiveerd wanneer een URL-analyse klaar is met verwerken en resultaten beschikbaar zijn.
score.changed Geactiveerd wanneer een opnieuw geanalyseerde URL een significante GEO-Score verandering toont (delta > 5 punten).
report.generated Geactiveerd wanneer een gepland of on-demand rapport klaar is voor download.
url.added Geactiveerd wanneer een nieuwe URL wordt toegevoegd aan uw account voor tracking.

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

Automatiseringsideeën

•Analyseer automatisch elk nieuw blogbericht dat in uw CMS wordt gepubliceerd voordat het live gaat
•Stel Slack notificaties in wanneer een getrackte URL onder een GEO-Score drempelwaarde zakt
•Genereer wekelijks PDF-rapporten en email ze naar uw klanten of stakeholders
•Bouw een aangepast dashboard dat GEO-Score data combineert met uw analyseplatform
•Trigger heranalyse na content updates om de impact van uw optimalisaties te meten
•Creëer een pre-publicatie checklist die een minimum GEO-Score vereist voordat content live gaat

Integraties van Derden

GEO-Score integreert met populaire tools en platforms om naadloos in uw bestaande workflow te passen. Gebruik onze native integraties of bouw uw eigen met de API.

Zapier

Verbind GEO-Score met 5.000+ apps. Trigger Zaps bij analyse voltooiing, score veranderingen of nieuwe URL's toegevoegd aan uw account.

WordPress

Installeer de GEO-Score plugin om pagina's direct vanuit de WordPress editor te analyseren. Zie realtime GEO-scores terwijl u schrijft en publiceert.

Slack

Ontvang directe Slack notificaties voor score veranderingen, voltooide analyses en wekelijkse samenvattingsrapporten in uw gekozen kanaal.

Google Sheets

Synchroniseer GEO-Score data automatisch naar Google Sheets voor aangepaste rapportage, trendanalyse en gemakkelijk delen met uw team.

HubSpot

Verrijk uw HubSpot contentstrategie met GEO-Score data. Volg AI-zichtbaarheid naast uw bestaande marketingmetrics.

Google Analytics

Correleer GEO-Score verbeteringen met organische verkeersveranderingen. Zie hoe AI-zoekoptimalisatie uw echte verkeer beïnvloedt.

Rate Limits

API rate limits zijn gebaseerd op uw abonnementsplan. Requests die uw rate limit overschrijden ontvangen een 429 response met een Retry-After header die aangeeft wanneer u kunt hervatten.

Starter

100

requests per uur

Pro

1,000

requests per uur

Enterprise

Op maat

neem contact op voor limieten

Rate limits resetten op een rollend één-uur venster. Burst requests tot 2x uw uurlimiet zijn toegestaan voor korte periodes. Neem contact op met support als u hogere limieten nodig heeft.

Volgende Stappen

Klaar om te beginnen? Genereer uw API-sleutel vanuit de dashboard instellingenpagina en probeer de bovenstaande codevoorbeelden. Onze API-documentatie bevat gedetailleerde request en response schema's voor elk endpoint.

Voor geavanceerde use cases, verken ons webhook systeem om event-driven integraties te bouwen. Gebruik het POST /urls endpoint om pagina's in te dienen voor analyse en het GET /urls/:id endpoint om gedetailleerde resultaten op te halen.