> ## 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.
# QR-Analysen
> POST /analytics/qr/
Gibt aggregierte Scan-Analysen für einen oder mehrere QR-Codes zurück, gruppiert nach den von Ihnen angeforderten Metriktyp(en).
Dies ist ein **ausschließlich POST**-Endpunkt, obwohl der Name eine Abfrage nahelegt — eine `GET`-Anfrage gibt `405 Method Not Allowed` zurück. Die Query-Parameter (`from`, `to`, `type`) wählen den Datumsbereich und die Metriken aus; der Request-Body wählt aus, welche QR-Codes einbezogen werden.
Erfordert einen Management-API-Schlüssel mit `MANAGEMENT_API`- (oder `MANAGEMENT_API_SANDBOX`-)Quota — siehe die [Management-API-Übersicht](/de/api-reference/management-api/overview) — sowie die eigene `QR_ANALYTICS_BASIC`-Quota des Kontos. Alles über die Metrik `count` hinaus erfordert zusätzlich `QR_ANALYTICS_ADVANCED`; ohne diese wird jede Anfrage stillschweigend auf `count` herabgestuft, unabhängig davon, welchen `type` Sie angefordert haben.
## Anfrage
```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"
}
}
}
```
Live verifiziert — ein leeres `qr`-Array hier spiegelt einen QR-Code mit null Scans im angeforderten Zeitfenster wider, keinen Fehler. `qr_meta` ist eine zusätzliche Zuordnung `name -> {qrid, category, category_slug}`, die nur hinzugefügt wird, wenn `qr` unter den angeforderten `type`s ist, damit ein Aufrufer von einer namensbasierten Zeile zu ihrer `qrid` zurückverlinken kann. Sie ist additiv: Die Form, die Aufrufer bereits unter jedem Metrikschlüssel parsen, bleibt unverändert.
### Query-Parameter
Startdatum (`YYYY-MM-DD`), inklusive.
Enddatum (`YYYY-MM-DD`), inklusive.
Kommagetrennte Metriktypen, z. B. `qr,device,geography`. Gängige Werte: `count`, `qr`, `date`, `day`, `time`, `utm`, `device`, `os`, `browser`, `handset`, `geography`, `geo_location`, `age`. Erfordert die `QR_ANALYTICS_ADVANCED`-Quota des Kontos für alles über `count` hinaus.
Gruppierung für Zeitreihen-Metriktypen, z. B. `date`, `week`, `month`.
Schließt als Bot-Traffic identifizierte Scans aus den Ergebnissen aus.
Übergeben Sie `true` für Aufrufe im Stil der Dashboard-Übersicht — umgeht das unten beschriebene QR-Zahl-/Datumsbereich-Volumenlimit und zählt nicht zum "Analysen abgerufen"-Aktivitätssignal des Kontos.
### Request-Body
Liste von Bezeichnern, auf die die Analysen beschränkt werden — der Typ des Bezeichners hängt von `filter_by` ab.
Einer von `qrid` (QR-Code-IDs), `id` (interne numerische IDs), `tags` (Tag-Namen) oder `folder` (Ordner-IDs).
### Antwort
Die Antwort ist ein Objekt, das nach jedem angeforderten Metrik-`type` verschlüsselt ist, plus `qr_meta` sofern zutreffend (siehe oben). Die Form variiert je nach Metriktyp — `count` gibt Gesamtzahlen der Scans zurück, `device`/`os`/`browser`/`geography` geben Aufschlüsselungen nach dieser Dimension zurück, und Zeitreihen-Typen (`date`/`day`/`time`) geben eine nach `group` gebündelte Serie zurück.
Das Anfordern zu vieler QR-Codes über einen zu weiten Datumsbereich gibt einen `400`-Fehler unter `q` zurück: `"High Volume of data. Either select lower than {N} QR Codes/{N} days time period or generate Analytics Export instead."` In der Praxis setzen sowohl [Analysen exportieren](/de/api-reference/management-api/analytics/export) als auch [Rohe Analysen exportieren](/de/api-reference/management-api/analytics/export-raw) genau dasselbe Limit durch — alle drei Endpunkte teilen sich denselben Code-Pfad zur Anfragevalidierung — die tatsächliche Lösung für diesen Fehler besteht also darin, `q` oder den Datumsbereich einzugrenzen, nicht den Endpunkt zu wechseln.
## Verwandte Themen
* [Analysen exportieren](/de/api-reference/management-api/analytics/export) — laden Sie dieselbe Art aggregierter Metriken als Datei statt als JSON-Antwort herunter.
* [Rohe Analysen exportieren](/de/api-reference/management-api/analytics/export-raw) — laden Sie Datensätze auf Scan-Ebene statt aggregierter Aufschlüsselungen herunter.
* [Management-API-Übersicht](/de/api-reference/management-api/overview) — das Auth-Schema und die Quota-Architektur, zu der dieser Endpunkt gehört.
## 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.
````