Entwickler-API

Ihre KI-Sichtbarkeit.
Programmatisch abrufbar.

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.

Demo buchen Tarife ansehen
Daten

Was Sie abrufen können.

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, mit Titel, Slug, Auszug, Kategorie und Veröffentlichungsdatum, bereit zur Ausspielung in Ihre eigene Website.

Authentifizierung

Ein API-Key pro Unternehmen.

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

Die wichtigsten Routen.

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 (limit, 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

In zwei Aufrufen startklar.

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

Limits, Frische & Versionierung.

  • 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).

Bereit, GeoUp anzubinden?

Die API ist im Polaris-, Orion- und Galaxis-Tarif enthalten. Schreiben Sie uns für Ihren API-Zugang, wir schalten Ihren Key frei und begleiten die Anbindung.

Demo buchen Mehr zum Produkt