> ## 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.
# Exporter les analyses brutes
> POST /analytics/qr/raw/
Exporte des enregistrements d'analyse **bruts, par scan** — une ligne par événement de scan, plutôt que les répartitions agrégées que renvoient [Analyses des QR codes](/fr/api-reference/management-api/analytics/qr-analytics) et [Exporter les analyses](/fr/api-reference/management-api/analytics/export).
Il s'agit d'un endpoint **POST uniquement** — une requête `GET` renvoie `405 Method Not Allowed`. La spécification `management-api.json` le listait auparavant comme `GET` ; ceci a été corrigé.
Nécessite une clé Management API avec le quota `MANAGEMENT_API` — voir la [vue d'ensemble de la Management API](/fr/api-reference/management-api/overview) — ainsi que le quota `EXPORT_ANALYTICS_REPORT` du compte et la permission `ANALYTICS_CAN_EXPORT_RAW` (distincte de la permission `ANALYTICS_CAN_EXPORT` requise par l'export agrégé — un rôle peut avoir l'une sans l'autre). Une erreur 403 avec « Your plan does not have export analytics report quota. » signifie que le plan n'inclut pas les exports.
## Requête
```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
```
Cet endpoint renvoie toujours un fichier binaire, pas du JSON.
### Paramètres de requête
Date de début (`YYYY-MM-DD`), incluse.
Date de fin (`YYYY-MM-DD`), incluse.
`csv`, `xls` ou `xlsx`. Contrairement à [Exporter les analyses](/fr/api-reference/management-api/analytics/export), `pdf` n'est pas un format pris en charge ici. Toute autre valeur (ou son omission) renvoie une erreur `400` avec « Invalid file format ».
Passez `raw_bot` pour exporter uniquement les enregistrements de scans identifiés comme des bots, plutôt que tous les scans. Toute autre valeur est écrasée — cet endpoint exporte toujours des données brutes, quelle que soit la valeur transmise ici.
### Corps de la requête
Même structure que [Analyses des QR codes](/fr/api-reference/management-api/analytics/qr-analytics#request-body) — `q` (obligatoire) et `filter_by` (par défaut `qrid`) délimitent les QR codes dont les scans bruts doivent être inclus, et le même [plafond de volume QR codes/plage de dates](/fr/api-reference/management-api/analytics/qr-analytics#request) s'applique.
Identifiants pour délimiter l'export — le type dépend de `filter_by`.
`qrid`, `id`, `tags` ou `folder`.
### Formats de réponse
Renvoie un unique CSV (`text/csv`, `analytics_raw.csv`) contenant les lignes de scans bruts.
Renvoie un tableur (`analytics_raw.xlsx`) avec les lignes de scans bruts, plus une feuille séparée pour les enregistrements bruts de suivi d'événements si le compte a le suivi d'événements activé.
Si le compte a les analyses de suivi d'événements activées **et** que `file_format` n'est pas `csv`, une seconde feuille/section d'enregistrements bruts de suivi d'événements (ID de session, horodatage, ID/nom du QR code, ID de suivi d'événement spécifié par l'utilisateur, hash d'URL, URL) est ajoutée automatiquement. Demander `csv` renvoie toujours uniquement les enregistrements de scans — les lignes de suivi d'événements sont omises spécifiquement pour ce format.
## Voir aussi
* [Analyses des QR codes](/fr/api-reference/management-api/analytics/qr-analytics) — l'équivalent agrégé en JSON de ces enregistrements de scans bruts.
* [Exporter les analyses](/fr/api-reference/management-api/analytics/export) — exportez des répartitions de métriques agrégées plutôt que des données de scans ligne par ligne.
* [Vue d'ensemble de la Management API](/fr/api-reference/management-api/overview) — le schéma d'authentification et l'architecture de quotas dont fait partie cet 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.
````