Skip to main content

​
Changelog

​
Settembre 2026

​
Impostazioni modelli e limiti dell’account ora identici tra API e dashboard

I prompt creati tramite API potevano essere eseguiti su modelli non abilitati nelle Impostazioni modelli del progetto, così i filtri della dashboard mostravano meno modelli di quanti i prompt effettivamente tracciassero. L’API ora usa le impostazioni modelli del progetto come fonte di verità e applica tutti i limiti applicati dalla dashboard, con gli stessi codici di errore. Vedi Automatizza un pitch per il flusso agenzia end-to-end.
  • PUT /projects/{projectId} accetta models — l’equivalente API della pagina Impostazioni modelli. Sostituisce il set, risincronizza tutti i prompt del progetto (syncedPromptCount) e applica il numero massimo di modelli del piano, il budget di prompt Brand e la proiezione di risposte Agency (meteredNotice sul pacchetto più alto)
  • GET /projects, GET /projects/{projectId} e POST /projects restituiscono models (impostazione del progetto → predefinito dell’account) e language
  • POST /projects/{projectId}/prompts: models è facoltativo e usa come predefiniti i modelli del progetto; un elenco esplicito deve esserne un sottoinsieme, altrimenti 400 model_not_enabled. Nuovo controllo sulla proiezione di risposte Agency, identico alla dashboard
  • POST /projects applica i controlli sui progetti della dashboard: i progetti pitch richiedono un account Agency e uno slot pitch libero, i progetti cliente uno slot libero sui pacchetti Agency (agency_limit) e il numero massimo di progetti del piano sui piani Brand
  • Errori: le violazioni dei limiti ora restituiscono 403 FORBIDDEN con un error.details.reason leggibile dalla macchina (agency_limit, prompt_budget_exceeded, prompt_limit, model_limit, model_not_available, pitch_prompt_limit, pitch_expired, pitch_project_limit) invece di un generico 500
  • MCP list_projects restituisce language, isPitch e models per ogni progetto

​
Visibility = nominato O citato; nuovi Mention Rate e Citation Rate

Finseo ora distingue i due modi in cui un brand compare in una risposta AI — nominato nel testo della risposta e citato come fonte — e li riporta come KPI separati. Vedi KPI e metriche.
  • Visibility ridefinita: una risposta conta come visibile quando il brand viene nominato nel testo oppure il suo dominio (o un alias di dominio configurato) viene citato come fonte. Prima contavano solo le menzioni nel testo, quindi la Visibility può risultare leggermente più alta rispetto a prima per i brand i cui siti vengono citati senza essere nominati
  • Nuovi KPI: Mention Rate (quota di risposte che nominano il brand) e Citation Rate (quota di risposte che citano il dominio proprio), entrambi con lo stesso denominatore della Visibility. Si sovrappongono, quindi Visibility ≤ Mention Rate + Citation Rate
  • REST /metrics restituisce mentionRate, citationRate, cited per periodo, oltre a mentionRateChange, citationRateChange, citedChange; responseVisibilityRate ora usa la definizione nominato-o-citato
  • REST /metrics/timeseries aggiunge cited per giorno (null per i giorni provenienti da rollup senza citazioni)
  • REST /competitors aggiunge mentionRate, mentionRateChange, totalCitations, citationRate, citationRateChange e visibilityIsMentionOnly; visibilityRate/visibleResults ora usano la definizione nominato-o-citato. Il sortBy predefinito è visibility
  • REST /prompts aggiunge mentionRate e citationRate per Prompt; isVisible usa la definizione nominato-o-citato
  • MCP: get_visibility_metrics e get_visibility_timeseries restituiscono mentionRatePercent, citationRatePercent e ownDomainCitedAnswers; get_competitor_ranking restituisce mentionRatePercent, citationRatePercent e visibilityIsMentionOnly; list_prompts restituisce mentionRatePercent e citationRatePercent. visibilityRatePercent segue ovunque la definizione nominato-o-citato e le note dei tool spiegano la suddivisione
  • Alias di dominio: domini aggiuntivi per il matching delle citazioni (es. TLD nazionali, sottodomini shop) possono essere configurati per progetto nelle impostazioni della dashboard; si applicano a tutti i prompt del progetto

​
Fix: i Prompt creati con POST /prompts vengono elaborati subito

I Prompt aggiunti tramite l’API REST venivano salvati ma non messi in coda per i worker, quindi venivano presi in carico solo dal passaggio notturno — e, in un progetto nuovo, salvati senza dominio e nome del brand del progetto, così il brand non poteva mai essere riconosciuto nelle risposte.
  • I Prompt vengono ora messi in coda immediatamente (enqueued: true nella risposta); le prime risposte arrivano di solito entro pochi minuti
  • Il Prompt eredita dominio, nome del brand (name del progetto), sinonimi, alias di dominio e frequenza di Tracking del progetto. I progetti senza websiteUrl vengono rifiutati con 400
  • language ora usa come predefinita la lingua del progetto e viene normalizzato alla notazione della dashboard (de → DE), così il filtro paese trova anche i Prompt aggiunti via API

​
Progetti pitch + lingua obbligatoria

  • Progetti pitch tramite API: POST /v1/projects accetta isPitch e pitchDurationDays (1, 7 o 14, predefinito 14) — nessun costo di progetto, massimo 50 prompt e sospensione automatica alla chiusura della finestra. Gli slot dipendono dal piano agenzia (250 con Agency Starter, 500 con Agency Studio)
  • Conversione dei pitch vinti: PUT /v1/projects/{projectId} con {"convertFromPitch": true} trasforma un pitch in un progetto cliente completo (verifica uno slot libero e il budget di risposte, quindi riattiva i prompt sospesi)
  • language ora è obbligatorio su POST /v1/projects — uno dei 22 codici supportati (en, de, fr, es, it, nl, pt, pl, sv, da, tr, ja, no, fi, cs, ru, zh, zh-tw, ko, hi, ar, he). Prima la lingua veniva dedotta da un crawl del sito, che spesso selezionava l’inglese per mercati non anglofoni
  • GET /v1/projects ora restituisce isPitch per ogni progetto, oltre a pitchDurationDays e pitchExpiredAt per i progetti pitch

​
Marzo 2026

​
v1.0.0 - Release iniziale

  • Customer API con 14 endpoint per progetti, prompt, metriche, competitor, fonti, tag ed export
  • Autenticazione con API key con scope granulari (read, write, export) e restrizioni per progetto
  • Rate limiting per piano (Starter: 60/min, Pro: 180/min, Enterprise: 600/min)
  • MCP Server per l’integrazione con Claude Desktop e Cursor