API-Dokumentation

Greifen Sie über die REST-API, die native Rust-CLI, offizielle SDKs für 12 Programmiersprachen oder MCP auf Ihre Daten zur KI-Sichtbarkeit zu. Erstellen Sie Dashboards, ETL-Pipelines und automatisierte Arbeitsabläufe.

Kostenlos starten OpenAPI-Dokument herunterladen

API von LLM Pulse

Erstellen Sie Dashboards, ETL-Pipelines und Automatisierungen mit einer klar strukturierten, sauber typisierten API.

LLM Pulse ist eine Plattform zur Analyse der KI-Sichtbarkeit, die beobachtet, wie Ihre Marke in KI-generierten Antworten von ChatGPT, Perplexity, Gemini und anderen LLMs erscheint. Die API gibt Ihnen programmatischen Zugriff auf alle Ihre Sichtbarkeitsdaten, darunter Markenerwähnungen, zitierte Quellen, Sentiment-Analyse und Kennzahlen zum Share of Voice. Nutzen Sie die API, um eigene Dashboards zu erstellen, Berichte zu automatisieren oder das Tracking Ihrer KI-Sichtbarkeit in Ihre bestehenden Tools zu integrieren.

Authentifizierung

Verwenden Sie Ihren API-Schlüssel als Bearer-Token.

Authorization: Bearer YOUR_API_KEY

Basis-URL

Verwenden Sie diese Basis-URL für alle unten aufgeführten Endpunkte. Die Beispiele enthalten bereits den vollständigen Pfad.

https://api.llmpulse.ai/api/v1

Using an AI agent? Read the llms.txt

We serve a machine-readable version of these docs so coding agents (Claude Code, Cursor, ChatGPT, etc.) can find the right endpoint without parsing this page.

/api-docs/llms.txt : short index, generated from the live route table.

/api-docs/llms-full.txt : full reference (every endpoint, every parameter).

100 % Parität zwischen Oberfläche und API: Lücke gefunden? Wir schließen sie

Unser Ziel ist 100 % Parität zwischen Oberfläche und API: Alles, was Sie im Dashboard von LLM Pulse sehen, soll auch über die API erreichbar sein. Wenn Sie eine Lücke finden, melden Sie sie uns. Wir verpflichten uns, sie zu schließen, in der Regel innerhalb von wenigen Stunden bis zu einigen Tagen.

Authentifizierung

Senden Sie Ihren Schlüssel im Authorization-Header als Bearer-Token. Erneuern oder widerrufen können Sie ihn unter Einstellungen → API-Schlüssel.

Bei fehlendem oder fehlerhaftem Header antwortet die API mit 401 ERR_MISSING_AUTH, bei einem unbekannten Schlüssel mit 401 ERR_INVALID_API_KEY und bei einem widerrufenen Schlüssel mit 403 ERR_REVOKED_API_KEY.

Jeder Aufruf wird im Kontext des Kontos ausgeführt, dem der API-Schlüssel zugeordnet ist. Die Projekte müssen zu diesem Konto gehören, andernfalls wird 404 ERR_PROJECT_NOT_FOUND zurückgegeben.

Schreibende Endpunkte (POST/PATCH/PUT/DELETE) erfordern einen API-Schlüssel mit dem Zugriffsumfang read_write. Ein Token mit dem Zugriffsumfang read erhält dort 403 ERR_INSUFFICIENT_SCOPE. Für Schreibanfragen gilt zusätzlich zum globalen Budget von 300 Anfragen pro Minute und Schlüssel ein gemeinsames, strengeres Anfragelimit (60 Anfragen pro Minute und Schlüssel).

Schnellstart

Der logische Ablauf: Ressourcen auflisten → (optional) Dimensionen abrufen → Kennzahlen abfragen. Der erste Aufruf von /dimensions/projects validiert bereits Ihren API-Schlüssel.

Listen Sie Ihre Projekte auf: GET /dimensions/projects
(Optional) Rufen Sie die Dimensionen des Projekts ab (Wettbewerber, Modelle, Länder und Sprachen, Tags)
Fragen Sie Kennzahlen unter /metrics/* ab

Verbindungstest

GET/ping

Der günstigste Weg, um zu prüfen, ob ein Schlüssel funktioniert, und die Round-Trip-Latenz zu messen. Liefert ok, die user_id des authentifizierten Kontos und eine request_id. Übergeben Sie project_id, um zusätzlich zu prüfen, ob der Schlüssel auf dieses Projekt zugreifen kann: Die Antwort enthält dann außerdem project mit id, name und brand_name.

Parameter:

project_idoptional

Konto & Limits

GET/account

Liefert den Tarif, den Tracking-Rhythmus, die Laufzeit des Abonnements, die Nutzung jedes Kontingents (Prompts, Projekte, Wettbewerber pro Projekt, Aufgaben im GEO Writer pro Monat, Teammitglieder) und die API-Anfragelimits, die für Ihren Schlüssel gelten. Rufen Sie den Endpunkt vor jeder Aktion auf, die auf ein Kontingent angerechnet wird. So können Sie angeben, wie viel noch übrig ist, statt die Obergrenze erst zu bemerken, wenn Sie an sie stoßen. Die Limits richten sich nach dem Kontoinhaber, daher sehen Teammitglieder die Kapazität, die für sie gilt. Bei einem unbegrenzten Kontingent liefert der Endpunkt limit und remaining als null und setzt unlimited auf true.

Parameter: keine.

Offizielle CLI & SDKs

Nutzen Sie die native CLI im Terminal oder binden Sie ein typisiertes SDK in Ihre Anwendung ein. Die SDKs werden aus dem veröffentlichten OpenAPI-Dokument generiert; die CLI wird separat auf Basis derselben API-Spezifikation gepflegt. Beide verwenden die API-Schlüssel und die Basis-URL aus dieser Referenz.

Rust-CLI

Ein nativer Rust-Client für macOS, Linux und Windows mit benannten Profilen und Ausgabe als JSON, Tabelle oder CSV. Nutzen Sie ihn für schnelle Prüfungen, Shell-Skripte, geplante Exporte und CI-Jobs.

npm install -g @llmpulse/cli

CLI herunterladen CLI-Anleitung lesen

SDKs für 12 Programmiersprachen

Offizielle generierte Clients für TypeScript, Python, Go, Java, Kotlin, C#, PHP, Ruby, Rust, Swift, Dart und R. Jeder Client bleibt auf dem Stand des veröffentlichten OpenAPI-Dokuments.

SDK-Repositorys ansehen SDK-Anleitung lesen

API-Playground

API-Endpunkte live testen

API-Schlüssel

Endpunkt

Parameter

Anfragevorschau

curl -X GET "https://api.llmpulse.ai/api/v1/ping" -H "Authorization: Bearer YOUR_API_KEY"

Antwort

\--

Die Antwort wird hier angezeigt …

Registrieren Sie sich, um Ihren API-Schlüssel zu erhalten und mit dem Testen zu beginnen.

API-Schlüssel erhalten

Codebeispiele

Download: OpenAPI Swagger Postman

KI fragen: In ChatGPT öffnen In Claude öffnen Als Markdown anzeigen

Sprache

Quick Start Example

curl -X GET -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.llmpulse.ai/api/v1/metrics/timeseries?project_id=PROJECT_ID&metrics=mentions,visibility&granularity=day&range=30"

const response = await fetch("https://api.llmpulse.ai/api/v1/metrics/timeseries?project_id=PROJECT_ID&metrics=mentions,visibility&granularity=day&range=30", {
  headers: { "Authorization": "Bearer YOUR_API_KEY" }
});
const data = await response.json();

import requests

response = requests.get(
    "https://api.llmpulse.ai/api/v1/metrics/timeseries?project_id=PROJECT_ID&metrics=mentions,visibility&granularity=day&range=30",
    headers={"Authorization": "Bearer YOUR_API_KEY"}
)
data = response.json()

require 'httparty'

response = HTTParty.get(
  "https://api.llmpulse.ai/api/v1/metrics/timeseries?project_id=PROJECT_ID&metrics=mentions,visibility&granularity=day&range=30",
  headers: { "Authorization" => "Bearer YOUR_API_KEY" }
)
data = response.parsed_response

package main

import "net/http"

func main() {
	req, _ := http.NewRequest("GET", "https://api.llmpulse.ai/api/v1/metrics/timeseries?project_id=PROJECT_ID&metrics=mentions,visibility&granularity=day&range=30", nil)
	req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
	client := &http.Client{}
	resp, err := client.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()
}

$client = new GuzzleHttp\Client();
$response = $client->request('GET', 'https://api.llmpulse.ai/api/v1/metrics/timeseries?project_id=PROJECT_ID&metrics=mentions,visibility&granularity=day&range=30', [
    'headers' => ['Authorization' => 'Bearer YOUR_API_KEY']
]);
$data = json_decode($response->getBody(), true);

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class Main {
    public static void main(String[] args) throws Exception {
        HttpClient client = HttpClient.newHttpClient();
        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create("https://api.llmpulse.ai/api/v1/metrics/timeseries?project_id=PROJECT_ID&metrics=mentions,visibility&granularity=day&range=30"))
            .header("Authorization", "Bearer YOUR_API_KEY")
            .GET()
            .build();
        HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
    }
}

Authorization Header

curl -X GET -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.llmpulse.ai/api/v1/ping"

package main

import "net/http"

func main() {
	req, _ := http.NewRequest("GET", "https://api.llmpulse.ai/api/v1/ping", nil)
	req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
	client := &http.Client{}
	resp, err := client.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()
}

$client = new GuzzleHttp\Client();
$response = $client->request('GET', 'https://api.llmpulse.ai/api/v1/ping', [
    'headers' => ['Authorization' => 'Bearer YOUR_API_KEY']
]);
$data = json_decode($response->getBody(), true);

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class Main {
    public static void main(String[] args) throws Exception {
        HttpClient client = HttpClient.newHttpClient();
        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create("https://api.llmpulse.ai/api/v1/ping"))
            .header("Authorization", "Bearer YOUR_API_KEY")
            .GET()
            .build();
        HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
    }
}

Die API-Referenz im Überblick

Alle Endpunkte, gruppiert nach der Ressource, zu der sie gehören.

Grundkonzepte

Die Regeln, die für alle Endpunkte gelten: Filter, Definitionen der Kennzahlen, Ausgabe als JSON und CSV, Caching, Fehlercodes und Versionierung.

Projekte

Ein Projekt steht für eine Marke im Tracking: mit Domain, Land und Sprache, Prompts und Wettbewerbern. Fast jeder andere Endpunkt erwartet eine project_id.

Kennzahlen

Aggregierte Daten zu Sichtbarkeit, Share of Voice, Zitierungen und Positionen für Ihre Marke und ihre Wettbewerber, direkt für Diagramme nutzbar.

Wettbewerber

Die Marken, die Sie neben Ihrer eigenen beobachten.

Prompts

Die Fragen, die wir im eingestellten Tracking-Rhythmus des Kontos an KI-Modelle stellen, und die Datensätze der Ausführungen, die jeder Durchlauf erzeugt.

Collections & Tags

Collections (in der App: Tags) gruppieren Prompts nach Thema, Funnel-Phase oder Kampagne, sodass sich jede Kennzahl danach filtern lässt.

Antworten (KI-Antworten)

Die KI-Antworten hinter jeder Kennzahl, mit vollständigem Text, Erwähnungen, Zitierungen und Sentiment-Analyse.

Erwähnungen & Zitierungen

Die Rohdaten hinter den Sichtbarkeitskennzahlen: eine Zeile pro Markenerwähnung oder pro zitierter URL.

Sentiment

Sentiment-Datensätze mit ihren Kommentaren, Themen und Scores sowie dem Kategorienkatalog, mit dem sie klassifiziert werden. Verfügbar ab Tarif Growth.

Quellen & Zitierungsanalyse

Jede URL, die die Modelle zitiert haben, dazu gruppierte Ansichten nach URL, Domain und Host, Metadaten aus dem Seiten-Cache, Belege für Erwähnungen auf den...

KI-Modellanalyse

Aggregierte Auswertungen aus dem Bericht „KI-Modellanalyse“ der App.

KI- und Agenten-Traffic

Was KI tatsächlich auf Ihre Website bringt: Der Verweis-Traffic umfasst Menschen, die über KI-Assistenten zu Ihnen kommen, und der Agenten-Traffic die...

Shopping & Anzeigen

Kommerzielle Formate in KI-Antworten: die Produktkarten, die von den Modellen zurückgegeben werden, die bezahlten Platzierungen, die daneben erscheinen, und...

Owned Media & Communitys

Welche Ihrer eigenen Kanäle und welche Community-Diskussionen in KI-Antworten zitiert werden.

Reputation & Studien

Analyseberichte mehrerer KI-Modelle: die monatliche Reputationsbewertung Ihrer Marke im Vergleich zu ihren Wettbewerbern und die individuellen KI-Studien,...

Search Console

Leistungsdaten aus der Google Search Console (Impressionen, Klicks, CTR, durchschnittliche Position) für Projekte mit verbundener GSC-Property.

Individuelle Berichte

Die individuellen Berichte, die im Bereich „Individuelle Berichte“ der App erstellt wurden: Listen Sie diese Berichte auf, rufen Sie einen davon mit den...

Empfehlungen

Dieselben Empfehlungsdurchläufe, auf denen die Seite „Empfehlungen“ in der App basiert, dazu der Endpunkt, der einen neuen Durchlauf startet.

GEO Writer

Erstellen und verwalten Sie KI-gestützte Aufgaben im GEO Writer.

Technische GEO-Berichte

Starten Sie die technische GEO-Analyse für eine URL. Anschließend können Sie die einzelnen Berichte auflisten, regelmäßig abfragen und abrufen.

GEO-Audits

Überwachen Sie eine Domain oder URL mit einer technischen GEO-Prüfung und verfolgen Sie die Entwicklung.

Anmerkungen

Markieren Sie ein Datum auf der Zeitachse des Projekts (etwa den Start einer Kampagne, eine Website-Migration oder eine Neugestaltung), damit ein Diagramm...

Team

Verwalten Sie das Team des Kontos: Mitglieder und ausstehende Einladungen auflisten, eine Person per E-Mail einladen und ihr Projekte und Zugriffsrechte...

API-Schlüssel

Listen Sie Ihre API-Schlüssel auf, erstellen Sie einen auf bestimmte Projekte beschränkten Schlüssel, zum Beispiel einen pro Kundenprojekt, und widerrufen...

Shop-Integrationen

Die Endpunkte hinter der App LLM Pulse für Shopify: einen Shop seinem Projekt zuordnen, über KI-Assistenten vermittelte Bestellungen des Shops übermitteln...

Webhooks

Erhalten Sie bei jedem Ereignis in einem Projekt eine signierte HTTP-POST-Anfrage, ganz ohne regelmäßige Abfragen.

Integrationen

Fertige Lösungen für den Aufruf der API: Codebeispiele in sieben Programmiersprachen, die Postman-Collection und der MCP-Server für KI-Clients.

OAuth 2.1

OAuth 2.1 mit PKCE und Dynamic Client Registration: So kann sich ein MCP-Client mit LLM Pulse verbinden, ohne dass ein API-Schlüssel eingefügt werden muss.

Changelog

Alle Änderungen an der REST-API und den MCP-Tools, die neuesten zuerst.