> ## 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.

# Série temporelle des métriques

Renvoie les métriques quotidiennes de visibilité IA pour la création de graphiques. Chaque ligne correspond à un jour calendaire au sein de la période dérivée de `timeframe`, ou comprise entre `startDate` et `endDate` lorsque les deux sont fournis. Idéal pour tracer les courbes de tendance de Finseo sur ChatGPT, Claude et Perplexity.

<ParamField path="projectId" type="string" required>
  Identifiant du projet.
</ParamField>

<ParamField query="timeframe" type="string" default="30d">
  Fenêtre glissante lorsque `startDate` / `endDate` ne sont pas utilisés.
</ParamField>

<ParamField query="startDate" type="string">
  Date ISO `YYYY-MM-DD` (à utiliser avec `endDate`).
</ParamField>

<ParamField query="endDate" type="string">
  Date ISO `YYYY-MM-DD` (à utiliser avec `startDate`).
</ParamField>

<ParamField query="model" type="string">
  Filtre sur un seul modèle.
</ParamField>

<ParamField query="language" type="string">
  Filtre par langue des prompts.
</ParamField>

<ParamField query="tags" type="string">
  Tableau JSON ou Tags séparés par des virgules.
</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>