> ## Documentation Index
> Fetch the complete documentation index at: https://docs.finseo.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Métricas do Projeto (Resumo)

Retorna métricas agregadas de visibilidade em IA para o período atual em comparação com o período anterior de mesma duração. Use isto em dashboards e KPIs de visibilidade da Finseo no ChatGPT, Claude, Perplexity e outros modelos monitorados.

<ParamField path="projectId" type="string" required>
  Identificador do projeto.
</ParamField>

<ParamField query="timeframe" type="string" default="30d">
  Janela móvel, por exemplo `7d`, `30d`, `90d`.
</ParamField>

<ParamField query="model" type="string">
  Restrinja as métricas a um único modelo.
</ParamField>

<ParamField query="language" type="string">
  Filtre por idioma do Prompt.
</ParamField>

<ParamField query="tags" type="string">
  Array JSON ou Tags separadas por vírgula para filtrar os Prompts.
</ParamField>

<ParamField query="page" type="integer">
  Incluído para o parsing compartilhado de query; as métricas ignoram paginação.
</ParamField>

<ParamField query="limit" type="integer">
  Incluído para o parsing compartilhado de query; as métricas ignoram paginação.
</ParamField>

<RequestExample>
  ```bash cURL theme={"system"}
  curl --request GET \
    --url 'https://api.finseo.ai/v1/projects/67a1c2d3e4f5061728394a5b/metrics?timeframe=30d' \
    --header 'Authorization: Bearer sk_live_xxxxxxxx'
  ```

  ```python Python theme={"system"}
  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"])
  ```
</RequestExample>

<ResponseExample>
  ```json theme={"system"}
  {
    "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
      }
    }
  }
  ```
</ResponseExample>