Série Temporal de Métricas

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

Retorna métricas diárias de visibilidade em IA para geração de gráficos. Cada linha corresponde a um dia do calendário dentro do período derivado de timeframe, ou dentro de startDate / endDate quando ambos são fornecidos. Ideal para linhas de tendência da Finseo no ChatGPT, Claude e Perplexity.

string

obrigatório

Identificador do projeto.

string

padrão:"30d"

Janela móvel quando startDate / endDate não são usados.

string

Data ISO YYYY-MM-DD (use com endDate).

string

Data ISO YYYY-MM-DD (use com startDate).

string

Filtre para um único modelo.

string

Filtro por idioma do Prompt.

string

Array JSON ou Tags separadas por vírgula.

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

Métricas do Projeto (Resumo)Listar Concorrentes

Projects

Prompts

Metrics

Competitors

Sources

Tags

Fan-outs

Export

Attribution

Série Temporal de Métricas