> ## 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.
# Exportar analíticas en bruto
> POST /analytics/qr/raw/
Exporta registros de analíticas **en bruto, por escaneo** — una fila por evento de escaneo, en lugar de los desgloses agregados que devuelven [Analíticas de QR](/es/api-reference/management-api/analytics/qr-analytics) y [Exportar analíticas](/es/api-reference/management-api/analytics/export).
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](/es/api-reference/management-api/overview) — además de la cuota `EXPORT_ANALYTICS_REPORT` y el permiso `ANALYTICS_CAN_EXPORT_RAW` de la cuenta (distinto del permiso `ANALYTICS_CAN_EXPORT` que requiere la exportación agregada — un rol puede tener uno sin el otro). Un 403 con `"Your plan does not have export analytics report quota."` significa que el plan no incluye exportaciones.
## Solicitud
```bash cURL theme={null}
curl --request POST \
--url 'https://management.scanova.io/analytics/qr/raw/?from=2026-07-01&to=2026-08-16&file_format=csv' \
--header 'Authorization: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"q": ["Q07afe81aa0034c01"],
"filter_by": "qrid"
}' \
--output raw-analytics.csv
```
Este endpoint siempre devuelve un archivo binario, no JSON.
### Parámetros de consulta
Fecha de inicio (`YYYY-MM-DD`), inclusiva.
Fecha de fin (`YYYY-MM-DD`), inclusiva.
`csv`, `xls` o `xlsx`. A diferencia de [Exportar analíticas](/es/api-reference/management-api/analytics/export), `pdf` no es un formato admitido aquí. Cualquier otro valor (u omitirlo) devuelve un `400` con `"Invalid file format"`.
Pasa `raw_bot` para exportar solo los registros de escaneo identificados como bots en lugar de todos los escaneos. Cualquier otro valor se sobrescribe — este endpoint siempre exporta datos en bruto independientemente de lo que pases aquí.
### Cuerpo de la solicitud
Misma forma que [Analíticas de QR](/es/api-reference/management-api/analytics/qr-analytics#request-body) — `q` (obligatorio) y `filter_by` (predeterminado `qrid`) limitan qué escaneos en bruto de códigos QR incluir, y se aplica el mismo [límite de volumen de cantidad de QR/rango de fechas](/es/api-reference/management-api/analytics/qr-analytics#request).
Identificadores para limitar la exportación — el tipo depende de `filter_by`.
`qrid`, `id`, `tags` o `folder`.
### Formatos de respuesta
Devuelve un único CSV (`text/csv`, `analytics_raw.csv`) de filas de escaneo en bruto.
Devuelve una hoja de cálculo (`analytics_raw.xlsx`) con filas de escaneo en bruto, además de una hoja separada para los registros en bruto de seguimiento de eventos si la cuenta tiene habilitado el seguimiento de eventos.
Si la cuenta tiene habilitadas las analíticas de seguimiento de eventos **y** `file_format` no es `csv`, se añade automáticamente una segunda hoja/sección de registros en bruto de seguimiento de eventos (ID de sesión, marca de tiempo, ID/nombre del código QR, ID de seguimiento de eventos especificado por el usuario, hash de URL, URL). Solicitar `csv` siempre devuelve solo registros de escaneo — las filas de seguimiento de eventos se omiten específicamente para ese formato.
## Relacionado
* [Analíticas de QR](/es/api-reference/management-api/analytics/qr-analytics) — el equivalente agregado en JSON de estos registros de escaneo en bruto.
* [Exportar analíticas](/es/api-reference/management-api/analytics/export) — exporta desgloses de métricas agregadas en lugar de datos de escaneo a nivel de fila.
* [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/raw/
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/raw/:
post:
summary: Export raw analytics
description: >-
Exports raw, per-scan analytics records (one row per scan) as csv, xls,
or xlsx (no pdf). POST-only; shares its request body and volume-cap
validation with /analytics/qr/. Pass type=raw_bot as a query parameter
to export bot-only scan records instead of all scans.
operationId: exportManagedRawAnalytics
parameters:
- name: from
in: query
required: true
schema:
type: string
format: date
- name: to
in: query
required: true
schema:
type: string
format: date
- name: file_format
in: query
required: true
schema:
type: string
enum:
- csv
- xls
- xlsx
- name: type
in: query
schema:
type: string
enum:
- raw_bot
description: >-
Pass raw_bot for a bot-only export; any other value is overwritten
to raw.
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
q:
type: array
items:
type: string
filter_by:
type: string
enum:
- qrid
- tags
- id
- folder
default: qrid
required:
- q
example:
q:
- Q07afe81aa0034c01
filter_by: qrid
responses:
'200':
description: >-
Binary file download — text/csv for csv, spreadsheet mimetype for
xls/xlsx.
content:
text/csv: {}
application/vnd.openxmlformats-officedocument.spreadsheetml.sheet: {}
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.
````