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 Daten aller Abschnitte (Widgets) so ab, wie die Berichtsseite sie zeigt, und senden Sie ihn sofort an die hinterlegten E-Mail-Adressen. Verfügbar ab Tarif Scale. Die hinterlegten E-Mail-Adressen, das Token des öffentlichen Links und das Passwort werden nie zurückgegeben.

GET`/custom_reports`

Die individuellen Berichte des Projekts, die neuesten zuerst, jeweils mit dem Zeitraum, dem Zeitplan für den E-Mail-Versand, der Anzahl der hinterlegten E-Mail-Adressen, der Angabe, ob der Bericht über einen öffentlichen Link veröffentlicht ist, und den Abschnitten (Widgets), die er enthält. Auch als MCP-Tool list_custom_reports verfügbar.

Parameter:

project_iderforderlich
page
per_pagestandardmäßig 20, maximal 100
output

GET`/custom_reports/:id`

Die Konfiguration eines Berichts (Zeitraum, Filter für KI-Modell, Tags, Markenbezug und Wettbewerber, Zeitplan, Layout) und die Daten aller Abschnitte (Widgets), zum Zeitpunkt des Abrufs berechnet. Es sind dieselben Zahlen, die auch die Berichtsseite, der öffentliche Link und das PDF zeigen. Jeder Abschnitt hat ein Feld kind und ein Objekt data, dessen Aufbau sich nach diesem Feld richtet: series (timeseries), slices (donut), bars (bar), values und changes (kpi_grid) oder rows (table). Ein Abschnitt, dessen Datenquelle nicht verbunden ist, hat available: false. Der Endpunkt greift nur lesend zu. Auch als MCP-Tool get_custom_report verfügbar.

Parameter:

project_iderforderlich
:idin der URL

Für einen Bericht außerhalb des Projekts wird ERR_NOT_FOUND zurückgegeben.

POST`/custom_reports/:id/send`

Sendet den Bericht sofort an die hinterlegten E-Mail-Adressen, wie mit der Schaltfläche „Jetzt senden“ auf der Berichtsseite: Der Bericht muss veröffentlicht sein und mindestens eine hinterlegte E-Mail-Adresse haben (andernfalls ERR_INVALID_PARAM), und jeder Bericht kann höchstens einmal alle 10 Minuten gesendet werden (429 ERR_RATE_LIMITED mit Retry-After). Sobald das PDF in der Warteschlange steht, antwortet die API mit 202. Aus einem White-Label-Portal heraus und für Berichte, die in einem solchen Portal erstellt wurden, ist der Endpunkt nicht verfügbar (ERR_INTEGRATION_UNAVAILABLE). Erfordert einen API-Schlüssel mit Schreibzugriff und bei Teammitgliedern die Berechtigung „Aktualisieren“ für individuelle Berichte. Auch als MCP-Tool send_custom_report verfügbar.

Pfad:

:idBerichts-ID

Anfragetext (JSON): project_id (erforderlich).

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/custom_reports?project_id=PROJECT_ID"

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

import requests

response = requests.get(
    "https://api.llmpulse.ai/api/v1/custom_reports?project_id=PROJECT_ID",
    headers={"Authorization": "Bearer YOUR_API_KEY"}
)
data = response.json()

require 'httparty'

response = HTTParty.get(
  "https://api.llmpulse.ai/api/v1/custom_reports?project_id=PROJECT_ID",
  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/custom_reports?project_id=PROJECT_ID", 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/custom_reports?project_id=PROJECT_ID', [
    '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/custom_reports?project_id=PROJECT_ID"))
            .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/custom_reports/42?project_id=PROJECT_ID"

const response = await fetch("https://api.llmpulse.ai/api/v1/custom_reports/42?project_id=PROJECT_ID", {
  headers: { "Authorization": "Bearer YOUR_API_KEY" }
});
const data = await response.json();

import requests

response = requests.get(
    "https://api.llmpulse.ai/api/v1/custom_reports/42?project_id=PROJECT_ID",
    headers={"Authorization": "Bearer YOUR_API_KEY"}
)
data = response.json()

require 'httparty'

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

Request

curl -X POST -H "Authorization: Bearer YOUR_API_KEY" -H "Content-Type: application/json" -d '{"project_id":"PROJECT_ID"}' \
  "https://api.llmpulse.ai/api/v1/custom_reports/42/send"

const response = await fetch("https://api.llmpulse.ai/api/v1/custom_reports/42/send", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({"project_id":"PROJECT_ID"})
});
const data = await response.json();

import requests

response = requests.post(
    "https://api.llmpulse.ai/api/v1/custom_reports/42/send",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    json={"project_id": "PROJECT_ID"}
)
data = response.json()

require 'httparty'
require 'json'

response = HTTParty.post(
  "https://api.llmpulse.ai/api/v1/custom_reports/42/send",
  headers: {
    "Authorization" => "Bearer YOUR_API_KEY",
    "Content-Type" => "application/json"
  },
  body: { "project_id" => "PROJECT_ID" }.to_json
)
data = response.parsed_response

package main

import (
	"net/http"
	"strings"
)

func main() {
	req, _ := http.NewRequest("POST", "https://api.llmpulse.ai/api/v1/custom_reports/42/send", strings.NewReader(`{"project_id":"PROJECT_ID"}`))
	req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
	req.Header.Set("Content-Type", "application/json")
	client := &http.Client{}
	resp, err := client.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()
}

$client = new GuzzleHttp\Client();
$response = $client->request('POST', 'https://api.llmpulse.ai/api/v1/custom_reports/42/send', [
    'headers' => ['Authorization' => 'Bearer YOUR_API_KEY'],
    'json' => ['project_id' => 'PROJECT_ID']
]);
$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/custom_reports/42/send"))
            .header("Authorization", "Bearer YOUR_API_KEY")
            .header("Content-Type", "application/json")
            .POST(HttpRequest.BodyPublishers.ofString("{\"project_id\":\"PROJECT_ID\"}"))
            .build();
        HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
    }
}

Individuelle Berichte

GET/custom_reports

GET/custom_reports/:id

POST/custom_reports/:id/send

GET`/custom_reports`

GET`/custom_reports/:id`

POST`/custom_reports/:id/send`