Métricas del proyecto (resumen)

curl --request GET \
  --url 'https://api.finseo.ai/v1/projects/67a1c2d3e4f5061728394a5b/metrics?timeframe=30d' \
  --header 'Authorization: Bearer sk_live_xxxxxxxx'

import requests

r = requests.get(
    "https://api.finseo.ai/v1/projects/67a1c2d3e4f5061728394a5b/metrics",
    headers={"Authorization": "Bearer sk_live_xxxxxxxx"},
    params={"timeframe": "30d", "language": "en"},
)
metrics = r.json()["data"]
print(metrics["current"]["visibilityRate"], metrics["changes"]["visibilityRateChange"])

{
  "data": {
    "current": {
      "visible": 28,
      "notVisible": 14,
      "mentions": 156,
      "totalResponses": 84,
      "visibilityRate": 66.67,
      "responseVisibilityRate": 52.38,
      "position": 22.4,
      "sentiment": 0.78,
      "periodStart": "2026-02-27",
      "periodEnd": "2026-03-28"
    },
    "previous": {
      "visible": 22,
      "notVisible": 20,
      "mentions": 118,
      "totalResponses": 76,
      "visibilityRate": 52.38,
      "responseVisibilityRate": 45.2,
      "position": 28.1,
      "sentiment": 0.71,
      "periodStart": "2026-01-28",
      "periodEnd": "2026-02-26"
    },
    "changes": {
      "visibleChange": 6,
      "visibilityRateChange": 14.29,
      "responseVisibilityRateChange": 7.18,
      "mentionsChange": 38,
      "positionChange": -5.7,
      "sentimentChange": 0.07
    }
  }
}

GET

projects

{projectId}

metrics

curl --request GET \
  --url 'https://api.finseo.ai/v1/projects/67a1c2d3e4f5061728394a5b/metrics?timeframe=30d' \
  --header 'Authorization: Bearer sk_live_xxxxxxxx'

import requests

r = requests.get(
    "https://api.finseo.ai/v1/projects/67a1c2d3e4f5061728394a5b/metrics",
    headers={"Authorization": "Bearer sk_live_xxxxxxxx"},
    params={"timeframe": "30d", "language": "en"},
)
metrics = r.json()["data"]
print(metrics["current"]["visibilityRate"], metrics["changes"]["visibilityRateChange"])

{
  "data": {
    "current": {
      "visible": 28,
      "notVisible": 14,
      "mentions": 156,
      "totalResponses": 84,
      "visibilityRate": 66.67,
      "responseVisibilityRate": 52.38,
      "position": 22.4,
      "sentiment": 0.78,
      "periodStart": "2026-02-27",
      "periodEnd": "2026-03-28"
    },
    "previous": {
      "visible": 22,
      "notVisible": 20,
      "mentions": 118,
      "totalResponses": 76,
      "visibilityRate": 52.38,
      "responseVisibilityRate": 45.2,
      "position": 28.1,
      "sentiment": 0.71,
      "periodStart": "2026-01-28",
      "periodEnd": "2026-02-26"
    },
    "changes": {
      "visibleChange": 6,
      "visibilityRateChange": 14.29,
      "responseVisibilityRateChange": 7.18,
      "mentionsChange": 38,
      "positionChange": -5.7,
      "sentimentChange": 0.07
    }
  }
}

Devuelve métricas agregadas de visibilidad en IA para el periodo actual comparado con el periodo anterior de igual duración. Úsalo para dashboards y KPIs de la visibilidad de Finseo en ChatGPT, Claude, Perplexity y el resto de modelos con Tracking.

string

requerido

Identificador del proyecto.

string

predeterminado:"30d"

Ventana móvil, p. ej. 7d, 30d, 90d.

string

Restringe las métricas a un único modelo.

string

Filtra por idioma del Prompt.

string

Array JSON o Tags separados por comas para filtrar Prompts.

integer

Incluido por el parseo de query compartido; las métricas ignoran la paginación.

integer

Incluido por el parseo de query compartido; las métricas ignoran la paginación.

curl --request GET \
  --url 'https://api.finseo.ai/v1/projects/67a1c2d3e4f5061728394a5b/metrics?timeframe=30d' \
  --header 'Authorization: Bearer sk_live_xxxxxxxx'

import requests

r = requests.get(
    "https://api.finseo.ai/v1/projects/67a1c2d3e4f5061728394a5b/metrics",
    headers={"Authorization": "Bearer sk_live_xxxxxxxx"},
    params={"timeframe": "30d", "language": "en"},
)
metrics = r.json()["data"]
print(metrics["current"]["visibilityRate"], metrics["changes"]["visibilityRateChange"])

{
  "data": {
    "current": {
      "visible": 28,
      "notVisible": 14,
      "mentions": 156,
      "totalResponses": 84,
      "visibilityRate": 66.67,
      "responseVisibilityRate": 52.38,
      "position": 22.4,
      "sentiment": 0.78,
      "periodStart": "2026-02-27",
      "periodEnd": "2026-03-28"
    },
    "previous": {
      "visible": 22,
      "notVisible": 20,
      "mentions": 118,
      "totalResponses": 76,
      "visibilityRate": 52.38,
      "responseVisibilityRate": 45.2,
      "position": 28.1,
      "sentiment": 0.71,
      "periodStart": "2026-01-28",
      "periodEnd": "2026-02-26"
    },
    "changes": {
      "visibleChange": 6,
      "visibilityRateChange": 14.29,
      "responseVisibilityRateChange": 7.18,
      "mentionsChange": 38,
      "positionChange": -5.7,
      "sentimentChange": 0.07
    }
  }
}

Crear Prompt Serie temporal de métricas

Projects

Prompts

Metrics

Competitors

Sources

Tags

Fan-outs

Export

Attribution

Métricas del proyecto (resumen)