Metriche del progetto (riepilogo)

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
    }
  }
}

Restituisce le metriche aggregate di visibilità AI per il periodo corrente confrontate con il periodo precedente di pari durata. Usa questo Endpoint per Dashboard e KPI sulla visibilità di Finseo su ChatGPT, Claude, Perplexity e gli altri modelli tracciati.

string

obbligatorio

Identificatore del progetto.

string

predefinito:"30d"

Finestra mobile, es. 7d, 30d, 90d.

string

Limita le metriche a un singolo modello.

string

Filtra per lingua del Prompt.

string

Array JSON o Tag separati da virgola per filtrare i Prompt.

integer

Incluso per il parsing condiviso della query; le metriche ignorano la paginazione.

integer

Incluso per il parsing condiviso della query; le metriche ignorano la paginazione.

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
    }
  }
}

Crea un Prompt Serie temporale delle metriche

Projects

Prompts

Metrics

Competitors

Sources

Tags

Fan-outs

Export

Attribution

Metriche del progetto (riepilogo)