Same-QR
InloggenGratis starten
Gratis starten
← Terug naar de blog
AI en automatisering2 min leestijd

QR-code-statistieken via API: scans in je eigen rapporten ophalen

Afbeelding van Unsplash

Wat er wordt geteld

Same-QR telt voor elke dynamische QR-code hoe vaak hij is gescand. Er ontstaat daarbij geen profiel van de scanners. De telling wordt pas veelzeggend door een goede indeling: één QR-code per locatie, reclamemiddel of filiaal. De statistiek van een QR-code bevat het totaal aantal scans, de aanmaakdatum, hoe vaak de bestemming is gewijzigd en of de QR-code inactief is, bijvoorbeeld omdat het account boven de grens van zijn abonnement zit.

Stap 1: leessleutel aanmaken

Voor rapporten heb je nooit schrijfrechten nodig. Maak in het dashboard onder Account, „Toegang voor CLI, scripts en agents”, een sleutel aan met „alleen lezen” en noem hem naar zijn doel, bijvoorbeeld „Maandrapport”. Hij kan cijfers opvragen, maar niets wijzigen of verwijderen. Juist voor taken die zonder toezicht draaien is dat belangrijk.

Stap 2: cijfers ophalen

Via de REST-API levert de lijst van alle QR-codes al het aantal scans per QR-code mee, de statistiek van één enkele QR-code haal je gericht op:

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

Met de opdrachtregel gaat het korter:

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

Stap 3: rapport bouwen

Omdat scanaantallen totalen zijn, bewaar je elke maand een stand en vergelijk je die met de vorige maand. Het verschil is het aantal scans in die maand. Typische rapporten:

  • Maandrapport voor een bureauklant met alle QR-codes van zijn klantproject.
  • Vergelijking van meerdere filialen, als elk filiaal eigen QR-codes en een eigen label heeft.
  • Analyse van een postercampagne per locatie.

Zonder eigen programma kan het ook: een assistent zoals ChatGPT of Claude met Same-QR als connector beantwoordt „Welke vijf QR-codes zijn het vaakst gescand?” direct in het gesprek.

Grenzen van de cijfers

  • Een scan betekent niet dat iemand de pagina heeft gelezen.
  • Weinig scans kan aan de plek liggen, bijvoorbeeld door slecht licht of een te kleine QR-code.
  • Voor gedrag op de website heb je webanalyse nodig. Campagnes met utm-parameters verbinden beide.

Conclusie: waarom Same-QR

Same-QR telt netjes en zuinig met gegevens, en je komt aan de cijfers op de manier die jou uitkomt: in het dashboard, via de API, via de CLI of in gesprek met een assistent. Een leessleutel is genoeg, en de API zit in elk abonnement.

Begin meteen: registreer je gratis op sameqr.com, 20 dynamische QR-codes zijn blijvend gratis. API, CLI en MCP-server zijn er in elk abonnement, de documentatie staat op sameqr.com/entwickler.

Maak gratis dynamische QR-codes
Begin met 20 dynamische QR-codes die voor altijd gratis zijn. Geen abonnement, geen creditcard.
Nu gratis beginnen →

Veelgestelde vragen

Welke gegevens levert de statistiek?

Totaal aantal scans, aanmaakdatum, aantal wijzigingen van de bestemming en of de QR-code inactief is. Persoonsgegevens over scanners verzamelt Same-QR hiervoor niet.

Kan ik scans per maand analyseren?

Ja, door elke maand een stand op te slaan en het verschil te berekenen. Een script met een leessleutel doet dat automatisch.

Heb ik voor rapporten een schrijfsleutel nodig?

Nee. „Alleen lezen” is genoeg en de veiligere keuze.

Nieuwsbrief

Nieuwe artikelen rechtstreeks in je inbox

Tips over dynamische QR-codes, nieuwe functies, geen spam. Altijd opzegbaar.

Door je aan te melden stem je in met het ontvangen van de nieuwsbrief. Je kunt je toestemming op elk moment intrekken via de afmeldlink in elke e-mail.

Verder lezen