curl -X POST https://api.tryprofound.com/v2/reports/query-fanouts \
-H "X-API-Key: <your-api-key>" \
-H "Content-Type: application/json" \
-d '{
"category_id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
"start_date": "2026-06-09",
"end_date": "2026-06-15"
}'
{
"info": {
"total_results": 322,
"count": 10,
"next_cursor": "Z0FBQUFBQnFQcVJ3R1RlcGtXc0g5eTZT...",
"models": ["ChatGPT", "Google Gemini", "Perplexity", "Claude", "..."],
"metrics": ["total_fanouts", "fanouts_per_execution", "query_variations"],
"start_date": "2026-06-09",
"end_date": "2026-06-15",
"coverage_note": "Fanout metrics cover only runs that emitted query-fanout data.",
"filter": null
},
"data": [
{ "prompt": "AI search optimization startups...", "rank": 1, "total_fanouts": 190, "fanouts_per_execution": 3.0, "query_variations": 143 },
{ "prompt": "Best AI visibility products...", "rank": 2, "total_fanouts": 168, "fanouts_per_execution": 2.7, "query_variations": 143 }
// ...8 more rows in this page (count: 10, total_results: 322); paginate with next_cursor
]
}
Informes v2
Consultas fanout
POST
/
v2
/
reports
/
query-fanouts
curl -X POST https://api.tryprofound.com/v2/reports/query-fanouts \
-H "X-API-Key: <your-api-key>" \
-H "Content-Type: application/json" \
-d '{
"category_id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
"start_date": "2026-06-09",
"end_date": "2026-06-15"
}'
{
"info": {
"total_results": 322,
"count": 10,
"next_cursor": "Z0FBQUFBQnFQcVJ3R1RlcGtXc0g5eTZT...",
"models": ["ChatGPT", "Google Gemini", "Perplexity", "Claude", "..."],
"metrics": ["total_fanouts", "fanouts_per_execution", "query_variations"],
"start_date": "2026-06-09",
"end_date": "2026-06-15",
"coverage_note": "Fanout metrics cover only runs that emitted query-fanout data.",
"filter": null
},
"data": [
{ "prompt": "AI search optimization startups...", "rank": 1, "total_fanouts": 190, "fanouts_per_execution": 3.0, "query_variations": 143 },
{ "prompt": "Best AI visibility products...", "rank": 2, "total_fanouts": 168, "fanouts_per_execution": 2.7, "query_variations": 143 }
// ...8 more rows in this page (count: 10, total_results: 322); paginate with next_cursor
]
}
Las consultas de búsqueda que una IA genera internamente al responder a un prompt.
La cobertura es parcial: las métricas solo cubren las ejecuciones que emitieron datos de fanout (consulta
info.coverage_note).
- Métricas:
total_fanouts(cantidad de consultas),fanouts_per_execution(promedio de consultas por ejecución),query_variations(consultas fanout distintas),share. group_by:prompt(predeterminado),query,model,region,date.queryrequierepromptengroup_by;sharerequierequery;query_variationsno se puede combinar conquery.- El filtro
analysis_typetienevisibilitycomo valor predeterminado.
¿Es la primera vez que usas los informes v2? Consulta Filtrado y conceptos para conocer la estructura de solicitud compartida, el árbol de filtros, la agrupación y la paginación.
Variante con streaming (SSE) (mismo cuerpo, /stream)
Variante con streaming (SSE) (mismo cuerpo, /stream)
POST /v2/reports/query-fanouts/stream recibe el mismo cuerpo de solicitud y
devuelve Server-Sent Events:
un evento summary (el bloque info) y luego un evento result por fila.
limit/cursor se ignoran; de forma predeterminada devuelve todo. Pasa
max_results para establecer un límite.Response (text/event-stream)
event: summary
data: { ...the info block... }
event: result ← one per row, same shape as data[] above
data: {"prompt": "AI search optimization startups...", "rank": 1, "total_fanouts": 190, "fanouts_per_execution": 3.0, "query_variations": 143}
curl -X POST https://api.tryprofound.com/v2/reports/query-fanouts \
-H "X-API-Key: <your-api-key>" \
-H "Content-Type: application/json" \
-d '{
"category_id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
"start_date": "2026-06-09",
"end_date": "2026-06-15"
}'
{
"info": {
"total_results": 322,
"count": 10,
"next_cursor": "Z0FBQUFBQnFQcVJ3R1RlcGtXc0g5eTZT...",
"models": ["ChatGPT", "Google Gemini", "Perplexity", "Claude", "..."],
"metrics": ["total_fanouts", "fanouts_per_execution", "query_variations"],
"start_date": "2026-06-09",
"end_date": "2026-06-15",
"coverage_note": "Fanout metrics cover only runs that emitted query-fanout data.",
"filter": null
},
"data": [
{ "prompt": "AI search optimization startups...", "rank": 1, "total_fanouts": 190, "fanouts_per_execution": 3.0, "query_variations": 143 },
{ "prompt": "Best AI visibility products...", "rank": 2, "total_fanouts": 168, "fanouts_per_execution": 2.7, "query_variations": 143 }
// ...8 more rows in this page (count: 10, total_results: 322); paginate with next_cursor
]
}
Autorizaciones
APIKeyHeaderBearerAuth
Cuerpo
application/json
YYYY-MM-DD, ET, inclusive
YYYY-MM-DD, ET, inclusive
Opciones disponibles:
date, model, region, prompt, query Opciones disponibles:
fanouts_per_execution, total_fanouts, share, query_variations Opciones disponibles:
day, week, month A leaf (field/op/value) or an and/or/not group.
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Page size; default 10, max 50.
Rango requerido:
0 < x <= 50Stream endpoint only: cap the number of streamed rows (default: all).
Rango requerido:
x > 0¿Esta página le ayudó?