Skip to main content

​
Changelog

​
September 2026

​
Modell-Einstellungen und Account-Limits sind jetzt in API und Dashboard identisch

Über die API angelegte Prompts konnten auf Modellen laufen, die in den Modell-Einstellungen des Projekts nicht aktiviert waren — die Dashboard-Filter zeigten deshalb weniger Modelle, als die Prompts tatsächlich trackten. Die API nutzt jetzt die Modell-Einstellungen des Projekts als Source of Truth und wendet jedes Limit an, das auch das Dashboard anwendet, mit denselben Fehlercodes. Den kompletten Agentur-Ablauf zeigt Einen Pitch automatisieren.
  • PUT /projects/{projectId} akzeptiert models — das API-Gegenstück zur Seite Modell-Einstellungen. Ersetzt das Set, synchronisiert jeden Prompt des Projekts neu (syncedPromptCount) und setzt das Modell-Limit des Tarifs, das Brand-Prompt-Budget und die Agentur-Antwortprognose durch (meteredNotice im höchsten Paket)
  • GET /projects, GET /projects/{projectId} und POST /projects liefern models (Projekteinstellung → Account-Standard) und language
  • POST /projects/{projectId}/prompts: models ist optional und nutzt standardmäßig die Modelle des Projekts; eine explizite Liste muss eine Teilmenge davon sein, sonst 400 model_not_enabled. Neue Agentur-Prüfung der Antwortprognose, wie im Dashboard
  • POST /projects wendet die Projekt-Gates des Dashboards an: Pitch-Projekte erfordern einen Agentur-Account und einen freien Pitch-Slot, Kundenprojekte einen freien Slot bei Agenturpaketen (agency_limit), und bei Brand-Tarifen gilt das Projekt-Limit des Tarifs
  • Fehler: Limit-Verletzungen liefern jetzt 403 FORBIDDEN mit einem maschinenlesbaren error.details.reason (agency_limit, prompt_budget_exceeded, prompt_limit, model_limit, model_not_available, pitch_prompt_limit, pitch_expired, pitch_project_limit) statt eines generischen 500
  • MCP list_projects liefert language, isPitch und models pro Projekt

​
Visibility = genannt ODER zitiert; neue Mention Rate und Citation Rate

Finseo trennt jetzt die beiden Arten, wie eine Marke in einer KI-Antwort auftaucht — im Antworttext genannt und als Quelle zitiert — und weist sie als eigene KPIs aus. Siehe KPIs erklärt.
  • Visibility neu definiert: Eine Antwort zählt als sichtbar, wenn die Marke im Text genannt wird oder ihre eigene Domain (bzw. ein konfigurierter Domain-Alias) als Quelle zitiert wird. Bisher zählten nur Text-Nennungen; die Visibility kann daher für Marken, deren Websites ohne Namensnennung zitiert werden, leicht höher liegen als zuvor
  • Neue KPIs: Mention Rate (Anteil der Antworten, die die Marke nennen) und Citation Rate (Anteil der Antworten, die die eigene Domain zitieren), beide mit demselben Nenner wie die Visibility. Sie überlappen sich, daher gilt Visibility ≤ Mention Rate + Citation Rate
  • REST /metrics liefert mentionRate, citationRate, cited pro Zeitraum sowie mentionRateChange, citationRateChange, citedChange; responseVisibilityRate folgt jetzt der Definition „genannt oder zitiert”
  • REST /metrics/timeseries ergänzt cited pro Tag (null für Tage aus Rollups ohne Citations)
  • REST /competitors ergänzt mentionRate, mentionRateChange, totalCitations, citationRate, citationRateChange und visibilityIsMentionOnly; visibilityRate/visibleResults folgen jetzt der Definition „genannt oder zitiert”. Standard-sortBy ist visibility
  • REST /prompts ergänzt mentionRate und citationRate pro Prompt; isVisible folgt der Definition „genannt oder zitiert”
  • MCP: get_visibility_metrics und get_visibility_timeseries liefern mentionRatePercent, citationRatePercent und ownDomainCitedAnswers; get_competitor_ranking liefert mentionRatePercent, citationRatePercent und visibilityIsMentionOnly; list_prompts liefert mentionRatePercent und citationRatePercent. visibilityRatePercent folgt überall der Definition „genannt oder zitiert”, und die Tool-Hinweise erklären die Aufteilung
  • Domain-Aliase: Zusätzliche Domains für den Citation-Abgleich (z. B. Länder-TLDs, Shop-Subdomains) lassen sich pro Projekt in den Dashboard-Einstellungen hinterlegen; sie gelten für alle Prompts des Projekts

​
Fix: Prompts aus POST /prompts werden sofort verarbeitet

Über die REST-API angelegte Prompts wurden zwar gespeichert, aber nicht für die Worker eingereiht und deshalb erst vom nächtlichen Lauf abgeholt — bei einem frischen Projekt zudem ohne Domain und Markenname des Projekts, sodass die Marke in den Antworten nie erkannt werden konnte.
  • Prompts werden jetzt sofort eingereiht (enqueued: true in der Antwort); erste Antworten liegen in der Regel nach wenigen Minuten vor
  • Der Prompt erbt Domain, Markenname (Projekt-name), Synonyme, Domain-Aliase und Tracking-Frequenz des Projekts. Projekte ohne websiteUrl werden mit 400 abgelehnt
  • language übernimmt jetzt standardmäßig die Projektsprache und wird auf die Dashboard-Schreibweise normalisiert (de → DE), damit der Länderfilter auch API-Prompts findet

​
Pitch-Projekte + Pflichtsprache

  • Pitch-Projekte über die API: POST /v1/projects akzeptiert isPitch und pitchDurationDays (1, 7 oder 14, Standard 14) – ohne Projektgebühr, auf 50 Prompts begrenzt und nach Ablauf des Pitch-Fensters automatisch pausiert. Pitch-Slots sind je Agenturpaket begrenzt (250 bei Agency Starter, 500 bei Agency Studio)
  • Gewonnene Pitches umwandeln: PUT /v1/projects/{projectId} mit {"convertFromPitch": true} macht aus einem Pitch ein vollständiges Kundenprojekt (prüft einen freien Kunden-Slot und das Antwortbudget des Tarifs und aktiviert anschließend pausierte Prompts)
  • language ist jetzt Pflicht bei POST /v1/projects – einer von 22 unterstützten Codes (en, de, fr, es, it, nl, pt, pl, sv, da, tr, ja, no, fi, cs, ru, zh, zh-tw, ko, hi, ar, he). Zuvor wurde die Sprache aus einem Website-Crawl abgeleitet, was bei nicht-englischen Märkten häufig fälschlich Englisch ergab
  • GET /v1/projects liefert jetzt isPitch für jedes Projekt sowie pitchDurationDays und pitchExpiredAt für Pitch-Projekte

​
März 2026

​
v1.0.0 - Erstes Release

  • Customer API mit 14 Endpoints für Projekte, Prompts, Metriken, Wettbewerber, Quellen, Tags und Export
  • API-Key-Authentifizierung mit granularen Scopes (read, write, export) und Projekt-Beschränkungen
  • Rate Limiting pro Plan (Starter: 60/min, Pro: 180/min, Enterprise: 600/min)
  • MCP-Server für die Integration mit Claude Desktop und Cursor