curl --request GET \
--url 'https://api.finseo.ai/v1/projects/67a1c2d3e4f5061728394a5b/metrics?timeframe=30d' \
--header "Authorization: Bearer $FINSEO_API_KEY"
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"]
cur, chg = metrics["today"], metrics["changes"]
print(cur["responseVisibilityRate"], cur["mentionRate"], cur["citationRate"], chg["responseVisibilityRateChange"])
{
"data": {
"today": {
"date": "2026-09-08",
"visible": 28,
"notVisible": 14,
"mentions": 44,
"cited": 22,
"totalResponses": 84,
"position": 22.4,
"sentiment": 78,
"visibilityRate": 66.67,
"responseVisibilityRate": 59.52,
"mentionRate": 52.38,
"citationRate": 26.19
},
"yesterday": {
"date": "2026-08-09",
"visible": 22,
"notVisible": 20,
"mentions": 34,
"cited": 15,
"totalResponses": 76,
"position": 28.1,
"sentiment": 71,
"visibilityRate": 52.38,
"responseVisibilityRate": 50.0,
"mentionRate": 44.74,
"citationRate": 19.74
},
"changes": {
"visibleChange": 6,
"visibilityRateChange": 14.29,
"responseVisibilityRateChange": 9.52,
"mentionsChange": 10,
"citedChange": 7,
"mentionRateChange": 7.64,
"citationRateChange": 6.45,
"positionChange": -5.7,
"sentimentChange": 7
}
}
}
Metriken
Projekt-Metriken (Zusammenfassung)
GET
/
v1
/
projects
/
{projectId}
/
metrics
curl --request GET \
--url 'https://api.finseo.ai/v1/projects/67a1c2d3e4f5061728394a5b/metrics?timeframe=30d' \
--header "Authorization: Bearer $FINSEO_API_KEY"
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"]
cur, chg = metrics["today"], metrics["changes"]
print(cur["responseVisibilityRate"], cur["mentionRate"], cur["citationRate"], chg["responseVisibilityRateChange"])
{
"data": {
"today": {
"date": "2026-09-08",
"visible": 28,
"notVisible": 14,
"mentions": 44,
"cited": 22,
"totalResponses": 84,
"position": 22.4,
"sentiment": 78,
"visibilityRate": 66.67,
"responseVisibilityRate": 59.52,
"mentionRate": 52.38,
"citationRate": 26.19
},
"yesterday": {
"date": "2026-08-09",
"visible": 22,
"notVisible": 20,
"mentions": 34,
"cited": 15,
"totalResponses": 76,
"position": 28.1,
"sentiment": 71,
"visibilityRate": 52.38,
"responseVisibilityRate": 50.0,
"mentionRate": 44.74,
"citationRate": 19.74
},
"changes": {
"visibleChange": 6,
"visibilityRateChange": 14.29,
"responseVisibilityRateChange": 9.52,
"mentionsChange": 10,
"citedChange": 7,
"mentionRateChange": 7.64,
"citationRateChange": 6.45,
"positionChange": -5.7,
"sentimentChange": 7
}
}
}
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.
Die Antwort führt den aktuellen Zeitraum unter
Eine Antwort kann sowohl in
today und den Vorzeitraum unter yesterday (historische Namen — jeder Block aggregiert den gesamten Zeitraum, date ist das Enddatum des Zeitraums). Alle Raten teilen denselben Nenner, totalResponses (siehe KPIs erklärt):
| Feld | Bedeutung |
|---|---|
responseVisibilityRate | Visibility — % der Antworten, in denen die Marke sichtbar ist: im Text genannt ODER eigene Domain als Quelle zitiert (der „Visibility”-KPI im Dashboard) |
mentionRate | Mention Rate — % der Antworten, die die Marke im Antworttext nennen |
citationRate | Citation Rate — % der Antworten, die die eigene Domain (oder einen konfigurierten Domain-Alias) als Quelle zitieren |
mentions / cited | Absolute Zahlen hinter Mention Rate und Citation Rate (Antworten, jede einmal gezählt) |
visibilityRate | Prompt-Abdeckung — % der getrackten Prompts mit mindestens einer sichtbaren Antwort (eine andere, meist höhere Zahl) |
visible / notVisible | Anzahl der Prompts mit / ohne sichtbare Antwort |
position | Mention Depth — wie tief im Antworttext die Nennung erscheint (0 = ganz oben), kein Ranking |
mentionRate als auch in citationRate zählen, daher gilt responseVisibilityRate ≤ mentionRate + citationRate.
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 $FINSEO_API_KEY"
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"]
cur, chg = metrics["today"], metrics["changes"]
print(cur["responseVisibilityRate"], cur["mentionRate"], cur["citationRate"], chg["responseVisibilityRateChange"])
{
"data": {
"today": {
"date": "2026-09-08",
"visible": 28,
"notVisible": 14,
"mentions": 44,
"cited": 22,
"totalResponses": 84,
"position": 22.4,
"sentiment": 78,
"visibilityRate": 66.67,
"responseVisibilityRate": 59.52,
"mentionRate": 52.38,
"citationRate": 26.19
},
"yesterday": {
"date": "2026-08-09",
"visible": 22,
"notVisible": 20,
"mentions": 34,
"cited": 15,
"totalResponses": 76,
"position": 28.1,
"sentiment": 71,
"visibilityRate": 52.38,
"responseVisibilityRate": 50.0,
"mentionRate": 44.74,
"citationRate": 19.74
},
"changes": {
"visibleChange": 6,
"visibilityRateChange": 14.29,
"responseVisibilityRateChange": 9.52,
"mentionsChange": 10,
"citedChange": 7,
"mentionRateChange": 7.64,
"citationRateChange": 6.45,
"positionChange": -5.7,
"sentimentChange": 7
}
}
}