> ## Documentation Index
> Fetch the complete documentation index at: https://docs.finseo.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Serie temporal de métricas

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.

<ParamField path="projectId" type="string" required>
  Identificador del proyecto.
</ParamField>

<ParamField query="timeframe" type="string" default="30d">
  Ventana móvil cuando no se usan `startDate` / `endDate`.
</ParamField>

<ParamField query="startDate" type="string">
  Fecha ISO `YYYY-MM-DD` (úsala junto con `endDate`).
</ParamField>

<ParamField query="endDate" type="string">
  Fecha ISO `YYYY-MM-DD` (úsala junto con `startDate`).
</ParamField>

<ParamField query="model" type="string">
  Filtra a un solo modelo.
</ParamField>

<ParamField query="language" type="string">
  Filtro por idioma del Prompt.
</ParamField>

<ParamField query="tags" type="string">
  Array JSON o Tags separados por comas.
</ParamField>

<RequestExample>
  ```bash cURL theme={"system"}
  curl --request GET \
    --url 'https://api.finseo.ai/v1/projects/67a1c2d3e4f5061728394a5b/metrics/timeseries?timeframe=14d' \
    --header 'Authorization: Bearer sk_live_xxxxxxxx'
  ```

  ```python Python theme={"system"}
  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"])
  ```
</RequestExample>

<ResponseExample>
  ```json theme={"system"}
  {
    "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
      }
    ]
  }
  ```
</ResponseExample>