curl -X POST https://api.tryprofound.com/v2/reports/shopping/trigger-rate \
-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": ["total_runs", "shopping_triggered_runs", "trigger_rate_percentage"],
"limit": 10
}'
{
"info": {
"total_results": 30,
"count": 10,
"next_cursor": "eyJvZmZzZXQiOjEwfQ==",
"models": ["ChatGPT"],
"metrics": ["total_runs", "shopping_triggered_runs", "trigger_rate_percentage"],
"start_date": "2026-06-01",
"end_date": "2026-06-30",
"filter": null
},
"data": [
{
"date": "2026-06-01",
"total_runs": 1240,
"shopping_triggered_runs": 388,
"trigger_rate_percentage": 0.313
}
]
}
Compras
Tasa de activación
POST
/
v2
/
reports
/
shopping
/
trigger-rate
curl -X POST https://api.tryprofound.com/v2/reports/shopping/trigger-rate \
-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": ["total_runs", "shopping_triggered_runs", "trigger_rate_percentage"],
"limit": 10
}'
{
"info": {
"total_results": 30,
"count": 10,
"next_cursor": "eyJvZmZzZXQiOjEwfQ==",
"models": ["ChatGPT"],
"metrics": ["total_runs", "shopping_triggered_runs", "trigger_rate_percentage"],
"start_date": "2026-06-01",
"end_date": "2026-06-30",
"filter": null
},
"data": [
{
"date": "2026-06-01",
"total_runs": 1240,
"shopping_triggered_runs": 388,
"trigger_rate_percentage": 0.313
}
]
}
Este informe muestra con qué frecuencia ChatGPT devuelve resultados de compras para tus prompts.
Proporciona el total de ejecuciones, las ejecuciones que activaron compras y la tasa de activación.
- Métricas:
total_runs,shopping_triggered_runs,trigger_rate_percentage.trigger_rate_percentageesshopping_triggered_runs / total_runs. Es una fracción de 0 a 1, no de 0 a 100. Para obtener un porcentaje, multiplica el valor por 100. group_by:date,topic,region,persona,prompt.- Campos de filtro:
topic,region,persona,prompt,tag.
prompt a group_by. Para obtener la tasa de
cada tema, añade topic. Para obtener una serie temporal, añade date y establece interval.
Los datos de compras proceden únicamente de ChatGPT. Ningún informe de compras tiene un
group_by
model ni un filtro model.Los informes v2 comparten una misma estructura de solicitud. Para el árbol de filtros, la agrupación y la
paginación, consulta Filtrado y conceptos.
Variante de streaming (SSE) (mismo cuerpo, /stream)
Variante de streaming (SSE) (mismo cuerpo, /stream)
POST /v2/reports/shopping/trigger-rate/stream usa el mismo cuerpo de
solicitud. Devuelve Server-Sent Events:
un evento summary (el bloque info) y, a continuación, un evento result por cada fila.
El stream rechaza limit y cursor. Devuelve todas las filas por defecto. Para
establecer un máximo, usa max_results (máximo 50000).curl -X POST https://api.tryprofound.com/v2/reports/shopping/trigger-rate \
-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": ["total_runs", "shopping_triggered_runs", "trigger_rate_percentage"],
"limit": 10
}'
{
"info": {
"total_results": 30,
"count": 10,
"next_cursor": "eyJvZmZzZXQiOjEwfQ==",
"models": ["ChatGPT"],
"metrics": ["total_runs", "shopping_triggered_runs", "trigger_rate_percentage"],
"start_date": "2026-06-01",
"end_date": "2026-06-30",
"filter": null
},
"data": [
{
"date": "2026-06-01",
"total_runs": 1240,
"shopping_triggered_runs": 388,
"trigger_rate_percentage": 0.313
}
]
}
Autorizaciones
APIKeyHeaderBearerAuth
Cuerpo
application/json
YYYY-MM-DD, ET, inclusive
YYYY-MM-DD, ET, inclusive
Group by prompt/topic for the per-prompt/-topic trigger rate.
Opciones disponibles:
date, topic, region, persona, prompt Opciones disponibles:
total_runs, shopping_triggered_runs, trigger_rate_percentage Opciones disponibles:
day, week, month A leaf (field/op/value) or an and/or/not group.
Show child attributes
Show child attributes
Page size; default 10, max 50.
Rango requerido:
0 < x <= 50Stream endpoint only: cap streamed rows.
Rango requerido:
0 < x <= 50000¿Esta página le ayudó?