Serie temporale delle metriche

curl --request GET \
  --url 'https://api.finseo.ai/v1/projects/67a1c2d3e4f5061728394a5b/metrics/timeseries?timeframe=14d' \
  --header 'Authorization: Bearer sk_live_xxxxxxxx'

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"]
print(series[-1]["mentions"], series[-1]["date"])

{
  "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
    }
  ]
}

GET

projects

{projectId}

metrics

timeseries

curl --request GET \
  --url 'https://api.finseo.ai/v1/projects/67a1c2d3e4f5061728394a5b/metrics/timeseries?timeframe=14d' \
  --header 'Authorization: Bearer sk_live_xxxxxxxx'

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"]
print(series[-1]["mentions"], series[-1]["date"])

{
  "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
    }
  ]
}

Restituisce le metriche giornaliere di visibilità AI, pronte per i grafici. Ogni riga 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.

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 sk_live_xxxxxxxx'

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"]
print(series[-1]["mentions"], series[-1]["date"])

{
  "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
    }
  ]
}

Metriche del progetto (riepilogo)Elenca i concorrenti

Projects

Prompts

Metrics

Competitors

Sources

Tags

Fan-outs

Export

Attribution

Serie temporale delle metriche