Skip to main content
GET
/
api
/
v1
/
projects
/
{projectId}
/
metrics
/
timeseries
curl --request GET \
  --url 'https://app.finseo.ai/api/v1/projects/67a1c2d3e4f5061728394a5b/metrics/timeseries?timeframe=14d' \
  --header 'Authorization: Bearer sk_live_xxxxxxxx'
{
  "data": [
    {
      "date": "2026-03-15",
      "visible": 9,
      "notVisible": 3,
      "totalResults": 12,
      "mentions": 24,
      "position": 19.2,
      "sentiment": 0.74,
      "uniquePrompts": 12
    },
    {
      "date": "2026-03-16",
      "visible": 10,
      "notVisible": 2,
      "totalResults": 12,
      "mentions": 31,
      "position": 17.8,
      "sentiment": 0.79,
      "uniquePrompts": 12
    },
    {
      "date": "2026-03-17",
      "visible": 11,
      "notVisible": 1,
      "totalResults": 12,
      "mentions": 28,
      "position": 16.5,
      "sentiment": 0.81,
      "uniquePrompts": 12
    }
  ]
}
Returns daily AI visibility metrics for charting. Each row 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.
projectId
string
required
Project identifier.
timeframe
string
default:"30d"
Rolling window when startDate / endDate are not used.
startDate
string
ISO date YYYY-MM-DD (use with endDate).
endDate
string
ISO date YYYY-MM-DD (use with startDate).
model
string
Filter to one model.
language
string
Prompt language filter.
tags
string
JSON array or comma-separated tags.
curl --request GET \
  --url 'https://app.finseo.ai/api/v1/projects/67a1c2d3e4f5061728394a5b/metrics/timeseries?timeframe=14d' \
  --header 'Authorization: Bearer sk_live_xxxxxxxx'
{
  "data": [
    {
      "date": "2026-03-15",
      "visible": 9,
      "notVisible": 3,
      "totalResults": 12,
      "mentions": 24,
      "position": 19.2,
      "sentiment": 0.74,
      "uniquePrompts": 12
    },
    {
      "date": "2026-03-16",
      "visible": 10,
      "notVisible": 2,
      "totalResults": 12,
      "mentions": 31,
      "position": 17.8,
      "sentiment": 0.79,
      "uniquePrompts": 12
    },
    {
      "date": "2026-03-17",
      "visible": 11,
      "notVisible": 1,
      "totalResults": 12,
      "mentions": 28,
      "position": 16.5,
      "sentiment": 0.81,
      "uniquePrompts": 12
    }
  ]
}