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

# Lister les prompts

Liste les prompts suivis d'un projet avec la visibilité, le nombre de Mentions et le Sentiment pour la période sélectionnée. Finseo évalue ces prompts sur ChatGPT, Claude, Perplexity et d'autres modèles.

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

<ParamField query="timeframe" type="string" default="30d">
  Durée de la fenêtre glissante, p. ex. `7d`, `30d`, `90d`.
</ParamField>

<ParamField query="model" type="string">
  Filtre les résultats sur un seul modèle (p. ex. `chatgpt`).
</ParamField>

<ParamField query="language" type="string">
  Filtre par code de langue ISO (p. ex. `en`, `de`).
</ParamField>

<ParamField query="tags" type="string">
  Chaîne au format tableau JSON ou noms de Tags séparés par des virgules pour filtrer les prompts.
</ParamField>

<ParamField query="search" type="string">
  Correspondance de sous-chaîne insensible à la casse sur le texte du prompt.
</ParamField>

<ParamField query="page" type="integer" default="1">
  Numéro de page (à partir de 1).
</ParamField>

<ParamField query="limit" type="integer" default="50">
  Taille de page (1–500).
</ParamField>

<RequestExample>
  ```bash cURL theme={"system"}
  curl --request GET \
    --url 'https://api.finseo.ai/v1/projects/67a1c2d3e4f5061728394a5b/prompts?timeframe=30d&limit=10&page=1' \
    --header 'Authorization: Bearer sk_live_xxxxxxxx'
  ```

  ```python Python theme={"system"}
  import requests

  params = {"timeframe": "30d", "limit": 10, "page": 1, "search": "Finseo"}
  r = requests.get(
      "https://api.finseo.ai/v1/projects/67a1c2d3e4f5061728394a5b/prompts",
      headers={"Authorization": "Bearer sk_live_xxxxxxxx"},
      params=params,
  )
  body = r.json()["data"]
  print(body["pagination"], body["prompts"][0]["prompt"])
  ```
</RequestExample>

<ResponseExample>
  ```json theme={"system"}
  {
    "data": {
      "prompts": [
        {
          "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
          "prompt": "What are the best AI SEO tools including Finseo?",
          "domain": "finseo.ai",
          "brandName": "finseo",
          "language": "en",
          "tags": ["branded", "comparison"],
          "models": ["chatgpt", "claude", "perplexity"],
          "intentScores": { "commercial": 0.82, "informational": 0.64 },
          "searchIntents": ["compare", "evaluate"],
          "isVisible": true,
          "mentions": 14,
          "averagePosition": 18.2,
          "sentimentScore": 0.76,
          "sentimentCategory": "positive",
          "competitorCount": 6,
          "sourceCount": 22,
          "createdAt": "2026-02-10T12:00:00.000Z"
        }
      ],
      "pagination": {
        "page": 1,
        "limit": 10,
        "total": 48,
        "hasMore": true
      }
    }
  }
  ```
</ResponseExample>