curl --request POST \
--url 'https://management.scanova.io/analytics/qr/export/?from=2026-07-01&to=2026-08-16&file_format=xlsx' \
--header 'Authorization: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"q": ["Q07afe81aa0034c01"],
"filter_by": "qrid"
}' \
--output analytics.xlsx
API de gestión — Analítica y planes
Exportar analíticas
POST /analytics/qr/export/
POST
/
analytics
/
qr
/
export
/
curl --request POST \
--url 'https://management.scanova.io/analytics/qr/export/?from=2026-07-01&to=2026-08-16&file_format=xlsx' \
--header 'Authorization: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"q": ["Q07afe81aa0034c01"],
"filter_by": "qrid"
}' \
--output analytics.xlsx
Exporta analíticas agregadas — todos los tipos de métrica que permite el plan de la cuenta (
Este endpoint siempre devuelve un archivo binario, no JSON — consulta los formatos de respuesta a continuación.
count, date, qr, utm, device, os, browser, geography, y más) — como un archivo descargable, en lugar de un único payload JSON limitado a un type como requiere Analíticas de QR.
Este es un endpoint solo POST — una solicitud
GET devuelve 405 Method Not Allowed. La especificación management-api.json lo indicaba anteriormente como GET; esto se ha corregido.Requiere una clave de la API de gestión con cuota
MANAGEMENT_API — consulta el resumen de la API de gestión — además de la cuota EXPORT_ANALYTICS_REPORT y el permiso ANALYTICS_CAN_EXPORT de la cuenta. Un 403 con "Your plan does not have export analytics report quota." significa que el plan no incluye exportaciones.Solicitud
curl --request POST \
--url 'https://management.scanova.io/analytics/qr/export/?from=2026-07-01&to=2026-08-16&file_format=xlsx' \
--header 'Authorization: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"q": ["Q07afe81aa0034c01"],
"filter_by": "qrid"
}' \
--output analytics.xlsx
Parámetros de consulta
string
requerido
Fecha de inicio (
YYYY-MM-DD), inclusiva.string
requerido
Fecha de fin (
YYYY-MM-DD), inclusiva.string
requerido
csv, xls, xlsx o pdf. Cualquier otro valor (u omitirlo) devuelve un 400 con "Invalid file format".boolean
predeterminado:"false"
Excluye de la exportación los escaneos identificados como bots.
Cuerpo de la solicitud
Misma forma que Analíticas de QR:array
requerido
Identificadores para limitar la exportación — el tipo depende de
filter_by.string
predeterminado:"qrid"
qrid, id, tags o folder.Formatos de respuesta
- csv
- xls / xlsx
- pdf
Devuelve un archivo ZIP (
application/zip, analytics.zip) que contiene un CSV por cada tipo de métrica — no un único CSV plano. Esta es una particularidad real del formato de exportación: solicitar csv te da un zip, no un archivo .csv directamente.Devuelve una única hoja de cálculo (
analytics.xlsx) con una hoja por cada tipo de métrica.Devuelve un informe de analíticas en PDF renderizado (
application/pdf, analytics.pdf) — un resumen con formato en lugar de hojas sin procesar por métrica.Si la cuenta tiene habilitadas las analíticas de seguimiento de eventos, sus métricas
count/engagement se añaden automáticamente como hojas/archivos adicionales en la misma exportación — sin necesidad de ningún parámetro adicional.A pesar de que el mensaje de error subyacente sugiere “generate Analytics Export instead”, este endpoint aplica el mismo límite de volumen de cantidad de códigos QR/rango de fechas que Analíticas de QR — todos los endpoints de analíticas comparten la misma ruta de código de validación de solicitudes. Si obtienes el
400 bajo q, reduce q o el rango de fechas; cambiar solo a este endpoint no lo evitará.Relacionado
- Analíticas de QR — el equivalente JSON de esta exportación, limitado a los tipos de métrica que elijas.
- Exportar analíticas en bruto — exporta registros de escaneo a nivel de fila en lugar de estos desgloses agregados.
- Resumen de la API de gestión — el esquema de autenticación y la arquitectura de cuotas de la que forma parte este endpoint.
Autorizaciones
Send your Management API key as the raw value of the Authorization header — no "Bearer " or "Token " prefix, and no other characters. Example: Authorization: 401f7ac837da42b97f613d789819ff93537bee6a. A header containing more than one space-separated part is rejected outright. Requests also require the request's Host header to be the management API host (e.g. management.scanova.io) — the same key sent to the regular API host will not authenticate.
Parámetros de consulta
Opciones disponibles:
csv, xls, xlsx, pdf Cuerpo
application/json
Respuesta
Binary file download — application/zip for csv, spreadsheet mimetype for xls/xlsx, application/pdf for pdf.
¿Esta página le ayudó?
⌘I