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
}
}
Metrics
Serie temporale delle metriche
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
}
}
Restituisce le metriche giornaliere di visibilità AI, pronte per i grafici. Ogni riga in
data.chartData corrisponde a un giorno di calendario all’interno della finestra derivata da timeframe, oppure tra startDate / endDate quando entrambi sono presenti. Ideale per le linee di tendenza di Finseo su ChatGPT, Claude e Perplexity.
Campi per giorno (tutti i conteggi sono risposte AI di quel giorno; vedi KPI e metriche):
| Campo | Significato |
|---|---|
totalResults | Risposte AI analizzate in quel giorno |
visible / notVisible | Risposte in cui il brand è visibile (nominato nel testo O dominio proprio citato) / non visibile — visible ÷ totalResults è la Visibility della dashboard |
mentions | Risposte che nominano il brand nel testo — mentions ÷ totalResults è il Mention Rate |
cited | Risposte che citano il dominio proprio (o un alias di dominio) come fonte — cited ÷ totalResults è il Citation Rate. null quando il giorno proviene da un rollup che non include le citazioni |
mentionOrder | Posizione ordinale media tra i brand nominati (1 = nominato per primo; il KPI Position della dashboard), null quando il brand non è stato nominato |
position | Profondità di menzione — quanto in profondità nel testo della risposta compare la menzione (0 = inizio) |
sentiment | Punteggio medio di sentiment (0–100) sulle risposte visibili |
uniquePrompts | Prompt distinti con almeno una risposta in quel giorno |
string
obbligatorio
Identificatore del progetto.
string
predefinito:"30d"
Finestra mobile quando
startDate / endDate non vengono usati.string
Data ISO
YYYY-MM-DD (da usare con endDate).string
Data ISO
YYYY-MM-DD (da usare con startDate).string
Filtra su un singolo modello.
string
Filtro per lingua del Prompt.
string
Array JSON o Tag separati da virgola.
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
}
}