Analytics

curl "https://getqr.com/api/v1/qrs/qr_1EPcVfeHZAY2iNoVLsgW2Aqf/analytics?groupBy=count&interval=30d" \
  -H "Authorization: Bearer $GETQR_API_KEY"

curl "https://getqr.com/api/v1/qrs/qr_1EPcVfeHZAY2iNoVLsgW2Aqf/analytics?groupBy=count&interval=30d&unique=true" \
  -H "Authorization: Bearer $GETQR_API_KEY"

curl "https://getqr.com/api/v1/qrs/qr_1EPcVfeHZAY2iNoVLsgW2Aqf/analytics?groupBy=countries&interval=7d" \
  -H "Authorization: Bearer $GETQR_API_KEY"

{
  "clicks": 142
}

curl "https://getqr.com/api/v1/qrs/qr_1EPcVfeHZAY2iNoVLsgW2Aqf/analytics?groupBy=count&interval=30d" \
  -H "Authorization: Bearer $GETQR_API_KEY"

curl "https://getqr.com/api/v1/qrs/qr_1EPcVfeHZAY2iNoVLsgW2Aqf/analytics?groupBy=count&interval=30d&unique=true" \
  -H "Authorization: Bearer $GETQR_API_KEY"

curl "https://getqr.com/api/v1/qrs/qr_1EPcVfeHZAY2iNoVLsgW2Aqf/analytics?groupBy=countries&interval=7d" \
  -H "Authorization: Bearer $GETQR_API_KEY"

{
  "clicks": 142
}

Die GetQR API befindet sich in der Beta-Phase und steht ausgewählten Workspaces zur Verfügung. Details können sich bis zur allgemeinen Veröffentlichung noch ändern.

Rufen Sie Scan-Summen und Aufschlüsselungen nach Land, Gerät, Browser und mehr ab, für einen einzelnen QR-Code oder über Ihren gesamten Workspace.

Methode	Pfad	Beschreibung
`GET`	`/api/v1/qrs/{qrId}/analytics`	Analytics für einen QR-Code abrufen
`GET`	`/api/v1/analytics`	Analytics für den Workspace abrufen

Eine fertige Zusammenfassung pro QR-Code finden Sie unter Berichte.

Was die Zahlen bedeuten

Scans. Jede Zählung steht im Feld clicks. Ein Scan wird jedes Mal gezählt, wenn jemand den Kurzlink des QR-Codes öffnet.
Eindeutige Scans. Mit unique=true wird jeder Besucher im Zeitraum nur einmal gezählt.
Umfang. Die Zahlen stammen vom Kurzlink des QR-Codes. Ein QR-Code ohne Kurzlink hat keine Scans, die gezählt werden könnten.
Verlauf. Analytics lassen sich über die API nicht zurücksetzen. Das Löschen eines QR-Codes entfernt seine bisherigen Scandaten nicht.

string

erforderlich

Bearer gefolgt von Ihrem API-Schlüssel. Siehe Authentifizierung.

Query-Parameter

Beide Endpunkte akzeptieren diese Parameter. Alle sind optional.

string

Standard:"count"

Dimension der Aufschlüsselung. count liefert die Gesamtzahl. Alle Werte und ihre Antwortstruktur finden Sie unter Aufschlüsselungen.

string

Standard:"30d"

Vordefinierter Zeitraum: 24h, 7d, 30d, 90d, 1y, mtd, qtd, ytd oder all. Siehe Zeiträume. Wird ignoriert, wenn Sie start senden.

string

Beginn eines eigenen Zeitraums, ISO 8601, zum Beispiel 2026-08-01 oder 2026-08-01T00:00:00Z. Hat Vorrang vor interval. Muss vor end liegen.

string

Ende eines eigenen Zeitraums, ISO 8601. Standard ist das Ende des heutigen Tages. Wird zusammen mit start oder interval=all verwendet und bei den anderen Intervallen ignoriert.

string

Standard:"UTC"

IANA-Zeitzone, an der die timeseries-Intervalle ausgerichtet werden, zum Beispiel America/New_York. Eine unbekannte Zeitzone liefert 422.

boolean

Standard:"false"

true zählt eindeutige Scans statt aller Scans.

Sie können außerdem Dimensionsfilter senden.

Zeiträume

`interval`	Umfasst	`timeseries`-Intervalle
`24h`	Die letzten 24 Stunden	Stunden
`7d`	Die letzten 7 Tage, einschließlich heute	Tage
`30d`	Die letzten 30 Tage, einschließlich heute	Tage
`90d`	Die letzten 90 Tage, einschließlich heute	Tage
`1y`	Die letzten 365 Tage, einschließlich heute	Monate
`mtd`	Seit Monatsbeginn	Tage
`qtd`	Seit Quartalsbeginn	Tage
`ytd`	Seit Jahresbeginn	Tage, nach 180 Tagen Monate
`all`	Seit Erstellung Ihres Workspace	Tage, nach 180 Tagen Monate

Für einen eigenen Zeitraum senden Sie start und optional end. Zeiträume bis 2 Tage verwenden stündliche Intervalle, Zeiträume über 180 Tage monatliche und alles dazwischen tägliche.

Dimensionsfilter

Beschränken Sie die Ergebnisse auf Scans, die einem Filter entsprechen. Verschiedene Filter werden mit UND verknüpft. Nimmt ein Filter mehrere Werte an, trennen Sie diese durch Kommas: Die Werte werden mit ODER verknüpft.

Filter	Wert	Mehrere Werte
`country`	Ländercode nach ISO 3166-1 alpha-2, zum Beispiel `US`	Ja
`region`	Regionscode nach ISO 3166-2, zum Beispiel `US-CA`	Ja
`city`	Name der Stadt, zum Beispiel `New York`	Ja
`continent`	`AF`, `AN`, `AS`, `EU`, `NA`, `OC` oder `SA`	Ja
`device`	Gerätetyp, zum Beispiel `Mobile` oder `Desktop`	Ja
`browser`	Name des Browsers, zum Beispiel `Chrome`	Ja
`os`	Betriebssystem, zum Beispiel `iOS` oder `Windows`	Ja
`url`	Ziel-URL	Ja
`referer`	Referrer, zum Beispiel `google.com`	Nein
`utm_source`, `utm_medium`, `utm_campaign`, `utm_term`, `utm_content`	UTM-Wert, bis zu 190 Zeichen	Nein

Ein unbekannter Länder- oder Kontinentcode liefert 422. Namen von Geräten, Browsern und Betriebssystemen werden mit großem Anfangsbuchstaben abgeglichen, daher funktioniert mobile wie Mobile. Zum Beispiel Scans aus den USA oder Kanada auf Mobilgeräten: ?country=US,CA&device=Mobile.

Aufschlüsselungen

count liefert ein Objekt. Alle anderen Werte liefern ein Array, absteigend nach clicks sortiert (timeseries ist nach Zeit sortiert).

`groupBy`	Jedes Element enthält
`count`	`clicks` (ein Objekt, kein Array)
`timeseries`	`start` (Beginn des Intervalls), `clicks`
`continents`	`continent`, `clicks`
`regions`	`region`, `country`, `clicks`
`countries`	`country`, `city` (immer `*`), `clicks`
`cities`	`city`, `country`, `clicks`
`devices`	`device`, `clicks`
`browsers`	`browser`, `clicks`
`os`	`os`, `clicks`
`triggers`	`trigger` (`qr` oder `link`), `clicks`
`referers`	`referer` (`(direct)`, wenn unbekannt), `clicks`
`referer_urls`	`refererUrl` (`(direct)`, wenn unbekannt), `clicks`
`top_links`	`id`, `domain`, `key`, `shortLink`, `url`, `createdAt`, `qr` (`id`, `qrType`, `title`), `clicks`
`top_urls`	`url`, `clicks`
`top_types`	`qr_type`, `clicks`
`utm_sources`, `utm_mediums`, `utm_campaigns`, `utm_terms`, `utm_contents`	Der UTM-Wert (`utm_source`, `utm_medium`, `utm_campaign`, `utm_term` oder `utm_content`), `clicks`

Ein unbekannter Wert für groupBy liefert 422 mit der Liste der gültigen Werte. Antwort bei groupBy=count:

{ "clicks": 142 }

Antwort bei groupBy=countries:

[
  { "country": "US", "city": "*", "clicks": 87 },
  { "country": "DE", "city": "*", "clicks": 31 },
  { "country": "GB", "city": "*", "clicks": 24 }
]

Analytics für einen QR-Code abrufen

GET /api/v1/qrs/{qrId}/analytics Liefert Scan-Statistiken für einen QR-Code, beschränkt auf seinen Kurzlink. Akzeptiert die oben beschriebenen Query-Parameter und Dimensionsfilter.

string

erforderlich

ID des QR-Codes. Nehmen Sie sie aus der Antwort der Liste oder der Erstellung unter QR-Codes.

curl "https://getqr.com/api/v1/qrs/qr_1EPcVfeHZAY2iNoVLsgW2Aqf/analytics?groupBy=count&interval=30d" \
  -H "Authorization: Bearer $GETQR_API_KEY"

curl "https://getqr.com/api/v1/qrs/qr_1EPcVfeHZAY2iNoVLsgW2Aqf/analytics?groupBy=count&interval=30d&unique=true" \
  -H "Authorization: Bearer $GETQR_API_KEY"

curl "https://getqr.com/api/v1/qrs/qr_1EPcVfeHZAY2iNoVLsgW2Aqf/analytics?groupBy=countries&interval=7d" \
  -H "Authorization: Bearer $GETQR_API_KEY"

{
  "clicks": 142
}

Analytics für den Workspace abrufen

GET /api/v1/analytics Liefert Scan-Statistiken über alle QR-Codes Ihres Workspace. Akzeptiert die oben beschriebenen Query-Parameter und Dimensionsfilter sowie diese Parameter zur Eingrenzung.

string

Beschränkt die Ergebnisse zusammen mit key auf den Kurzlink mit dieser Domain, zum Beispiel getqr.sh. Die Domain muss zu Ihrem Workspace gehören.

string

Slug des Kurzlinks, zum Beispiel x7Kd2p1. Verwenden Sie ihn zusammen mit domain. Beide stehen im QR-Code-Objekt.

string

Kommagetrennte QR-Code-Typen, die einbezogen werden: website, pdf, image, video, whatsapp, social, wifi, app, feedback, vcard, sms, payment, location, multilink, email oder event. Siehe QR-Typen.

curl "https://getqr.com/api/v1/analytics?groupBy=devices&interval=7d" \
  -H "Authorization: Bearer $GETQR_API_KEY"

curl "https://getqr.com/api/v1/analytics?groupBy=devices&interval=30d&qrType=website" \
  -H "Authorization: Bearer $GETQR_API_KEY"

curl "https://getqr.com/api/v1/analytics?groupBy=count&domain=getqr.sh&key=x7Kd2p1" \
  -H "Authorization: Bearer $GETQR_API_KEY"

[
  { "device": "Mobile", "clicks": 980 },
  { "device": "Desktop", "clicks": 240 }
]

Häufige Probleme

400 "QR has no associated link."

Der QR-Code hat keinen Kurzlink, daher gibt es keine Scans zu zählen.

404 beim Filtern nach domain und key

In Ihrem Workspace gibt es keinen Kurzlink mit dieser Domain und diesem Slug. Kopieren Sie domain und key aus dem QR-Code-Objekt.

422 bei groupBy, interval oder einem Filter

Der Wert wird nicht unterstützt. Die Fehlermeldung nennt den Parameter und listet die gültigen Werte auf.

Die Zahlen stimmen nicht mit dem Dashboard überein

Prüfen Sie, ob Sie denselben Zeitraum und dieselbe Zeitzone verwenden und ob Sie eindeutige Scans (unique=true) oder alle Scans zählen.

API

Was die Zahlen bedeuten

Header

Query-Parameter

Zeiträume

Dimensionsfilter

Aufschlüsselungen

Analytics für einen QR-Code abrufen

Analytics für den Workspace abrufen

Häufige Probleme

Wie geht es weiter?

Berichte

QR-Codes

Analytics in der App

Ratenbegrenzungen

​Was die Zahlen bedeuten

​Header

​Query-Parameter

​Zeiträume

​Dimensionsfilter

​Aufschlüsselungen

​Analytics für einen QR-Code abrufen

​Analytics für den Workspace abrufen

​Häufige Probleme

​Wie geht es weiter?

Berichte

QR-Codes

Analytics in der App

Ratenbegrenzungen

Was die Zahlen bedeuten

Header

Query-Parameter

Zeiträume

Dimensionsfilter

Aufschlüsselungen

Analytics für einen QR-Code abrufen

Analytics für den Workspace abrufen

Häufige Probleme

Wie geht es weiter?