REST-API
Die API für KI-Sichtbarkeit und Rank-Tracking für Ihren Reporting-Stack
Holen Sie Sichtbarkeit, Prompts, Antworten, Zitationen und Wettbewerbsdaten aus Geoptie in BigQuery, Looker Studio, Kunden-Dashboards oder Ihr eigenes Produkt. Ein Bearer-Schlüssel, JSON über HTTPS und kein monatliches Anfragekontingent.
ChatGPT
Claude
Perplexity
Gemini
AI Overviews- AI Mode
Copilot
curl -sS "https://api.geoptie.com/v1/brands" \
-H "Authorization: Bearer $GEOPTIE_API_KEY"{
"data": [
{
"id": "3f2a6c1e-0b7d-4e59-9a41-2c8d5e7f9b10",
"name": "Example Brand",
"domain": "example.com",
"engines": ["chatgpt", "claude", "perplexity", "gemini"],
"country": "US"
}
],
"has_more": false,
"next_cursor": null
}v1
stabile REST-API
7
abgedeckte KI-Engines
120/min
Anfragen, kein Monatslimit
$99
pro Monat, Professional-Tarif
Marketingteams und Agenturen vertrauen uns
Was ist eine KI-Sichtbarkeits-API?
Eine KI-Sichtbarkeits-API liefert als Daten für Ihre eigenen Systeme, wie KI-Engines wie ChatGPT, Claude, Perplexity, Gemini und die KI-Antworten von Google eine Marke erwähnen und zitieren. Sie dient auch als KI-Rank-Tracker-API: Sichtbarkeit und Position für jeden getrackten Prompt, in jeder Engine, jeden Tag.
Die REST-API von Geoptie liefert dieselben Kennzahlen wie das Dashboard, sodass die Zahlen im Data Warehouse, in einem BI-Dashboard, einem Kundenbericht oder einer Slack-Benachrichtigung mit dem übereinstimmen, was Ihr Team sieht.
Ihre erste Anfrage in unter einer Minute
Erstellen Sie einen Schlüssel im Dashboard und senden Sie ihn als Bearer-Token. GET /v1/brands bestätigt, dass der Schlüssel funktioniert, und liefert die Marken-IDs, die alle anderen Endpunkte verwenden.
In drei Schritten eingerichtet
- 1
Schlüssel erstellen
Im Dashboard unter API-Schlüssel, für den gesamten Workspace oder für ausgewählte Marken.
- 2
GET /v1/brands aufrufen
Bestätigt, dass der Schlüssel funktioniert, und liefert die Marken-IDs, die alle anderen Endpunkte verwenden.
- 3
Die benötigten Daten abrufen
Sichtbarkeit, Prompts, Antworten, Zitationen und Wettbewerber, nach Marke und Engine.
curl -sS "https://api.geoptie.com/v1/brands" \
-H "Authorization: Bearer $GEOPTIE_API_KEY"import os, requests
r = requests.get(
"https://api.geoptie.com/v1/brands",
headers={"Authorization": f"Bearer {os.environ['GEOPTIE_API_KEY']}"},
timeout=30,
)
r.raise_for_status()
print(r.json())const r = await fetch("https://api.geoptie.com/v1/brands", {
headers: { Authorization: `Bearer ${process.env.GEOPTIE_API_KEY}` },
});
if (!r.ok) throw new Error(`${r.status} ${await r.text()}`);
console.log(await r.json());Endpunkt-Katalog
Marken
- GET
/v1/ brands - POST
/v1/ brands - GET
/v1/ brands/ {id} - GET
/v1/ brands/ {id}/ visibility
Prompts und Antworten
- GET
/v1/ brands/ {id}/ prompts - POST
/v1/ brands/ {id}/ prompts - GET
/v1/ prompts/ {id}/ responses - GET
/v1/ prompts/ {id}/ mentions
Zitationen
- GET
/v1/ brands/ {id}/ citations - GET
/v1/ brands/ {id}/ citations/ urls - GET
/v1/ brands/ {id}/ citations/ domains - GET
/v1/ brands/ {id}/ citations/ trends
Wettbewerber
- GET
/v1/ brands/ {id}/ competitors - GET
/v1/ brands/ {id}/ competitors/ trends - POST
/v1/ brands/ {id}/ tracked-competitors - POST
/v1/ brands/ {id}/ ignored-competitors
Empfehlungen und Audits
- GET
/v1/ brands/ {id}/ recommendations - POST
/v1/ brands/ {id}/ recommendations/ generate - POST
/v1/ audit-reports - GET
/v1/ audit-reports/ {id}
Content
- POST
/v1/ brands/ {id}/ generations - POST
/v1/ brands/ {id}/ generations/ {generationId}/ draft - POST
/v1/ brands/ {id}/ optimizations - GET
/v1/ brands/ {id}/ topics
Insgesamt 48 Operationen, einschließlich Updates und Löschungen. Die vollständige Referenz finden Sie in der API-Dokumentation.
Gebaut für Reporting im Produktivbetrieb
Die API liefert die Zahlen aus Ihrem Dashboard in einem Format, das direkt in ein Data Warehouse oder einen Kundenbericht passt.
Dieselben Zahlen wie im Dashboard
Vorberechnete Sichtbarkeit, Position und Share of Voice statt Rohdaten zum Zusammensetzen, damit ein Kundenbericht mit dem übereinstimmt, was Ihr Team sieht.
Lesen und Schreiben
Prompts tracken, Themen und Wettbewerber verwalten, Empfehlungen abarbeiten, Audits durchführen und Content erstellen, alles über dieselbe API.
Workspace- und markenbezogene Schlüssel
Geben Sie einem Kunden, einem Dashboard oder einem internen Team einen Schlüssel, der nur dessen eigene Marke erreicht. Ein Widerruf wird innerhalb einer Minute wirksam.
Planbare, gleichmäßige Jobs
Cursor-Paginierung, Datumsangaben nach ISO 8601 und Rate-Limit-Header in jeder Antwort, damit ein geplanter Job sein Tempo selbst regelt, ohne auf einen 429 zu stoßen.
Fehler, mit denen Sie arbeiten können
Standard-HTTP-Statuscodes mit einem stabilen Fehlercode und eine X-Request-Id in jeder Antwort, die der Support nachverfolgen kann.
Stabile Versionierung
v1 ist stabil. Neue Felder kommen ohne Ankündigung hinzu, Breaking Changes erscheinen als /v2 mit 90 Tagen Vorlauf.
Was Teams damit bauen
Kunden-Dashboards
Agenturen speisen die KI-Sichtbarkeit jedes Kunden in Looker Studio oder ihr eigenes Portal ein, mit einem markenbezogenen Schlüssel pro Kunde.
Warehouse-Synchronisierung
Ein nächtlicher Job kopiert Sichtbarkeits-, Zitations- und Wettbewerbsdaten in BigQuery oder Snowflake, neben SEO- und Analytics-Daten.
Benachrichtigungen
Eine geplante Prüfung meldet sich in Slack oder per E-Mail, wenn ein wichtiger Prompt in einer Engine abfällt.
KI-Assistenten
Derselbe Schlüssel betreibt den Geoptie MCP-Server für Claude Code, Cursor und Codex.
Enthalten in Professional und Enterprise
FAQ zur KI-Sichtbarkeits-API
Welche Daten liefert die Geoptie-API?
Welche Tarife enthalten API-Zugang?
Wie funktioniert die Authentifizierung?
Welche Rate-Limits hat die API?
Kann ich Wettbewerbsdaten über die API abrufen?
Kann ich einem Kunden API-Zugang nur zu seiner eigenen Marke geben?
Welche KI-Engines deckt die API ab?
Gibt es auch einen MCP-Server?
Stellen Sie KI-Sichtbarkeit neben Ihre übrigen Daten
Starten Sie mit Professional, erstellen Sie einen Schlüssel, und Ihre erste Anfrage liefert Ihre Marken in unter einer Minute.
Loslegen