> ## Documentation Index
> Fetch the complete documentation index at: https://docs.scanova.io/llms.txt
> Use this file to discover all available pages before exploring further.
# Analíticas de QR
> POST /analytics/qr/
Devuelve analíticas de escaneo agregadas para uno o más códigos QR, agrupadas por el tipo o tipos de métrica que solicites.
Este es un endpoint **solo POST** a pesar de que el nombre sugiere una consulta — una solicitud `GET` devuelve `405 Method Not Allowed`. Los parámetros de consulta (`from`, `to`, `type`) seleccionan el rango de fechas y las métricas; el cuerpo de la solicitud selecciona qué códigos QR incluir.
Requiere una clave de la API de gestión con cuota `MANAGEMENT_API` (o `MANAGEMENT_API_SANDBOX`) — consulta el [resumen de la API de gestión](/es/api-reference/management-api/overview) — además de la propia cuota `QR_ANALYTICS_BASIC` de la cuenta. Solicitar algo más allá de la métrica `count` requiere adicionalmente `QR_ANALYTICS_ADVANCED`; sin ella, toda solicitud se degrada silenciosamente a `count` independientemente del `type` que hayas pedido.
## Solicitud
```bash cURL theme={null}
curl --request POST \
--url 'https://management.scanova.io/analytics/qr/?from=2026-07-01&to=2026-08-16&type=qr' \
--header 'Authorization: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"q": ["Q07afe81aa0034c01"],
"filter_by": "qrid"
}'
```
```json 200 theme={null}
{
"qr": [],
"qr_meta": {
"docs-v2-first-qr-code": {
"qrid": "Q07afe81aa0034c01",
"category": "Website URL",
"category_slug": "url"
}
}
}
```
Verificado en vivo — un array `qr` vacío aquí refleja un código QR sin escaneos en la ventana solicitada, no un error. `qr_meta` es un mapa adicional `name -> {qrid, category, category_slug}`, añadido solo cuando `qr` está entre los `type` solicitados, para que quien llama pueda enlazar en profundidad desde una fila indexada por nombre de vuelta a su `qrid`. Es aditivo: la forma que quien llama ya interpreta bajo cada clave de métrica no cambia.
### Parámetros de consulta
Fecha de inicio (`YYYY-MM-DD`), inclusiva.
Fecha de fin (`YYYY-MM-DD`), inclusiva.
Tipos de métrica separados por comas, p. ej. `qr,device,geography`. Valores comunes: `count`, `qr`, `date`, `day`, `time`, `utm`, `device`, `os`, `browser`, `handset`, `geography`, `geo_location`, `age`. Requiere la cuota `QR_ANALYTICS_ADVANCED` de la cuenta para cualquier cosa más allá de `count`.
Agrupación para tipos de métrica de serie temporal, p. ej. `date`, `week`, `month`.
Excluye de los resultados los escaneos identificados como tráfico de bots.
Pasa `true` para llamadas de estilo resumen del panel — evita el límite de volumen de cantidad de QR/rango de fechas descrito a continuación, y no cuenta para la señal de actividad "analíticas obtenidas" de la cuenta.
### Cuerpo de la solicitud
Lista de identificadores para limitar las analíticas — el tipo de identificador depende de `filter_by`.
Uno de `qrid` (IDs de código QR), `id` (IDs numéricos internos), `tags` (nombres de etiquetas) o `folder` (IDs de carpeta).
### Respuesta
La respuesta es un objeto indexado por cada `type` de métrica solicitado, más `qr_meta` cuando corresponda (ver arriba). La forma varía según el tipo de métrica — `count` devuelve totales de escaneo, `device`/`os`/`browser`/`geography` devuelven desgloses por esa dimensión, y los tipos de serie temporal (`date`/`day`/`time`) devuelven una serie agrupada por `group`.
Solicitar demasiados códigos QR en un rango de fechas demasiado amplio devuelve un `400` bajo `q`: `"High Volume of data. Either select lower than {N} QR Codes/{N} days time period or generate Analytics Export instead."` En la práctica, tanto [Exportar analíticas](/es/api-reference/management-api/analytics/export) como [Exportar analíticas en bruto](/es/api-reference/management-api/analytics/export-raw) aplican exactamente el mismo límite — los tres endpoints comparten la misma ruta de código de validación de solicitudes — así que la solución real para este error es reducir `q` o el rango de fechas, no cambiar de endpoint.
## Relacionado
* [Exportar analíticas](/es/api-reference/management-api/analytics/export) — descarga el mismo tipo de métricas agregadas como un archivo en lugar de una respuesta JSON.
* [Exportar analíticas en bruto](/es/api-reference/management-api/analytics/export-raw) — descarga registros de escaneo a nivel de fila en lugar de desgloses agregados.
* [Resumen de la API de gestión](/es/api-reference/management-api/overview) — el esquema de autenticación y la arquitectura de cuotas de la que forma parte este endpoint.
## OpenAPI
````yaml api-reference/openapi/management-api.json POST /analytics/qr/
openapi: 3.1.0
info:
title: Scanova Management API (v2)
description: >-
The complete Scanova Management API — every endpoint available at
management.scanova.io (QR codes, folders, tags, leads, forms, analytics,
plans, shared users & roles), plus the token-creation and usage-stats
endpoints used to authenticate against it. Every path and request/response
shape below was verified live against a real API key and the actual running
backend (Phase 7, 2026-08-16) — not guessed from reading urls.py alone.
version: 2.0.0
servers:
- url: https://management.scanova.io
description: Management API — QR/folder/tag/lead/form/analytics/plans endpoints
security:
- apiKeyAuth: []
paths:
/analytics/qr/:
post:
summary: QR analytics
description: >-
Returns aggregated analytics data. Requires `from` and `to` as query
parameters (dates) and a `type` query parameter (comma-separated metric
types, e.g. `qr`). The request body selects which QR codes to include
via `q` (a list of identifiers) and `filter_by` (which identifier type
`q` contains — `qrid` is the default; `tags`, `id`, and `folder` are
also supported). Requesting too many QR codes over too wide a date range
returns a 400 under `q` — the same volume cap applies to
/analytics/qr/export/ and /analytics/qr/raw/, which share this
endpoint's request-validation code.
operationId: getManagedQrAnalytics
parameters:
- name: from
in: query
required: true
schema:
type: string
format: date
- name: to
in: query
required: true
schema:
type: string
format: date
- name: type
in: query
required: true
schema:
type: string
description: Comma-separated metric types, e.g. `qr`.
- name: group
in: query
schema:
type: string
default: date
description: Grouping for time-series metric types, e.g. date/week/month.
- name: exclude_bot_scan
in: query
schema:
type: boolean
default: false
- name: overview
in: query
schema:
type: boolean
description: Bypasses the volume cap; used by dashboard overview widgets.
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
q:
type: array
items:
type: string
description: >-
Query data — a list of identifiers of the type named in
filter_by.
filter_by:
type: string
enum:
- qrid
- tags
- id
- folder
default: qrid
required:
- q
example:
q:
- Q07afe81aa0034c01
filter_by: qrid
responses:
'200':
description: >-
Analytics data, grouped by the requested type(s). A `qr_meta`
name->{qrid, category, category_slug} map is attached whenever `qr`
is among the requested types.
content:
application/json:
example:
qr: []
qr_meta:
docs-v2-first-qr-code:
qrid: Q07afe81aa0034c01
category: Website URL
category_slug: url
components:
securitySchemes:
apiKeyAuth:
type: apiKey
in: header
name: Authorization
description: >-
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.
````