curl --request GET \
--url 'https://api.finseo.ai/v1/projects/67a1c2d3e4f5061728394a5b/metrics/timeseries?timeframe=14d' \
--header "Authorization: Bearer $FINSEO_API_KEY"
import requests
r = requests.get(
"https://api.finseo.ai/v1/projects/67a1c2d3e4f5061728394a5b/metrics/timeseries",
headers={"Authorization": "Bearer sk_live_xxxxxxxx"},
params={"timeframe": "14d", "model": "chatgpt"},
)
series = r.json()["data"]["chartData"]
last = series[-1]
print(last["date"], last["visible"] / last["totalResults"], last["mentions"], last["cited"])
{
"data": {
"chartData": [
{
"date": "2026-09-06",
"visible": 9,
"notVisible": 3,
"totalResults": 12,
"mentions": 8,
"cited": 4,
"position": 19.2,
"mentionOrder": 2.4,
"sentiment": 74,
"uniquePrompts": 12
},
{
"date": "2026-09-07",
"visible": 10,
"notVisible": 2,
"totalResults": 12,
"mentions": 9,
"cited": 5,
"position": 17.8,
"mentionOrder": 2.1,
"sentiment": 79,
"uniquePrompts": 12
},
{
"date": "2026-09-08",
"visible": 11,
"notVisible": 1,
"totalResults": 12,
"mentions": 10,
"cited": 5,
"position": 16.5,
"mentionOrder": 1.9,
"sentiment": 81,
"uniquePrompts": 12
}
],
"anchoredWindow": null
}
}
Metriken
Metriken-Zeitreihe
GET
/
v1
/
projects
/
{projectId}
/
metrics
/
timeseries
curl --request GET \
--url 'https://api.finseo.ai/v1/projects/67a1c2d3e4f5061728394a5b/metrics/timeseries?timeframe=14d' \
--header "Authorization: Bearer $FINSEO_API_KEY"
import requests
r = requests.get(
"https://api.finseo.ai/v1/projects/67a1c2d3e4f5061728394a5b/metrics/timeseries",
headers={"Authorization": "Bearer sk_live_xxxxxxxx"},
params={"timeframe": "14d", "model": "chatgpt"},
)
series = r.json()["data"]["chartData"]
last = series[-1]
print(last["date"], last["visible"] / last["totalResults"], last["mentions"], last["cited"])
{
"data": {
"chartData": [
{
"date": "2026-09-06",
"visible": 9,
"notVisible": 3,
"totalResults": 12,
"mentions": 8,
"cited": 4,
"position": 19.2,
"mentionOrder": 2.4,
"sentiment": 74,
"uniquePrompts": 12
},
{
"date": "2026-09-07",
"visible": 10,
"notVisible": 2,
"totalResults": 12,
"mentions": 9,
"cited": 5,
"position": 17.8,
"mentionOrder": 2.1,
"sentiment": 79,
"uniquePrompts": 12
},
{
"date": "2026-09-08",
"visible": 11,
"notVisible": 1,
"totalResults": 12,
"mentions": 10,
"cited": 5,
"position": 16.5,
"mentionOrder": 1.9,
"sentiment": 81,
"uniquePrompts": 12
}
],
"anchoredWindow": null
}
}
Gibt tägliche KI-Sichtbarkeits-Metriken für Charts zurück. Jede Zeile in
data.chartData entspricht einem Kalendertag innerhalb des über timeframe abgeleiteten Zeitraums — oder innerhalb von startDate / endDate, wenn beide angegeben sind. Ideal für Trendlinien zu Finseo in ChatGPT, Claude und Perplexity.
Felder pro Tag (alle Zahlen sind KI-Antworten dieses Tages; siehe KPIs erklärt):
| Feld | Bedeutung |
|---|---|
totalResults | Analysierte KI-Antworten an diesem Tag |
visible / notVisible | Antworten, in denen die Marke sichtbar ist (im Text genannt ODER eigene Domain zitiert) / nicht sichtbar — visible ÷ totalResults ist die Dashboard-Visibility |
mentions | Antworten, die die Marke im Text nennen — mentions ÷ totalResults ist die Mention Rate |
cited | Antworten, die die eigene Domain (oder einen Domain-Alias) als Quelle zitieren — cited ÷ totalResults ist die Citation Rate. null, wenn der Tag aus einem Rollup ohne Citations stammt |
mentionOrder | Durchschnittliche ordinale Position unter den genannten Marken (1 = zuerst genannt; der Position-KPI im Dashboard), null, wenn die Marke nicht genannt wurde |
position | Mention Depth — wie tief im Antworttext die Nennung erscheint (0 = ganz oben) |
sentiment | Durchschnittlicher Sentiment-Score (0–100) über die sichtbaren Antworten |
uniquePrompts | Verschiedene Prompts mit mindestens einer Antwort an diesem Tag |
string
erforderlich
Projekt-ID.
string
Standard:"30d"
Rollierendes Zeitfenster, wenn
startDate / endDate nicht verwendet werden.string
ISO-Datum
YYYY-MM-DD (zusammen mit endDate verwenden).string
ISO-Datum
YYYY-MM-DD (zusammen mit startDate verwenden).string
Filter auf ein Modell.
string
Filter nach Prompt-Sprache.
string
JSON-Array oder kommaseparierte Tags.
curl --request GET \
--url 'https://api.finseo.ai/v1/projects/67a1c2d3e4f5061728394a5b/metrics/timeseries?timeframe=14d' \
--header "Authorization: Bearer $FINSEO_API_KEY"
import requests
r = requests.get(
"https://api.finseo.ai/v1/projects/67a1c2d3e4f5061728394a5b/metrics/timeseries",
headers={"Authorization": "Bearer sk_live_xxxxxxxx"},
params={"timeframe": "14d", "model": "chatgpt"},
)
series = r.json()["data"]["chartData"]
last = series[-1]
print(last["date"], last["visible"] / last["totalResults"], last["mentions"], last["cited"])
{
"data": {
"chartData": [
{
"date": "2026-09-06",
"visible": 9,
"notVisible": 3,
"totalResults": 12,
"mentions": 8,
"cited": 4,
"position": 19.2,
"mentionOrder": 2.4,
"sentiment": 74,
"uniquePrompts": 12
},
{
"date": "2026-09-07",
"visible": 10,
"notVisible": 2,
"totalResults": 12,
"mentions": 9,
"cited": 5,
"position": 17.8,
"mentionOrder": 2.1,
"sentiment": 79,
"uniquePrompts": 12
},
{
"date": "2026-09-08",
"visible": 11,
"notVisible": 1,
"totalResults": 12,
"mentions": 10,
"cited": 5,
"position": 16.5,
"mentionOrder": 1.9,
"sentiment": 81,
"uniquePrompts": 12
}
],
"anchoredWindow": null
}
}