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
Série temporelle des métriques
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
}
}
Renvoie les métriques quotidiennes de visibilité IA pour la création de graphiques. Chaque ligne de
data.chartData correspond à un jour calendaire au sein de la période dérivée de timeframe, ou comprise entre startDate et endDate lorsque les deux sont fournis. Idéal pour tracer les courbes de tendance de Finseo sur ChatGPT, Claude et Perplexity.
Champs par jour (tous les décomptes sont des réponses IA de ce jour ; voir KPIs expliqués) :
| Champ | Signification |
|---|---|
totalResults | Réponses IA analysées ce jour-là |
visible / notVisible | Réponses dans lesquelles la marque est visible (nommée dans le texte OU domaine propre cité) / non visible — visible ÷ totalResults est la Visibility du dashboard |
mentions | Réponses nommant la marque dans le texte — mentions ÷ totalResults est le Mention Rate |
cited | Réponses citant le domaine propre (ou un alias de domaine) comme source — cited ÷ totalResults est le Citation Rate. null lorsque le jour provient d’un agrégat (rollup) qui ne contient pas les citations |
mentionOrder | Position ordinale moyenne parmi les marques nommées (1 = nommée en premier ; le KPI Position du dashboard), null lorsque la marque n’a pas été nommée |
position | Profondeur de mention — à quelle profondeur du texte de la réponse la mention apparaît (0 = tout en haut) |
sentiment | Score de sentiment moyen (0–100) sur les réponses visibles |
uniquePrompts | Prompts distincts avec au moins une réponse ce jour-là |
string
requis
Identifiant du projet.
string
défaut:"30d"
Fenêtre glissante lorsque
startDate / endDate ne sont pas utilisés.string
Date ISO
YYYY-MM-DD (à utiliser avec endDate).string
Date ISO
YYYY-MM-DD (à utiliser avec startDate).string
Filtre sur un seul modèle.
string
Filtre par langue des prompts.
string
Tableau JSON ou Tags séparés par des virgules.
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
}
}