Skip to main content

​
Changelog

​
Septembre 2026

​
Les paramètres de modèles et les limites de compte sont désormais identiques dans l’API et le dashboard

Les prompts créés via l’API pouvaient s’exécuter sur des modèles non activés dans les Model Settings du projet, si bien que les filtres du dashboard affichaient moins de modèles que ceux réellement suivis par les prompts. L’API utilise désormais les paramètres de modèles du projet comme source de vérité et applique toutes les limites appliquées par le dashboard, avec les mêmes codes d’erreur. Voir Automatiser un pitch pour le flux agence de bout en bout.
  • PUT /projects/{projectId} accepte models — l’équivalent API de la page Model Settings. Remplace l’ensemble, resynchronise chaque prompt du projet (syncedPromptCount) et applique le plafond de modèles de l’offre, le budget de prompts Brand et la projection de réponses Agency (meteredNotice sur l’offre la plus élevée)
  • GET /projects, GET /projects/{projectId} et POST /projects renvoient models (paramètre du projet → valeur par défaut du compte) et language
  • POST /projects/{projectId}/prompts : models est facultatif et prend par défaut les modèles du projet ; une liste explicite doit en être un sous-ensemble, sinon 400 model_not_enabled. Nouveau garde-fou de projection de réponses Agency, identique au dashboard
  • POST /projects applique les contrôles de projets du dashboard : les projets pitch nécessitent un compte Agency et un slot pitch libre, les projets clients un slot libre sur les offres Agency (agency_limit), et le plafond de projets de l’offre sur les offres Brand
  • Erreurs : les dépassements de limites renvoient désormais 403 FORBIDDEN avec un error.details.reason lisible par machine (agency_limit, prompt_budget_exceeded, prompt_limit, model_limit, model_not_available, pitch_prompt_limit, pitch_expired, pitch_project_limit) au lieu d’un 500 générique
  • MCP list_projects renvoie language, isPitch et models par projet

​
Visibility = nommée OU citée ; nouveaux Mention Rate et Citation Rate

Finseo distingue désormais les deux façons dont une marque apparaît dans une réponse IA — nommée dans le texte de la réponse et citée comme source — et les rapporte comme des KPIs distincts. Voir KPIs expliqués.
  • Visibility redéfinie : une réponse compte comme visible lorsque la marque est nommée dans le texte ou que son propre domaine (ou un alias de domaine configuré) est cité comme source. Auparavant, seules les mentions dans le texte comptaient ; la Visibility peut donc être légèrement plus élevée qu’avant pour les marques dont le site est cité sans être nommé
  • Nouveaux KPIs : Mention Rate (part des réponses nommant la marque) et Citation Rate (part des réponses citant le domaine propre), tous deux avec le même dénominateur que la Visibility. Ils se chevauchent, donc Visibility ≤ Mention Rate + Citation Rate
  • REST /metrics renvoie mentionRate, citationRate, cited par période ainsi que mentionRateChange, citationRateChange, citedChange ; responseVisibilityRate utilise désormais la définition nommée-ou-citée
  • REST /metrics/timeseries ajoute cited par jour (null pour les jours issus d’agrégats sans citations)
  • REST /competitors ajoute mentionRate, mentionRateChange, totalCitations, citationRate, citationRateChange et visibilityIsMentionOnly ; visibilityRate/visibleResults utilisent désormais la définition nommée-ou-citée. Le sortBy par défaut est visibility
  • REST /prompts ajoute mentionRate et citationRate par prompt ; isVisible utilise la définition nommée-ou-citée
  • MCP : get_visibility_metrics et get_visibility_timeseries renvoient mentionRatePercent, citationRatePercent et ownDomainCitedAnswers ; get_competitor_ranking renvoie mentionRatePercent, citationRatePercent et visibilityIsMentionOnly ; list_prompts renvoie mentionRatePercent et citationRatePercent. visibilityRatePercent suit partout la définition nommée-ou-citée et les notes des tools expliquent la distinction
  • Alias de domaine : des domaines supplémentaires pour la correspondance des citations (p. ex. TLD par pays, sous-domaines de boutique) peuvent être configurés par projet dans les paramètres du dashboard ; ils s’appliquent à tous les prompts du projet

​
Correctif : les prompts créés via POST /prompts sont traités immédiatement

Les prompts ajoutés via l’API REST étaient enregistrés mais pas mis en file d’attente pour les workers ; ils n’étaient donc récupérés que par le passage nocturne — et, sur un projet neuf, stockés sans le domaine ni le nom de marque du projet, si bien que la marque ne pouvait jamais être reconnue dans les réponses.
  • Les prompts sont désormais mis en file d’attente immédiatement (enqueued: true dans la réponse) ; les premières réponses arrivent généralement en quelques minutes
  • Le prompt hérite du domaine, du nom de marque (name du projet), des synonymes, des alias de domaine et de la fréquence de Tracking du projet. Les projets sans websiteUrl sont rejetés avec 400
  • language prend désormais par défaut la langue du projet et est normalisé selon la notation du dashboard (de → DE), afin que le filtre pays trouve aussi les prompts ajoutés via l’API

​
Projets pitch + langue obligatoire

  • Projets pitch via l’API : POST /v1/projects accepte isPitch et pitchDurationDays (1, 7 ou 14, 14 par défaut) — sans frais de projet, limités à 50 prompts et automatiquement suspendus à la fin de la période. Les slots dépendent de l’offre agence (250 avec Agency Starter, 500 avec Agency Studio)
  • Conversion des pitches gagnés : PUT /v1/projects/{projectId} avec {"convertFromPitch": true} transforme un pitch en projet client complet (vérifie un slot disponible et le budget de réponses, puis réactive les prompts suspendus)
  • language est désormais obligatoire sur POST /v1/projects — l’un des 22 codes pris en charge (en, de, fr, es, it, nl, pt, pl, sv, da, tr, ja, no, fi, cs, ru, zh, zh-tw, ko, hi, ar, he). Auparavant, la langue était déduite d’un crawl du site, qui choisissait souvent l’anglais pour les marchés non anglophones
  • GET /v1/projects renvoie désormais isPitch pour chaque projet, ainsi que pitchDurationDays et pitchExpiredAt pour les projets pitch

​
Mars 2026

​
v1.0.0 - Première version

  • Customer API avec 14 endpoints pour les projets, prompts, métriques, concurrents, sources, tags et export
  • Authentification par clé API avec des scopes granulaires (read, write, export) et des restrictions de projet
  • Rate Limiting par plan (Starter : 60/min, Pro : 180/min, Enterprise : 600/min)
  • Serveur MCP pour l’intégration avec Claude Desktop et Cursor