API-integraties en developer-gids | GEO-Score by Bloffee

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 je content-managementsysteem, CI/CD-pijplijn of aangepaste rapportagetools om de zichtbaarheid in AI-zoekmachines voor je hele website automatisch te monitoren.

Of je nu een solo-developer bent die je eigen workflow automatiseert of een bureau dat honderden klantsites beheert: de API biedt je programmatische toegang tot elke functie die in het dashboard beschikbaar is en meer.

API-overzicht

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

Base URL

https://api.bloffee.com/v1

Responseformaat

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-aanvraag moet je API-sleutel bevatten in de Authorization-header. API-sleutels zijn gekoppeld aan je account en kunnen worden beheerd vanuit je dashboard-instellingen.

Je API-sleutel ophalen

Ga naar Dashboard > Instellingen > API-sleutels om een nieuwe sleutel te genereren. Je kunt meerdere sleutels aanmaken met verschillende permissies voor verschillende integraties. Elke sleutel kan individueel worden ingetrokken zonder andere te beïnvloeden.

Authorization: Bearer YOUR_API_KEY_HERE

Je API-sleutel gebruiken

Voeg je API-sleutel toe als Bearer-token in de Authorization-header van elke aanvraag:

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, ophalen van resultaten, triggeren van her-analyses en het vergelijken van meerdere URL's. Hier is een overzicht van alle beschikbare endpoints:

GET/urls

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

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

GET/urls/:id

Haal de volledige analyseresultaten op voor een specifieke URL via zijn unieke ID.

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

POST/urls

Dien een nieuwe URL in voor GEO-analyse. Retourneert de analyse-ID om resultaten te pollen.

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

PUT/urls/:id/refresh

Trigger een nieuwe analyse van een eerder geanalyseerde URL.

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

GET/compare

Vergelijk GEO-scores en factor-breakdowns voor meerdere URL's naast elkaar.

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

Codevoorbeelden

Ga snel aan de slag met deze kant-en-klare codevoorbeelden in populaire programmeertalen. Kopieer, plak en pas aan voor je 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

Met webhooks kan GEO-Score realtime notificaties naar je server pushen zodra belangrijke events plaatsvinden. In plaats van de API te pollen voor updates, configureer je een webhook-URL en ontvang je directe callbacks.

Webhooks instellen

Configureer je webhook-endpoint in Dashboard > Instellingen > Webhooks. Je kunt selecteren welke events notificaties triggeren en een aangepaste signing secret instellen voor payload-verificatie.

analysis.complete Wordt geactiveerd wanneer een URL-analyse klaar is met verwerken en resultaten beschikbaar zijn.
score.changed Wordt geactiveerd wanneer een opnieuw geanalyseerde URL een significante verandering in GEO-Score laat zien (delta > 5 punten).
report.generated Wordt geactiveerd wanneer een gepland of on-demand rapport klaar is om te downloaden.
url.added Wordt geactiveerd wanneer een nieuwe URL aan je account wordt toegevoegd 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 elke nieuwe blogpost in je CMS voordat deze live gaat
•Stel Slack-notificaties in wanneer een gevolgde URL onder een GEO-Score-drempel zakt
•Genereer wekelijkse PDF-rapporten en e-mail ze naar je klanten of stakeholders
•Bouw een aangepast dashboard dat GEO-Score-data combineert met je analyticsplatform
•Trigger een her-analyse na content-updates om de impact van je optimalisaties te meten
•Maak een pre-publicatie checklist die een minimum GEO-Score vereist voordat content live gaat

Third-party integraties

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

Zapier

Verbind GEO-Score met 5.000+ apps. Trigger Zaps bij voltooide analyses, scoreveranderingen of nieuwe URL's in je account.

WordPress

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

Slack

Ontvang directe Slack-notificaties voor scoreveranderingen, voltooide analyses en wekelijkse samenvattingsrapporten in het kanaal van je keuze.

Google Sheets

Synchroniseer GEO-Score-data automatisch met Google Sheets voor aangepaste rapportages, trendanalyse en eenvoudig delen met je team.

HubSpot

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

Google Analytics

Correleer GEO-Score-verbeteringen met veranderingen in organisch verkeer. Zie hoe AI-zoekmachineoptimalisatie je echte verkeer beïnvloedt.

Rate limits

API-rate limits zijn gebaseerd op je abonnement. Aanvragen die je rate limit overschrijden krijgen een 429-response met een Retry-After-header die aangeeft wanneer je kunt hervatten.

Starter

100

aanvragen per uur

Pro

1,000

aanvragen per uur

Enterprise

Custom

neem contact op voor limieten

Rate limits resetten op een rollend uur-venster. Burst-aanvragen tot 2x je uurlimiet zijn voor korte periodes toegestaan. Neem contact op met support als je hogere limieten nodig hebt.

Volgende stappen

Klaar om aan de slag te gaan? Genereer je API-sleutel vanuit de dashboard-instellingen en probeer de codevoorbeelden hierboven. Onze API-documentatie bevat gedetailleerde request- en response-schema's voor elk endpoint.

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