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

Devuelve métricas diarias de visibilidad en IA para tus gráficas. Cada fila corresponde a un día natural dentro del periodo derivado de timeframe, o dentro de startDate / endDate cuando envías ambos. Ideal para líneas de tendencia de Finseo en ChatGPT, Claude y Perplexity.

string

requerido

Identificador del proyecto.

string

predeterminado:"30d"

Ventana móvil cuando no se usan startDate / endDate.

string

Fecha ISO YYYY-MM-DD (úsala junto con endDate).

string

Fecha ISO YYYY-MM-DD (úsala junto con startDate).

string

Filtra a un solo modelo.

string

Filtro por idioma del Prompt.

string

Array JSON o Tags separados por comas.

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 del proyecto (resumen)Listar competidores

Projects

Prompts

Metrics

Competitors

Sources

Tags

Fan-outs

Export

Attribution

Serie temporal de métricas