curl --request GET \
--url 'https://api.finseo.ai/v1/projects/proj_abc123/fanouts/details?query=best+CRM+for+small+business+2026&timeframe=30d' \
--header "Authorization: Bearer $FINSEO_API_KEY"
import requests
response = requests.get(
f"https://api.finseo.ai/v1/projects/{project_id}/fanouts/details",
headers={"Authorization": "Bearer YOUR_API_KEY"},
params={"query": "best CRM for small business 2026", "timeframe": "30d"}
)
data = response.json()["data"]
print(f"Found {data['totalOccurrences']} occurrences of '{data['query']}'")
for occ in data["occurrences"]:
print(f" {occ['model']} on {occ['timestamp']} — visible: {occ['visible']}")
{
"data": {
"query": "best CRM for small business 2026",
"totalOccurrences": 47,
"occurrences": [
{
"resultId": "uuid-1",
"promptId": "prompt-uuid-1",
"promptText": "What CRM should I use for my startup?",
"brandName": "yourbrand",
"model": "chatgpt",
"timestamp": "2026-03-29T18:42:00Z",
"visible": true,
"mentions": 2
},
{
"resultId": "uuid-2",
"promptId": "prompt-uuid-2",
"promptText": "Best CRM for B2B SaaS",
"brandName": "yourbrand",
"model": "perplexity",
"timestamp": "2026-03-29T15:20:00Z",
"visible": false,
"mentions": 0
}
]
}
}
Fan-outs
Obter Detalhes de Fan-out
Obtenha os detalhes de cada ocorrência de uma única consulta de fan-out — todo resultado de Tracking cujas consultas de fan-out contêm exatamente este texto.
GET
/
v1
/
projects
/
{projectId}
/
fanouts
/
details
curl --request GET \
--url 'https://api.finseo.ai/v1/projects/proj_abc123/fanouts/details?query=best+CRM+for+small+business+2026&timeframe=30d' \
--header "Authorization: Bearer $FINSEO_API_KEY"
import requests
response = requests.get(
f"https://api.finseo.ai/v1/projects/{project_id}/fanouts/details",
headers={"Authorization": "Bearer YOUR_API_KEY"},
params={"query": "best CRM for small business 2026", "timeframe": "30d"}
)
data = response.json()["data"]
print(f"Found {data['totalOccurrences']} occurrences of '{data['query']}'")
for occ in data["occurrences"]:
print(f" {occ['model']} on {occ['timestamp']} — visible: {occ['visible']}")
{
"data": {
"query": "best CRM for small business 2026",
"totalOccurrences": 47,
"occurrences": [
{
"resultId": "uuid-1",
"promptId": "prompt-uuid-1",
"promptText": "What CRM should I use for my startup?",
"brandName": "yourbrand",
"model": "chatgpt",
"timestamp": "2026-03-29T18:42:00Z",
"visible": true,
"mentions": 2
},
{
"resultId": "uuid-2",
"promptId": "prompt-uuid-2",
"promptText": "Best CRM for B2B SaaS",
"brandName": "yourbrand",
"model": "perplexity",
"timestamp": "2026-03-29T15:20:00Z",
"visible": false,
"mentions": 0
}
]
}
}
Retorna todos os resultados de Tracking em que esta consulta de fan-out específica foi gerada, incluindo o Prompt de origem, o modelo, o timestamp, a visibilidade e as Mentions.
Use este Endpoint para aprofundar a análise a partir da lista agregada de fan-outs (
GET /fanouts) até as ocorrências individuais.
string
obrigatório
O ID do projeto
string
obrigatório
O texto exato da consulta de fan-out (correspondência sem diferenciar maiúsculas de minúsculas)
string
padrão:"90d"
Janela de tempo —
7d, 30d, 90d, 365d, ou all para pesquisar em todos os fan-outs já registradosstring
Data de início personalizada (YYYY-MM-DD)
string
Data de fim personalizada (YYYY-MM-DD)
string
Tags separadas por vírgula para filtrar os Prompts de origem
curl --request GET \
--url 'https://api.finseo.ai/v1/projects/proj_abc123/fanouts/details?query=best+CRM+for+small+business+2026&timeframe=30d' \
--header "Authorization: Bearer $FINSEO_API_KEY"
import requests
response = requests.get(
f"https://api.finseo.ai/v1/projects/{project_id}/fanouts/details",
headers={"Authorization": "Bearer YOUR_API_KEY"},
params={"query": "best CRM for small business 2026", "timeframe": "30d"}
)
data = response.json()["data"]
print(f"Found {data['totalOccurrences']} occurrences of '{data['query']}'")
for occ in data["occurrences"]:
print(f" {occ['model']} on {occ['timestamp']} — visible: {occ['visible']}")
{
"data": {
"query": "best CRM for small business 2026",
"totalOccurrences": 47,
"occurrences": [
{
"resultId": "uuid-1",
"promptId": "prompt-uuid-1",
"promptText": "What CRM should I use for my startup?",
"brandName": "yourbrand",
"model": "chatgpt",
"timestamp": "2026-03-29T18:42:00Z",
"visible": true,
"mentions": 2
},
{
"resultId": "uuid-2",
"promptId": "prompt-uuid-2",
"promptText": "Best CRM for B2B SaaS",
"brandName": "yourbrand",
"model": "perplexity",
"timestamp": "2026-03-29T15:20:00Z",
"visible": false,
"mentions": 0
}
]
}
}