Skip to main content

​
Changelog

​
Septiembre de 2026

​
Los ajustes de modelos y los límites de cuenta ahora son idénticos en la API y en el dashboard

Los prompts creados a través de la API podían ejecutarse en modelos que no estaban habilitados en los Model Settings del proyecto, por lo que los filtros del dashboard mostraban menos modelos de los que realmente trackeaban los prompts. La API ahora usa los ajustes de modelos del proyecto como fuente de verdad y aplica todos los límites que aplica el dashboard, con los mismos códigos de error. Consulta Automatizar un pitch para el flujo completo de agencia.
  • PUT /projects/{projectId} acepta models — el equivalente en la API de la página Model Settings. Reemplaza el conjunto, vuelve a sincronizar todos los prompts del proyecto (syncedPromptCount) y aplica el máximo de modelos del plan, el presupuesto de prompts de Brand y la proyección de respuestas de Agency (meteredNotice en el paquete superior)
  • GET /projects, GET /projects/{projectId} y POST /projects devuelven models (ajuste del proyecto → valor predeterminado de la cuenta) y language
  • POST /projects/{projectId}/prompts: models es opcional y usa por defecto los modelos del proyecto; una lista explícita debe ser un subconjunto de ellos; de lo contrario, 400 model_not_enabled. Nueva comprobación de proyección de respuestas de Agency, igual que en el dashboard
  • POST /projects aplica las mismas puertas de proyecto que el dashboard: los proyectos pitch requieren una cuenta Agency y un slot de pitch libre, los proyectos de cliente un slot libre en los paquetes Agency (agency_limit) y el máximo de proyectos del plan en los planes Brand
  • Errores: las infracciones de límites ahora devuelven 403 FORBIDDEN con un error.details.reason legible por máquina (agency_limit, prompt_budget_exceeded, prompt_limit, model_limit, model_not_available, pitch_prompt_limit, pitch_expired, pitch_project_limit) en lugar de un 500 genérico
  • MCP list_projects devuelve language, isPitch y models por proyecto

​
Visibility = nombrada O citada; nuevas Mention Rate y Citation Rate

Finseo ahora separa las dos formas en que una marca aparece en una respuesta de IA — nombrada en el texto de la respuesta y citada como fuente — y las reporta como KPIs distintos. Consulta KPIs explicados.
  • Visibility redefinida: una respuesta cuenta como visible cuando la marca se nombra en el texto o se cita su propio dominio (o un alias de dominio configurado) como fuente. Antes solo contaban las menciones en el texto, por lo que Visibility puede ser ligeramente mayor que antes para marcas cuyos sitios se citan sin ser nombradas
  • Nuevos KPIs: Mention Rate (proporción de respuestas que nombran la marca) y Citation Rate (proporción de respuestas que citan el propio dominio), ambas con el mismo denominador que Visibility. Se solapan, por lo que Visibility ≤ Mention Rate + Citation Rate
  • REST /metrics devuelve mentionRate, citationRate y cited por periodo, además de mentionRateChange, citationRateChange y citedChange; responseVisibilityRate ahora usa la definición nombrada-o-citada
  • REST /metrics/timeseries añade cited por día (null en días servidos desde rollups sin citaciones)
  • REST /competitors añade mentionRate, mentionRateChange, totalCitations, citationRate, citationRateChange y visibilityIsMentionOnly; visibilityRate/visibleResults ahora usan la definición nombrada-o-citada. El sortBy predeterminado es visibility
  • REST /prompts añade mentionRate y citationRate por prompt; isVisible usa la definición nombrada-o-citada
  • MCP: get_visibility_metrics y get_visibility_timeseries devuelven mentionRatePercent, citationRatePercent y ownDomainCitedAnswers; get_competitor_ranking devuelve mentionRatePercent, citationRatePercent y visibilityIsMentionOnly; list_prompts devuelve mentionRatePercent y citationRatePercent. visibilityRatePercent sigue en todos los casos la definición nombrada-o-citada y las notas de los tools explican la separación
  • Alias de dominio: se pueden configurar dominios adicionales para la coincidencia de citaciones (p. ej. TLDs de país, subdominios de tienda) por proyecto en los ajustes del dashboard; se aplican a todos los prompts del proyecto

​
Corrección: los Prompts creados con POST /prompts se procesan de inmediato

Los Prompts añadidos a través de la API REST se guardaban, pero no se ponían en cola para los workers, por lo que solo los recogía el barrido nocturno; además, en un proyecto nuevo se almacenaban sin el dominio ni el nombre de marca del proyecto, de modo que la marca nunca podía reconocerse en las respuestas.
  • Los Prompts ahora se ponen en cola de inmediato (enqueued: true en la respuesta); las primeras respuestas suelen llegar en pocos minutos
  • El Prompt hereda el dominio, el nombre de marca (name del proyecto), los sinónimos, los alias de dominio y la frecuencia de Tracking del proyecto. Los proyectos sin websiteUrl se rechazan con 400
  • language ahora usa por defecto el idioma del proyecto y se normaliza a la notación del dashboard (de → DE), para que el filtro de país encuentre también los Prompts añadidos por API

​
Proyectos pitch + idioma obligatorio

  • Proyectos pitch mediante API: POST /v1/projects acepta isPitch y pitchDurationDays (1, 7 o 14, predeterminado 14): sin coste de proyecto, máximo 50 prompts y pausa automática al cerrar la ventana. Los slots dependen del paquete de agencia (250 en Agency Starter, 500 en Agency Studio)
  • Conversión de pitches ganados: PUT /v1/projects/{projectId} con {"convertFromPitch": true} convierte un pitch en proyecto de cliente completo (comprueba un slot libre y el presupuesto de respuestas y reactiva los prompts pausados)
  • language ahora es obligatorio en POST /v1/projects: uno de los 22 códigos compatibles (en, de, fr, es, it, nl, pt, pl, sv, da, tr, ja, no, fi, cs, ru, zh, zh-tw, ko, hi, ar, he). Antes se infería mediante un rastreo del sitio, que a menudo elegía inglés para mercados no anglófonos
  • GET /v1/projects ahora devuelve isPitch en cada proyecto, además de pitchDurationDays y pitchExpiredAt en proyectos pitch

​
Marzo de 2026

​
v1.0.0 - Lanzamiento inicial

  • Customer API con 14 endpoints para proyectos, prompts, métricas, competidores, fuentes, tags y exportación
  • Autenticación con API key con scopes granulares (read, write, export) y restricciones por proyecto
  • Rate limiting por plan (Starter: 60/min, Pro: 180/min, Enterprise: 600/min)
  • Servidor MCP para la integración con Claude Desktop y Cursor