> ## 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 Fan-outs

> Obtén los Fan-outs de consultas de IA (sub-consultas relacionadas que los modelos de IA generaron al responder tus Prompts con Tracking), agregados y ordenados por frecuencia.

Los Fan-outs de consultas son sub-consultas relacionadas que los modelos de IA (ChatGPT, Claude, Perplexity, etc.) generan internamente mientras responden tus Prompts con Tracking. Este Endpoint los agrega a partir de todos los resultados de Tracking dentro de un periodo y los devuelve ordenados por número de apariciones.

Son los mismos datos que se muestran en la página Query Fan-outs del Dashboard de Finseo.

<ParamField path="projectId" type="string" required>El ID del proyecto</ParamField>
<ParamField query="timeframe" type="string" default="90d">Ventana de tiempo — `7d`, `30d`, `90d`, `365d`, o `all` para obtener todos los Fan-outs históricos</ParamField>
<ParamField query="startDate" type="string">Fecha de inicio personalizada (YYYY-MM-DD), tiene prioridad sobre timeframe</ParamField>
<ParamField query="endDate" type="string">Fecha de fin personalizada (YYYY-MM-DD), tiene prioridad sobre timeframe</ParamField>
<ParamField query="tags" type="string">Tags separados por comas para filtrar los Prompts de origen</ParamField>
<ParamField query="page" type="integer" default="1">Número de página</ParamField>
<ParamField query="limit" type="integer" default="50">Resultados por página (máx. 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>