Skip to main content
GET
/
v1
/
projects
/
{projectId}
/
fanouts
curl --request GET \
  --url 'https://api.finseo.ai/v1/projects/proj_abc123/fanouts?timeframe=30d&limit=20' \
  --header 'Authorization: Bearer YOUR_API_KEY'

{
  "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
    }
  }
}
Query fan-outs are related sub-queries that AI models (ChatGPT, Claude, Perplexity, etc.) generate internally while answering your tracked prompts. This endpoint aggregates them across all tracking results in a timeframe and returns them ranked by occurrence count. This is the same data shown on the Query Fan-outs page in the Finseo dashboard.
​
projectId
string
required
The project ID
​
timeframe
string
default:"90d"
Time window — 7d, 30d, 90d, 365d, or all to get all fan-outs ever
​
startDate
string
Custom start date (YYYY-MM-DD), overrides timeframe
​
endDate
string
Custom end date (YYYY-MM-DD), overrides timeframe
​
tags
string
Comma-separated tags to filter source prompts
​
page
integer
default:"1"
Page number
​
limit
integer
default:"50"
Results per page (max 500)
curl --request GET \
  --url 'https://api.finseo.ai/v1/projects/proj_abc123/fanouts?timeframe=30d&limit=20' \
  --header 'Authorization: Bearer YOUR_API_KEY'

{
  "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
    }
  }
}