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
Metrics Timeseries
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
}
}
Returns daily AI visibility metrics for charting. Each row in
data.chartData corresponds to a calendar day within the timeframe derived from timeframe, or within startDate / endDate when both are provided. Ideal for trend lines for Finseo across ChatGPT, Claude, and Perplexity.
Per-day fields (all counts are AI answers of that day; see KPIs explained):
| Field | Meaning |
|---|---|
totalResults | Analyzed AI answers on that day |
visible / notVisible | Answers where the brand is visible (named in the text OR own domain cited) / not visible — visible ÷ totalResults is the dashboard Visibility |
mentions | Answers naming the brand in the text — mentions ÷ totalResults is the Mention Rate |
cited | Answers citing the own domain (or a domain alias) as a source — cited ÷ totalResults is the Citation Rate. null when the day was served from a rollup that does not carry citations |
mentionOrder | Average ordinal position among the brands named (1 = named first; the dashboard Position KPI), null when the brand was not named |
position | Mention depth — how deep in the answer text the mention appears (0 = top) |
sentiment | Average sentiment score (0–100) across visible answers |
uniquePrompts | Distinct prompts with at least one answer that day |
string
required
Project identifier.
string
default:"30d"
Rolling window when
startDate / endDate are not used.string
ISO date
YYYY-MM-DD (use with endDate).string
ISO date
YYYY-MM-DD (use with startDate).string
Filter to one model.
string
Prompt language filter.
string
JSON array or comma-separated 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
}
}