curl -X POST https://api.tryprofound.com/v2/reports/shopping/brands \
-H "X-API-Key: <your-api-key>" \
-H "Content-Type: application/json" \
-d '{
"category_id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
"start_date": "2026-06-01",
"end_date": "2026-06-30",
"group_by": ["date"],
"metrics": ["visibility_score", "average_position", "visibility_rank"],
"scope": "owned",
"limit": 10
}'
{
"info": {
"total_results": 1,
"count": 1,
"next_cursor": null,
"scope": "owned",
"assets": null,
"models": ["ChatGPT"],
"metrics": ["visibility_score", "average_position", "visibility_rank"],
"start_date": "2026-06-01",
"end_date": "2026-06-30",
"filter": null
},
"data": [
{
"asset": { "name": "Example Brand", "owned": true },
"date": "2026-06-01",
"visibility_score": 0.42,
"average_position": 3.2,
"visibility_rank": 1
}
]
}
Compras
Marcas
POST
/
v2
/
reports
/
shopping
/
brands
curl -X POST https://api.tryprofound.com/v2/reports/shopping/brands \
-H "X-API-Key: <your-api-key>" \
-H "Content-Type: application/json" \
-d '{
"category_id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
"start_date": "2026-06-01",
"end_date": "2026-06-30",
"group_by": ["date"],
"metrics": ["visibility_score", "average_position", "visibility_rank"],
"scope": "owned",
"limit": 10
}'
{
"info": {
"total_results": 1,
"count": 1,
"next_cursor": null,
"scope": "owned",
"assets": null,
"models": ["ChatGPT"],
"metrics": ["visibility_score", "average_position", "visibility_rank"],
"start_date": "2026-06-01",
"end_date": "2026-06-30",
"filter": null
},
"data": [
{
"asset": { "name": "Example Brand", "owned": true },
"date": "2026-06-01",
"visibility_score": 0.42,
"average_position": 3.2,
"visibility_rank": 1
}
]
}
Este informe muestra la visibilidad de las marcas en los resultados de compras
de ChatGPT. Indica con qué frecuencia aparece cada marca, su posición promedio
y su clasificación. Selecciona las marcas con
assets. Divide los resultados
con group_by. Cada métrica es un campo con nombre en la fila.
- Métricas:
visibility_score(la proporción de resultados de compras que incluyen la marca);average_position(la clasificación promedio cuando aparece la marca; un número más bajo es mejor);visibility_rank. group_by:date,topic,regionoprompt.- Selección de marcas: selecciona las marcas con el parámetro
assets. Indica un nombre o una lista.scope: "all"clasifica todas las marcas.scope: "owned"(el valor predeterminado) devuelve solo tus marcas. Una selección conassetsdevuelve una sola página e ignoralimit. - Campos de filtro:
topic,region,persona,prompt,tag.
Los datos de compras provienen solo de ChatGPT. Ningún informe de compras
tiene un group_by de
model ni un filtro de model.Los informes v2 comparten una misma forma de solicitud. Para conocer el árbol
de filtros, la agrupación y la paginación, consulta Filtrado y conceptos.
Variante con streaming (SSE) (mismo cuerpo, /stream)
Variante con streaming (SSE) (mismo cuerpo, /stream)
POST /v2/reports/shopping/brands/stream usa el mismo cuerpo de solicitud.
Devuelve Server-Sent Events:
un evento summary (el bloque info) y luego un evento result por cada fila.
El stream rechaza limit y cursor. Devuelve todas las filas de forma
predeterminada. Para establecer un máximo, usa max_results (máximo 50000).
Usa el stream para obtener un resultado grande en una sola solicitud.curl -X POST https://api.tryprofound.com/v2/reports/shopping/brands \
-H "X-API-Key: <your-api-key>" \
-H "Content-Type: application/json" \
-d '{
"category_id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
"start_date": "2026-06-01",
"end_date": "2026-06-30",
"group_by": ["date"],
"metrics": ["visibility_score", "average_position", "visibility_rank"],
"scope": "owned",
"limit": 10
}'
{
"info": {
"total_results": 1,
"count": 1,
"next_cursor": null,
"scope": "owned",
"assets": null,
"models": ["ChatGPT"],
"metrics": ["visibility_score", "average_position", "visibility_rank"],
"start_date": "2026-06-01",
"end_date": "2026-06-30",
"filter": null
},
"data": [
{
"asset": { "name": "Example Brand", "owned": true },
"date": "2026-06-01",
"visibility_score": 0.42,
"average_position": 3.2,
"visibility_rank": 1
}
]
}
Autorizaciones
APIKeyHeaderBearerAuth
Cuerpo
application/json
YYYY-MM-DD, ET, inclusive
YYYY-MM-DD, ET, inclusive
Opciones disponibles:
date, topic, region, prompt Opciones disponibles:
visibility_score, average_position, visibility_rank Opciones disponibles:
day, week, month Opciones disponibles:
owned, all Restrict to these asset names (a name or list). Overrides scope.
A leaf (field/op/value) or an and/or/not group.
Show child attributes
Show child attributes
Page size for scope=all; default 10, max 50.
Rango requerido:
0 < x <= 50Stream endpoint only: cap the number of streamed rows (default: all).
Rango requerido:
0 < x <= 50000¿Esta página le ayudó?