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

# Elenca i Fan-out

> Ottieni le query Fan-out AI (le sotto-query correlate che i modelli AI hanno generato mentre rispondevano ai tuoi Prompt tracciati), aggregate e ordinate per frequenza.

Le query Fan-out sono sotto-query correlate che i modelli AI (ChatGPT, Claude, Perplexity, ecc.) generano internamente mentre rispondono ai tuoi Prompt tracciati. Questo Endpoint le aggrega su tutti i risultati di Tracking in una finestra temporale e le restituisce ordinate per numero di occorrenze.

Sono gli stessi dati mostrati nella pagina Query Fan-outs della Dashboard di Finseo.

<ParamField path="projectId" type="string" required>L'ID del progetto</ParamField>
<ParamField query="timeframe" type="string" default="90d">Finestra temporale — `7d`, `30d`, `90d`, `365d`, oppure `all` per ottenere tutti i Fan-out di sempre</ParamField>
<ParamField query="startDate" type="string">Data di inizio personalizzata (YYYY-MM-DD), ha la precedenza sulla timeframe</ParamField>
<ParamField query="endDate" type="string">Data di fine personalizzata (YYYY-MM-DD), ha la precedenza sulla timeframe</ParamField>
<ParamField query="tags" type="string">Tag separati da virgola per filtrare i Prompt di origine</ParamField>
<ParamField query="page" type="integer" default="1">Numero di pagina</ParamField>
<ParamField query="limit" type="integer" default="50">Risultati per pagina (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>