Projekt-Metriken (Zusammenfassung)

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

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.

string

erforderlich

Projekt-ID.

string

Standard:"30d"

Rollierendes Zeitfenster, z. B. 7d, 30d, 90d.

string

Beschränkt die Metriken auf ein einzelnes Modell.

string

Filter nach Prompt-Sprache.

string

JSON-Array oder kommaseparierte Tags, um Prompts zu filtern.

integer

Nur wegen des gemeinsamen Query-Parsings enthalten; Metriken ignorieren Pagination.

integer

Nur wegen des gemeinsamen Query-Parsings enthalten; Metriken ignorieren Pagination.

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

Projekte

Prompts

Metriken

Wettbewerber

Quellen

Tags

Fan-outs

Export

Attribution

Projekt-Metriken (Zusammenfassung)