KI-Modellanalyse

Aggregierte Auswertungen aus dem Bericht „KI-Modellanalyse“ der App. Alle drei Endpunkte filtern nach executed_at (nicht nach created_at) und verwenden dieselbe Standardstruktur für Akteure: { type, id, competitor_id, name, domain } mit reinen Domainnamen (ohne URL-Schema).

GET`/reports/ai_model_insights/summary`

Pro Modell: Anzahl und Anteile der Erwähnungen, Anzahl und Anteile der Zitierungen, Netto-Sentiment der Marke mit der absoluten Anzahl positiver und negativer Sentiments, Summen und Anteile der gewichteten Sichtbarkeit sowie jeweils eine Matrix nach Akteur.

Parameter:

project_iderforderlich
rangestandardmäßig 28
from
to
granularityday|week|month
collection_id
country_code
language_code
prompt_type
brand_kindnon_brand entspricht dem Tab „Übersicht“ der KI-Modellanalyse in der App und eignet sich für faire Vergleiche zwischen Marke und Wettbewerbern
competitorskommagetrennte Wettbewerber-IDs; unbekannte IDs → ERR_INVALID_PARAM

GET`/reports/ai_model_insights/position_distribution`

Vergleich der Positionsverteilung, wie ihn die KI-Modellanalyse zeigt: Datenreihen für eine oder zwei Marken mit Summen je Positionsbereich (Position 1, Position 2-3, Position 4-7, Position 8+) und Zeitreihen je Bereich für Diagramme.

Parameter:

project_iderforderlich
range
from
to
granularity
collection_id
country_code
language_code
prompt_type
brand_kindnon_brand eignet sich für einen fairen Direktvergleich und ist in der App voreingestellt
modelEinschränkung auf ein Modell
brand1
brand2Wettbewerber-IDs der verglichenen Marken; ohne brand1 wird die Projektmarke verglichen

GET`/reports/ai_model_insights/ai_overview_results`

Aggregierte Daten dazu, ob Google AI Overviews Ergebnisse liefern: Gesamtzahl der Antworten von AI Overviews, Antworten mit Ergebnissen (no_result = false), Ergebnisrate, Trenddaten für Diagramme und eine paginierte Tabelle der Ergebnisrate pro Prompt.

Parameter:

project_iderforderlich
range
from
tofiltert nach executed_at
collection_id
country_code
language_code
prompt_type
brand_kind
granularity
page
per_page

Codebeispiele

Download: OpenAPI Swagger Postman

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

Sprache

Request

curl -X GET -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.llmpulse.ai/api/v1/reports/ai_model_insights/summary?project_id=PROJECT_ID&range=28"

const response = await fetch("https://api.llmpulse.ai/api/v1/reports/ai_model_insights/summary?project_id=PROJECT_ID&range=28", {
  headers: { "Authorization": "Bearer YOUR_API_KEY" }
});
const data = await response.json();

import requests

response = requests.get(
    "https://api.llmpulse.ai/api/v1/reports/ai_model_insights/summary?project_id=PROJECT_ID&range=28",
    headers={"Authorization": "Bearer YOUR_API_KEY"}
)
data = response.json()

require 'httparty'

response = HTTParty.get(
  "https://api.llmpulse.ai/api/v1/reports/ai_model_insights/summary?project_id=PROJECT_ID&range=28",
  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/reports/ai_model_insights/summary?project_id=PROJECT_ID&range=28", 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/reports/ai_model_insights/summary?project_id=PROJECT_ID&range=28', [
    '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/reports/ai_model_insights/summary?project_id=PROJECT_ID&range=28"))
            .header("Authorization", "Bearer YOUR_API_KEY")
            .GET()
            .build();
        HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
    }
}

Request

curl -X GET -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.llmpulse.ai/api/v1/reports/ai_model_insights/position_distribution?project_id=PROJECT_ID&range=28"

const response = await fetch("https://api.llmpulse.ai/api/v1/reports/ai_model_insights/position_distribution?project_id=PROJECT_ID&range=28", {
  headers: { "Authorization": "Bearer YOUR_API_KEY" }
});
const data = await response.json();

import requests

response = requests.get(
    "https://api.llmpulse.ai/api/v1/reports/ai_model_insights/position_distribution?project_id=PROJECT_ID&range=28",
    headers={"Authorization": "Bearer YOUR_API_KEY"}
)
data = response.json()

require 'httparty'

response = HTTParty.get(
  "https://api.llmpulse.ai/api/v1/reports/ai_model_insights/position_distribution?project_id=PROJECT_ID&range=28",
  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/reports/ai_model_insights/position_distribution?project_id=PROJECT_ID&range=28", 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/reports/ai_model_insights/position_distribution?project_id=PROJECT_ID&range=28', [
    '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/reports/ai_model_insights/position_distribution?project_id=PROJECT_ID&range=28"))
            .header("Authorization", "Bearer YOUR_API_KEY")
            .GET()
            .build();
        HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
    }
}

Request

curl -X GET -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.llmpulse.ai/api/v1/reports/ai_model_insights/ai_overview_results?project_id=PROJECT_ID&range=28&per_page=50"

const response = await fetch("https://api.llmpulse.ai/api/v1/reports/ai_model_insights/ai_overview_results?project_id=PROJECT_ID&range=28&per_page=50", {
  headers: { "Authorization": "Bearer YOUR_API_KEY" }
});
const data = await response.json();

import requests

response = requests.get(
    "https://api.llmpulse.ai/api/v1/reports/ai_model_insights/ai_overview_results?project_id=PROJECT_ID&range=28&per_page=50",
    headers={"Authorization": "Bearer YOUR_API_KEY"}
)
data = response.json()

require 'httparty'

response = HTTParty.get(
  "https://api.llmpulse.ai/api/v1/reports/ai_model_insights/ai_overview_results?project_id=PROJECT_ID&range=28&per_page=50",
  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/reports/ai_model_insights/ai_overview_results?project_id=PROJECT_ID&range=28&per_page=50", 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/reports/ai_model_insights/ai_overview_results?project_id=PROJECT_ID&range=28&per_page=50', [
    '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/reports/ai_model_insights/ai_overview_results?project_id=PROJECT_ID&range=28&per_page=50"))
            .header("Authorization", "Bearer YOUR_API_KEY")
            .GET()
            .build();
        HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
    }
}

KI-Modellanalyse

GET/reports/ai_model_insights/summary

GET/reports/ai_model_insights/position_distribution

GET/reports/ai_model_insights/ai_overview_results

GET`/reports/ai_model_insights/summary`

GET`/reports/ai_model_insights/position_distribution`

GET`/reports/ai_model_insights/ai_overview_results`