> ## 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.

# Projekt-Metriken (Zusammenfassung)

Gibt aggregierte KI-Sichtbarkeits-Metriken für den aktuellen Zeitraum im Vergleich zum vorherigen Zeitraum gleicher Länge zurück. Ideal für Dashboards und KPIs zur Finseo-Sichtbarkeit in ChatGPT, Claude, Perplexity und weiteren getrackten Modellen.

<ParamField path="projectId" type="string" required>
  Projekt-ID.
</ParamField>

<ParamField query="timeframe" type="string" default="30d">
  Rollierendes Zeitfenster, z. B. `7d`, `30d`, `90d`.
</ParamField>

<ParamField query="model" type="string">
  Beschränkt die Metriken auf ein einzelnes Modell.
</ParamField>

<ParamField query="language" type="string">
  Filter nach Prompt-Sprache.
</ParamField>

<ParamField query="tags" type="string">
  JSON-Array oder kommaseparierte Tags, um Prompts zu filtern.
</ParamField>

<ParamField query="page" type="integer">
  Nur wegen des gemeinsamen Query-Parsings enthalten; Metriken ignorieren Pagination.
</ParamField>

<ParamField query="limit" type="integer">
  Nur wegen des gemeinsamen Query-Parsings enthalten; Metriken ignorieren Pagination.
</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>