curl --request GET \
--url 'https://api.finseo.ai/v1/projects/proj_abc123/fanouts?timeframe=30d&limit=20' \
--header 'Authorization: Bearer YOUR_API_KEY'
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")
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));
{
"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
}
}
}
Fan-outs
List Fan-outs
Get the AI query fan-outs (related sub-queries that AI models generated while answering your tracked prompts), aggregated and ranked by frequency.
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'
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")
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));
{
"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.
string
required
The project ID
string
default:"90d"
Time window —
7d, 30d, 90d, 365d, or all to get all fan-outs everstring
Custom start date (YYYY-MM-DD), overrides timeframe
string
Custom end date (YYYY-MM-DD), overrides timeframe
string
Comma-separated tags to filter source prompts
integer
default:"1"
Page number
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'
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")
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));
{
"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
}
}
}