Entwickler-API

Die GeoUp REST-API liefert Ihre Sichtbarkeits-Scores, Wettbewerbsdaten und Auto-Blog-Inhalte als saubere JSON-Antworten, direkt in Ihr Dashboard, Reporting oder Ihre Automatisierung. Read-only, sicher per API-Key, ab dem Polaris-Tarif.

Daten

Sichtbarkeits-Scores

Match-Rate, Erwähnungen und Verlauf pro KI-System (ChatGPT, Gemini, Perplexity & Co.) für Ihren ausgewählten Zeitraum, inklusive Angabe zur Datenfrische.

Wettbewerbsdaten

Ihre Top-Konkurrenten aus der KI-Analyse mit Erwähnungs-Häufigkeit, als Grundlage für eigene Auswertungen und Kundenreports.

Auto-Blog-Inhalte

Ihre veröffentlichten GeoUp-Autoblog-Beiträge im Volltext: Titel, Slug, Auszug, Kategorie, Tags, Titelbild samt KI-Kennzeichnung, Meta-Titel und -Description, Keywords, fertiges JSON-LD sowie Veröffentlichungs- und Änderungsdatum, bereit zur Übernahme in TYPO3, Joomla, Drupal oder jedes andere CMS.

Authentifizierung

Jeder Key ist fest an genau ein Unternehmen gebunden und gewährt ausschließlich lesenden Zugriff auf dessen Daten. Sie erstellen und widerrufen Keys jederzeit selbst im Dashboard, der Schlüssel wird nur einmal im Klartext angezeigt.

Authentifizierung per Bearer-Token
# HTTP-Header bei jeder Anfrage
Authorization: Bearer geoup_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
  • Sicher gespeichert
    In unserer Datenbank liegt nur ein Hash, der Klartext-Key verlässt nie wieder unsere Oberfläche.
  • Jederzeit widerrufbar
    Kompromittierter Key? Ein Klick im Dashboard sperrt ihn sofort, der nächste Aufruf wird abgewiesen.
  • Fest auf Ihr Unternehmen begrenzt
    Kein Zugriff auf fremde Daten möglich, der Geltungsbereich steckt im Key selbst.
Endpunkte
MethodeEndpunktLiefertVerfügbar
GET /api/public/v1/visibility/summary Match-Rate, Erwähnungen & Verlauf pro KI-System (Parameter range=7d|30d|90d) ab Polaris
GET /api/public/v1/blog/posts Veröffentlichte Auto-Blog-Beiträge im Volltext inkl. Meta-Daten, Titelbild und JSON-LD (limit max. 100, offset, slug) ab Polaris
GET /api/public/v1/competitors Top-Wettbewerber aus der KI-Analyse in Kürze
GET /api/public/v1/visibility/timeseries Erwähnungs-Verlauf als Zeitreihe pro Anbieter in Kürze
Beispiel
Sichtbarkeit der letzten 30 Tage
curl https://geoup.io/api/public/v1/visibility/summary?range=30d \
  -H "Authorization: Bearer geoup_live_..."
Antwort (gekürzt)
{
  "data": { /* Scores, byProvider, ... */ },
  "meta": {
    "range": "30d",
    "lastRunAt": "2026-06-09T08:12:00Z",
    "nextRefreshAt": "2026-06-24T08:12:00Z",
    "status": "ready"
  }
}
Gut zu wissen
  • Datenfrische statt Echtzeit
    Sichtbarkeits-Werte ändern sich nur nach einer neuen KI-Analyse, je nach Tarif typischerweise alle 7,5 bis 15 Tage. Jede Antwort liefert lastRunAt und nextRefreshAt, häufigeres Abrufen liefert keine neuen Werte.
  • Rate-Limit pro Key
    Aktuell 60 Anfragen pro Minute. Jede Antwort enthält X-RateLimit-*-Header, bei Überschreitung antwortet die API mit 429 und Retry-After.
  • Saubere Versionierung
    Die Version steht im Pfad (/v1/). Breaking Changes kündigen wir mit mindestens sechs Monaten Vorlauf an, additive Ergänzungen bleiben abwärtskompatibel.
  • Vorhersagbare Fehler
    Klare HTTP-Codes: 401 (Key ungültig/widerrufen), 403 (Tarif zu niedrig), 404 (kein Zugriff), 429 (Rate-Limit).
  • Lieber im KI-Assistenten als mit curl?
    Dieselben Daten und mehr liefert der GeoUp-MCP-Server direkt in Claude, ChatGPT oder Cursor, ohne eigene Integration.
  • WordPress braucht keinen API-Key
    Das GeoUp-Plugin aus dem Dashboard verbindet Ihre WordPress-Website direkt und veröffentlicht Auto-Blog-Artikel automatisch. Die REST-API ist der Weg für alle anderen Systeme.

Die API ist im Polaris-, Orion- und Galaxis-Tarif enthalten. Ihren Key erstellen Sie selbst im Dashboard unter Einstellungen → API-Zugang. Bei Fragen zur Anbindung begleiten wir Sie gern.