QR-Code-Statistik per API: Scans in eigene Berichte holen

Was gezählt wird

Same-QR zählt für jeden dynamischen Code, wie oft er gescannt wurde. Ein Profil der Scannenden entsteht dabei nicht. Aussagekräftig wird die Zählung durch gute Aufteilung: ein Code je Ort, Werbemittel oder Filiale. Die Statistik eines Codes enthält die Scans insgesamt, das Anlagedatum, wie oft das Ziel geändert wurde und ob der Code inaktiv ist, etwa weil das Konto über der Grenze seines Tarifs liegt.

Schritt 1: Leseschlüssel anlegen

Für Berichte brauchst du nie Schreibrechte. Leg im Dashboard unter Konto, „Zugang für CLI, Skripte und Agenten“, einen Schlüssel mit „nur lesen“ an und nenne ihn nach seinem Zweck, etwa „Monatsbericht“. Er kann Zahlen abfragen, aber nichts ändern oder löschen. Gerade für Aufträge, die unbeaufsichtigt laufen, ist das wichtig.

Schritt 2: Zahlen abrufen

Per REST-API liefert die Liste aller Codes schon die Scan-Zahl je Code mit, die Statistik eines einzelnen Codes holst du gezielt:

curl -H "Authorization: Bearer $SAMEQR_API_KEY" https://sameqr.com/api/v1/qr
curl -H "Authorization: Bearer $SAMEQR_API_KEY" https://sameqr.com/api/v1/qr/<id>/stats

Mit der Kommandozeile geht es kürzer:

sameqr qr list --json > scans-$(date +%Y-%m).json
sameqr qr stats <id>

Schritt 3: Bericht bauen

Weil Scan-Zahlen Summen sind, speicherst du jeden Monat einen Stand und vergleichst ihn mit dem Vormonat. Die Differenz ist die Zahl der Scans im Monat. Typische Berichte:

• Monatsbericht für einen Agenturkunden mit allen Codes seines Kundenprojekts.
• Vergleich mehrerer Filialen, wenn jede Filiale eigene Codes und ein eigenes Label hat.
• Auswertung einer Plakatkampagne nach Standorten.

Ohne eigenes Programm geht es auch: Ein Assistent wie ChatGPT oder Claude mit Same-QR als Connector beantwortet „Welche fünf Codes wurden am häufigsten gescannt?“ direkt im Gespräch.

Grenzen der Zahlen

• Ein Scan heißt nicht, dass jemand die Seite gelesen hat.
• Wenige Scans können am Ort liegen, etwa an schlechtem Licht oder einem zu kleinen Code.
• Für Verhalten auf der Website brauchst du die Webanalyse. Kampagnen mit utm-Parametern verbinden beides.

Fazit: Warum Same-QR

Same-QR zählt sauber und datensparsam, und du kommst an die Zahlen, wie es dir passt: im Dashboard, per API, per CLI oder im Gespräch mit einem Assistenten. Ein Leseschlüssel genügt, und die API ist in jedem Tarif dabei.

Leg gleich los: Registriere dich kostenlos auf sameqr.com, zwei dynamische QR-Codes sind dauerhaft gratis. API, CLI und MCP-Server gibt es in jedem Tarif, die Dokumentation steht auf sameqr.com/entwickler.

Häufig gestellte Fragen