curl --request GET \
--url 'https://api.finseo.ai/v1/projects/proj_abc123/fanouts?timeframe=30d&limit=20' \
--header "Authorization: Bearer $FINSEO_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
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.
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 $FINSEO_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
}
}
}
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.
string
obbligatorio
L’ID del progetto
string
predefinito:"90d"
Finestra temporale —
7d, 30d, 90d, 365d, oppure all per ottenere tutti i Fan-out di semprestring
Data di inizio personalizzata (YYYY-MM-DD), ha la precedenza sulla timeframe
string
Data di fine personalizzata (YYYY-MM-DD), ha la precedenza sulla timeframe
string
Tag separati da virgola per filtrare i Prompt di origine
integer
predefinito:"1"
Numero di pagina
integer
predefinito:"50"
Risultati per pagina (max 500)
curl --request GET \
--url 'https://api.finseo.ai/v1/projects/proj_abc123/fanouts?timeframe=30d&limit=20' \
--header "Authorization: Bearer $FINSEO_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
}
}
}