curl -X POST https://api.tryprofound.com/v2/reports/visibility \
-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": 1,
"count": 1,
"next_cursor": null,
"scope": "owned",
"models": ["ChatGPT", "Google Gemini", "Perplexity", "Claude", "..."],
"start_date": "2026-06-09",
"end_date": "2026-06-15",
"asset_filter": null,
"filter": null
},
"data": [
{
"asset": { "name": "Profound", "owned": true },
"rank": 1,
"visibility_score": 0.48,
"share_of_voice": 0.077,
"average_position": 2.5
}
]
}
Informes v2
Visibilidad
POST
/
v2
/
reports
/
visibility
curl -X POST https://api.tryprofound.com/v2/reports/visibility \
-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": 1,
"count": 1,
"next_cursor": null,
"scope": "owned",
"models": ["ChatGPT", "Google Gemini", "Perplexity", "Claude", "..."],
"start_date": "2026-06-09",
"end_date": "2026-06-15",
"asset_filter": null,
"filter": null
},
"data": [
{
"asset": { "name": "Profound", "owned": true },
"rank": 1,
"visibility_score": 0.48,
"share_of_voice": 0.077,
"average_position": 2.5
}
]
}
Con qué frecuencia aparece tu activo en las respuestas de IA, además de la cuota de voz y la posición
media. Selecciona los activos con
assets, desglosa los resultados con
group_by y lee cada métrica como un campo con nombre en la fila.
- Métricas:
visibility_score(proporción de respuestas en las que apareció el activo),share_of_voice(proporción de todas las menciones),average_position(posición media cuando se menciona; cuanto más baja, mejor). group_by:date,model,topic,region,prompt,persona.- Selecciona los activos con el parámetro
assets(un nombre, una lista o{ op, value }).scope: "all"clasifica todos los activos;"owned"devuelve solo los tuyos. sortpor cualquier métrica solicitada, por ejemplo{ "field": "visibility_score" }.
¿Es la primera vez que usas los informes v2? Consulta Filtros y conceptos para ver la estructura de solicitud compartida, el árbol de filtros, la agrupación y la paginación.
Variante de streaming (SSE) (mismo cuerpo, /stream)
Variante de streaming (SSE) (mismo cuerpo, /stream)
POST /v2/reports/visibility/stream recibe el mismo cuerpo de solicitud y
devuelve Server-Sent Events:
un evento summary (el bloque info) y, a continuación, un evento result por fila.
limit/cursor se ignoran; de forma predeterminada devuelve todo. Pasa
max_results para limitarlo.Response (text/event-stream)
event: summary
data: { ...the info block... }
event: result ← one per row, same shape as data[] above
data: {"asset": {"name": "Profound", "owned": true}, "rank": 1, "visibility_score": 0.48}
curl -X POST https://api.tryprofound.com/v2/reports/visibility \
-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": 1,
"count": 1,
"next_cursor": null,
"scope": "owned",
"models": ["ChatGPT", "Google Gemini", "Perplexity", "Claude", "..."],
"start_date": "2026-06-09",
"end_date": "2026-06-15",
"asset_filter": null,
"filter": null
},
"data": [
{
"asset": { "name": "Profound", "owned": true },
"rank": 1,
"visibility_score": 0.48,
"share_of_voice": 0.077,
"average_position": 2.5
}
]
}
Autorizaciones
APIKeyHeaderBearerAuth
Cuerpo
application/json
YYYY-MM-DD, ET, inclusive
YYYY-MM-DD, ET, inclusive
Opciones disponibles:
date, model, topic, region, prompt, persona Opciones disponibles:
visibility_score, share_of_voice, average_position Opciones disponibles:
day, week, month Opciones disponibles:
owned, all A name (is), a list (in), or {op,value} with op is/in/not_in.
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ó?