Anmerkungen

Markieren Sie ein Datum auf der Zeitachse des Projekts (etwa den Start einer Kampagne, eine Website-Migration oder eine Neugestaltung), damit ein Diagramm zeigt, was wann passiert ist. In allen Tarifen verfügbar.

POST`/annotations`

Markiert ein Datum in der Zeitreihe des Projekts mit Titel und Beschreibung. In jedem Tarif verfügbar.

Anfragetext (JSON):

project_iderforderlich
titleerforderlich
annotation_dateoptional, ISO JJJJ-MM-TT; standardmäßig heute
descriptionoptional
coloroptional, Hex-Farbcode
annotation_category_idoptional, muss zum Projekt gehören

GET /annotations + PATCH/DELETE /annotations/:id

Listet Anmerkungen auf, aktualisiert und löscht sie; in jedem Tarif verfügbar. GET liefert Anmerkungen aller Herkunftsarten (manuell, automatisch, GEO-Test und Plattform), die neuesten zuerst. Das Feld origin unterscheidet sie, und editable gibt an, ob Sie die jeweilige Zeile ändern dürfen. PATCH und DELETE funktionieren nur bei manuellen Anmerkungen, die Sie selbst erstellt haben (andernfalls 403).

GET-Parameter: project_id (erforderlich), from/to (JJJJ-MM-TT), annotation_category_id, page, per_page. PATCH-Anfragetext: eines oder mehrere der Felder title, description, annotation_date, color, annotation_category_id. DELETE: project_id + :id in der URL.

Codebeispiele

Download: OpenAPI Swagger Postman

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

Sprache

Request

curl -X POST -H "Authorization: Bearer YOUR_API_KEY" -H "Content-Type: application/json" -d '{"project_id":"PROJECT_ID","title":"Launched pricing campaign","annotation_date":"2026-06-01","color":"#2563eb"}' \
  "https://api.llmpulse.ai/api/v1/annotations"

const response = await fetch("https://api.llmpulse.ai/api/v1/annotations", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({"project_id":"PROJECT_ID","title":"Launched pricing campaign","annotation_date":"2026-06-01","color":"#2563eb"})
});
const data = await response.json();

import requests

response = requests.post(
    "https://api.llmpulse.ai/api/v1/annotations",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    json={"project_id": "PROJECT_ID", "title": "Launched pricing campaign", "annotation_date": "2026-06-01", "color": "#2563eb"}
)
data = response.json()

require 'httparty'
require 'json'

response = HTTParty.post(
  "https://api.llmpulse.ai/api/v1/annotations",
  headers: {
    "Authorization" => "Bearer YOUR_API_KEY",
    "Content-Type" => "application/json"
  },
  body: { "project_id" => "PROJECT_ID", "title" => "Launched pricing campaign", "annotation_date" => "2026-06-01", "color" => "#2563eb" }.to_json
)
data = response.parsed_response

package main

import (
	"net/http"
	"strings"
)

func main() {
	req, _ := http.NewRequest("POST", "https://api.llmpulse.ai/api/v1/annotations", strings.NewReader(`{"project_id":"PROJECT_ID","title":"Launched pricing campaign","annotation_date":"2026-06-01","color":"#2563eb"}`))
	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/annotations', [
    'headers' => ['Authorization' => 'Bearer YOUR_API_KEY'],
    'json' => ['project_id' => 'PROJECT_ID', 'title' => 'Launched pricing campaign', 'annotation_date' => '2026-06-01', 'color' => '#2563eb']
]);
$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/annotations"))
            .header("Authorization", "Bearer YOUR_API_KEY")
            .header("Content-Type", "application/json")
            .POST(HttpRequest.BodyPublishers.ofString("{\"project_id\":\"PROJECT_ID\",\"title\":\"Launched pricing campaign\",\"annotation_date\":\"2026-06-01\",\"color\":\"#2563eb\"}"))
            .build();
        HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
    }
}

Anmerkungen

POST/annotations

GET /annotations + PATCH/DELETE /annotations/:id

POST`/annotations`