Ihr Datenteam baut das monatliche Marketing-Reporting in einem Data Warehouse. Ihre Agentur schickt ihren Kunden ein Deck, das aus einer Tabelle erzeugt wird. Ihre Geschäftsführung schaut auf ein einziges internes Dashboard und sonst nichts. Die KI-Sichtbarkeit lebt in Mentionable, und solange niemand die Zahlen von Hand abtippt, lebt sie nirgendwo sonst.
Die Mentionable-API macht das Abtippen überflüssig. Jede Zahl aus dem Dashboard steht als Zeilen bereit, die Ihre eigenen Tools lesen können, als JSON oder CSV, in dem Rhythmus, den Sie wählen.
Was liefert die Mentionable-API?
Die Mentionable-API ist eine REST-API mit reinem Lesezugriff unter /api/v1, mit vier Endpunkten, einem pro Frage, die Sie an Ihre Daten stellen.
Welche Projekte kann ich lesen? GET /api/v1/projects listet die Projekte, auf die Ihr Schlüssel Zugriff hat: Name, Website, Marke, Erstellungsdatum.
Wie entwickelt sich meine Sichtbarkeit? GET /api/v1/projects/{id}/metrics liefert eine Zeile pro Tag, KI-Engine und Prompt-Kategorie: die Zahl der Antworten, Erwähnungen, Zitierungen Ihrer Website, Erwähnungsrate, Zitierungsrate, durchschnittliche Position und die Verteilung auf positive, neutrale und negative Stimmung.
Was hat jede KI wirklich geantwortet? GET /api/v1/projects/{id}/results liefert eine Zeile pro KI-Antwort: die Frage, die Engine, das Datum, ob Ihre Marke erwähnt wurde, auf welcher Position, mit welcher Stimmung und wie viele Wettbewerber neben Ihnen genannt wurden. Die Ergebnisse sind paginiert, neueste zuerst, bis zu 1.000 Zeilen pro Seite.
Wer nimmt mir den Platz weg? GET /api/v1/projects/{id}/competitors liefert eine Zeile pro Tag, KI-Engine und Marke: Ihre Marke und jeder Wettbewerber, den Sie bestätigt haben, mit Erwähnungen, durchschnittlicher Position und Share of Voice.
Die Definitionen sind die des Dashboards. Eine Erwähnungsrate in Ihrem Warehouse ist dieselbe, die Ihr Team in Mentionable liest. Niemand diskutiert, welche Zahl stimmt.
Wie sieht ein Aufruf aus?
Eine URL, ein Schlüssel, optionale Filter:
curl -H "Authorization: Bearer mnt_sk_..." \
"https://mentionable.ai/api/v1/projects/{id}/metrics?from=2026-09-01&to=2026-09-30&llm=chatgpt,perplexity"
Alle Endpunkte akzeptieren dieselben Filter:
| Parameter | Funktion |
|---|---|
from, to |
Zeitraum, bis zu 366 Tage pro Aufruf. Standard: die letzten 30 Tage. |
llm |
Eine oder mehrere KI-Engines, durch Kommas getrennt. |
categoryId |
Nur eine Prompt-Kategorie. |
format |
json (Standard) oder csv. |
limit, cursor |
Seitengröße und nächste Seite, bei den Ergebnissen. |
Die Zeilen sind bewusst flach. Zähler wie mentions und results lassen sich über jede Dimension summieren, pro Monat, pro Engine, pro Kategorie, und die Raten werden daraus neu berechnet. Eine Monatssumme stimmt also mit dem Dashboard überein, statt tägliche Prozentwerte zu mitteln.
Fehler kommen als JSON zurück, mit einem maschinenlesbaren Code und einer verständlichen Meldung: fehlender Schlüssel, Angebot erforderlich, Projekt außerhalb des Zugriffs, ungültige Anfrage.
Wo ist die Dokumentation?
Unter mentionable.ai/api/v1/docs, einer interaktiven Referenz, in die Sie einen Schlüssel einfügen und jeden Endpunkt testen. Derselbe Vertrag liegt als OpenAPI-Datei unter /api/v1/openapi.json, die die meisten HTTP-Clients, Code-Generatoren und No-Code-Tools direkt importieren.
Wie sind API-Schlüssel abgesichert?
Schlüssel werden unter Einstellungen, MCP von einem Owner oder Admin des Workspace erstellt. Der vollständige Schlüssel wird einmal angezeigt, bei der Erstellung. Danach zeigt die Liste nur die ersten Zeichen, den Zugriffsbereich, die letzte Nutzung und den Status: aktiv, abgelaufen oder widerrufen.
Ein Schlüssel lässt sich auf eine Liste von Projekten einschränken. Er listet und liest dann nur diese Projekte, jeder Aufruf auf ein anderes Projekt wird abgelehnt. Ein Schlüssel liest nie mehr als die Person, die ihn erstellt hat: Hat ein Teammitglied nur Zugriff auf zwei Projekte, erreichen seine Schlüssel kein drittes.
Die API liest nur. Kein Endpunkt erstellt, ändert oder löscht etwas, ein geleakter Schlüssel kann Ihr Tracking also nicht verändern. Widerrufen Sie ihn mit einem Klick, und der nächste Aufruf wird abgelehnt.
Wer nutzt die Mentionable-API?
Marken mit einem Datenteam. Die KI-Sichtbarkeit landet bei Ihren übrigen Marketingdaten im Warehouse oder BI-Tool, neben Traffic, Paid und CRM. Das wöchentliche Marketing-Review zeigt sie, ohne dass jemand eine Datei exportiert.
Agenturen. Holen Sie die Kennzahlen jedes Kunden in den Reporting-Stack, den Sie ohnehin verkaufen, und geben Sie einem Kunden einen auf sein Projekt beschränkten Schlüssel, wenn sein Team die Rohdaten möchte.
Alle mit einer Tabelle. format=csv und ein Schlüssel in der URL reichen, damit Google Sheets oder Excel eine aktuelle Tabelle lesen.
Wenn Sie in Looker Studio arbeiten, liest der Looker-Studio-Connector dieselben Daten ohne Code. Wenn Sie lieber in natürlicher Sprache fragen, lässt der MCP-Server Claude, ChatGPT oder Cursor Ihre Projekte mit demselben Schlüssel lesen.
Welche Angebote enthalten die API?
Jedes Mentionable-Angebot, für Marken wie für Agenturen, enthält die API, den MCP-Server und den Looker-Studio-Connector. Sie funktioniert auch während der 7-tägigen kostenlosen Testphase, Sie können Ihr Reporting also anbinden, bevor Sie abonnieren.
Das Lesen von Daten über die API verbraucht nichts aus Ihrem Angebot. Die einzige Grenze ist technisch: 100 Anfragen pro Minute und Schlüssel, gemeinsam mit dem MCP-Server. Darüber antwortet die API mit 429 und einem Retry-After-Header.