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

# List Prompts

Lists tracked prompts for a project with visibility, mention counts, and sentiment for the selected timeframe. Finseo evaluates these prompts against ChatGPT, Claude, Perplexity, and other models.

<ParamField path="projectId" type="string" required>
  Project identifier.
</ParamField>

<ParamField query="timeframe" type="string" default="30d">
  Rolling window length, e.g. `7d`, `30d`, `90d`.
</ParamField>

<ParamField query="model" type="string">
  Filter results to a single model (e.g. `chatgpt`).
</ParamField>

<ParamField query="language" type="string">
  ISO language code filter (e.g. `en`, `de`).
</ParamField>

<ParamField query="tags" type="string">
  JSON array string or comma-separated tag names to filter prompts.
</ParamField>

<ParamField query="search" type="string">
  Case-insensitive substring match on prompt text.
</ParamField>

<ParamField query="page" type="integer" default="1">
  Page number (1-based).
</ParamField>

<ParamField query="limit" type="integer" default="50">
  Page size (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>