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

# Listar Prompts

Lista los Prompts con Tracking de un proyecto, con visibilidad, número de Mentions y Sentiment para el periodo seleccionado. Finseo evalúa estos Prompts en ChatGPT, Claude, Perplexity y otros modelos.

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

<ParamField query="timeframe" type="string" default="30d">
  Longitud de la ventana móvil, p. ej. `7d`, `30d`, `90d`.
</ParamField>

<ParamField query="model" type="string">
  Filtra los resultados a un único modelo (p. ej. `chatgpt`).
</ParamField>

<ParamField query="language" type="string">
  Filtro por código de idioma ISO (p. ej. `en`, `de`).
</ParamField>

<ParamField query="tags" type="string">
  Cadena con array JSON o nombres de Tags separados por comas para filtrar Prompts.
</ParamField>

<ParamField query="search" type="string">
  Coincidencia de subcadena (sin distinguir mayúsculas) sobre el texto del Prompt.
</ParamField>

<ParamField query="page" type="integer" default="1">
  Número de página (empieza en 1).
</ParamField>

<ParamField query="limit" type="integer" default="50">
  Tamaño de página (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>