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

# Fan-outs auflisten

> Hol dir die KI-Query-Fan-outs (verwandte Sub-Queries, die KI-Modelle beim Beantworten deiner getrackten Prompts erzeugt haben), aggregiert und nach Häufigkeit gerankt.

Query-Fan-outs sind verwandte Sub-Queries, die KI-Modelle (ChatGPT, Claude, Perplexity usw.) intern erzeugen, während sie deine getrackten Prompts beantworten. Dieser Endpoint aggregiert sie über alle Tracking-Ergebnisse eines Zeitraums und gibt sie nach Häufigkeit gerankt zurück.

Das sind dieselben Daten wie auf der Query-Fan-outs-Seite im Finseo-Dashboard.

<ParamField path="projectId" type="string" required>Die Projekt-ID</ParamField>
<ParamField query="timeframe" type="string" default="90d">Zeitfenster — `7d`, `30d`, `90d`, `365d` oder `all` für alle jemals erfassten Fan-outs</ParamField>
<ParamField query="startDate" type="string">Eigenes Startdatum (YYYY-MM-DD), überschreibt timeframe</ParamField>
<ParamField query="endDate" type="string">Eigenes Enddatum (YYYY-MM-DD), überschreibt timeframe</ParamField>
<ParamField query="tags" type="string">Kommaseparierte Tags, um die Quell-Prompts zu filtern</ParamField>
<ParamField query="page" type="integer" default="1">Seitennummer</ParamField>
<ParamField query="limit" type="integer" default="50">Ergebnisse pro Seite (max. 500)</ParamField>

<RequestExample>
  ```bash cURL theme={"system"}
  curl --request GET \
    --url 'https://api.finseo.ai/v1/projects/proj_abc123/fanouts?timeframe=30d&limit=20' \
    --header 'Authorization: Bearer YOUR_API_KEY'
  ```

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

  response = requests.get(
      f"https://api.finseo.ai/v1/projects/{project_id}/fanouts",
      headers={"Authorization": "Bearer YOUR_API_KEY"},
      params={"timeframe": "30d", "limit": 20}
  )
  fanouts = response.json()["data"]["fanouts"]

  for f in fanouts:
      print(f"{f['query']} — {f['count']} occurrences across {f['promptCount']} prompts")
  ```

  ```javascript Node.js theme={"system"}
  const res = await fetch(
    `https://api.finseo.ai/v1/projects/${projectId}/fanouts?timeframe=30d`,
    { headers: { Authorization: "Bearer YOUR_API_KEY" } }
  );
  const { data } = await res.json();
  data.fanouts.forEach(f => console.log(f.query, f.count));
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={"system"}
  {
    "data": {
      "fanouts": [
        {
          "query": "best CRM for small business 2026",
          "count": 47,
          "promptCount": 12,
          "models": ["chatgpt", "perplexity"],
          "lastSeen": "2026-03-29T18:42:00Z",
          "samplePrompt": "What CRM should I use for my startup?"
        },
        {
          "query": "HubSpot vs Salesforce comparison",
          "count": 32,
          "promptCount": 8,
          "models": ["chatgpt", "claude", "perplexity"],
          "lastSeen": "2026-03-29T14:15:00Z",
          "samplePrompt": "Compare HubSpot and Salesforce features"
        }
      ],
      "pagination": {
        "page": 1,
        "limit": 20,
        "total": 156,
        "hasMore": true
      },
      "meta": {
        "totalResults": 420,
        "totalPrompts": 42,
        "timeframeDays": 30
      }
    }
  }
  ```
</ResponseExample>