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
}

De GetQR API is in bèta en beschikbaar voor geselecteerde workspaces. Details kunnen nog veranderen vóór de algemene release.

Haal scantotalen en uitsplitsingen op per land, apparaat, browser en meer, voor één QR-code of voor je hele workspace.

Methode	Pad	Beschrijving
`GET`	`/api/v1/qrs/{qrId}/analytics`	Analytics voor een QR-code ophalen
`GET`	`/api/v1/analytics`	Workspace-analytics ophalen

Een kant-en-klaar overzicht per QR-code vind je bij Rapporten.

Wat de cijfers betekenen

Scans. Elke telling staat in het veld clicks. Een scan wordt geteld telkens wanneer iemand de korte link van de QR-code opent.
Unieke scans. Met unique=true wordt elke bezoeker één keer geteld binnen het datumbereik.
Bereik. De cijfers komen van de korte link van de QR-code. Een QR-code zonder korte link heeft geen scans om te tellen.
Geschiedenis. Analytics kun je niet via de API resetten. Als je een QR-code verwijdert, worden de historische scangegevens niet gewist.

Headers

string

vereist

Bearer gevolgd door je API-sleutel. Zie Authenticatie.

Queryparameters

Beide endpoints accepteren deze parameters. Ze zijn allemaal optioneel.

string

standaard:"count"

Dimensie voor de uitsplitsing. count geeft het totaal terug. Alle waarden en de vorm van hun antwoord staan bij Uitsplitsingen.

string

standaard:"30d"

Vooraf ingesteld datumbereik: 24h, 7d, 30d, 90d, 1y, mtd, qtd, ytd of all. Zie Datumbereiken. Wordt genegeerd als je start meestuurt.

string

Begin van een aangepast bereik, ISO 8601, bijvoorbeeld 2026-08-01 of 2026-08-01T00:00:00Z. Gaat voor op interval. Moet vóór end liggen.

string

Einde van een aangepast bereik, ISO 8601. Standaard het einde van vandaag. Wordt gebruikt samen met start of interval=all, en genegeerd bij de andere intervallen.

string

standaard:"UTC"

IANA-tijdzone waarop de timeseries-buckets worden uitgelijnd, bijvoorbeeld America/New_York. Een onbekende tijdzone geeft 422.

boolean

standaard:"false"

true telt unieke scans in plaats van het totale aantal scans.

Je kunt ook dimensiefilters meesturen.

Datumbereiken

`interval`	Beslaat	`timeseries`-buckets
`24h`	De afgelopen 24 uur	Uren
`7d`	De afgelopen 7 dagen, inclusief vandaag	Dagen
`30d`	De afgelopen 30 dagen, inclusief vandaag	Dagen
`90d`	De afgelopen 90 dagen, inclusief vandaag	Dagen
`1y`	De afgelopen 365 dagen, inclusief vandaag	Maanden
`mtd`	Deze maand tot nu toe	Dagen
`qtd`	Dit kwartaal tot nu toe	Dagen
`ytd`	Dit jaar tot nu toe	Dagen, of maanden na 180 dagen
`all`	Sinds je workspace is aangemaakt	Dagen, of maanden na 180 dagen

Stuur voor een aangepast bereik start en eventueel end mee. Bereiken tot 2 dagen gebruiken buckets per uur, bereiken van meer dan 180 dagen buckets per maand, en alles daartussen buckets per dag.

Dimensiefilters

Beperk de resultaten tot scans die aan een filter voldoen. Verschillende filters worden gecombineerd met AND. Accepteert een filter meerdere waarden, scheid ze dan met komma’s: de waarden worden gecombineerd met OR.

Filter	Waarde	Meerdere waarden
`country`	ISO 3166-1 alpha-2-landcode, bijvoorbeeld `US`	Ja
`region`	ISO 3166-2-regiocode, bijvoorbeeld `US-CA`	Ja
`city`	Plaatsnaam, bijvoorbeeld `New York`	Ja
`continent`	`AF`, `AN`, `AS`, `EU`, `NA`, `OC` of `SA`	Ja
`device`	Apparaattype, bijvoorbeeld `Mobile` of `Desktop`	Ja
`browser`	Browsernaam, bijvoorbeeld `Chrome`	Ja
`os`	Besturingssysteem, bijvoorbeeld `iOS` of `Windows`	Ja
`url`	Bestemmings-URL	Ja
`referer`	Verwijzer, bijvoorbeeld `google.com`	Nee
`utm_source`, `utm_medium`, `utm_campaign`, `utm_term`, `utm_content`	UTM-waarde, maximaal 190 tekens	Nee

Een onbekende land- of continentcode geeft 422. Namen van apparaten, browsers en besturingssystemen worden vergeleken met een hoofdletter aan het begin, dus mobile werkt net als Mobile. Bijvoorbeeld scans uit de VS of Canada op mobiele apparaten: ?country=US,CA&device=Mobile.

Uitsplitsingen

count geeft een object terug. Elke andere waarde geeft een array terug, gesorteerd op clicks van hoog naar laag (timeseries is gesorteerd op tijd).

`groupBy`	Elk item bevat
`count`	`clicks` (een object, geen array)
`timeseries`	`start` (begin van de bucket), `clicks`
`continents`	`continent`, `clicks`
`regions`	`region`, `country`, `clicks`
`countries`	`country`, `city` (altijd `*`), `clicks`
`cities`	`city`, `country`, `clicks`
`devices`	`device`, `clicks`
`browsers`	`browser`, `clicks`
`os`	`os`, `clicks`
`triggers`	`trigger` (`qr` of `link`), `clicks`
`referers`	`referer` (`(direct)` als onbekend), `clicks`
`referer_urls`	`refererUrl` (`(direct)` als onbekend), `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`	De UTM-waarde (`utm_source`, `utm_medium`, `utm_campaign`, `utm_term` of `utm_content`), `clicks`

Een onbekende groupBy geeft 422 met de lijst van geldige waarden. Antwoord bij groupBy=count:

{ "clicks": 142 }

Antwoord bij groupBy=countries:

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

Analytics voor een QR-code ophalen

GET /api/v1/qrs/{qrId}/analytics Geeft scanstatistieken voor één QR-code terug, beperkt tot de korte link ervan. Accepteert de queryparameters en dimensiefilters hierboven.

string

vereist

ID van de QR-code. Neem die over uit het antwoord van de lijst of van het aanmaken bij 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
}

Workspace-analytics ophalen

GET /api/v1/analytics Geeft scanstatistieken terug over alle QR-codes in je workspace. Accepteert de queryparameters en dimensiefilters hierboven, plus deze parameters om het bereik te beperken.

string

Beperkt samen met key de resultaten tot de korte link met dit domein, bijvoorbeeld getqr.sh. Het domein moet bij je workspace horen.

string

Slug van de korte link, bijvoorbeeld x7Kd2p1. Gebruik hem samen met domain. Beide staan in het QR-code-object.

string

Door komma’s gescheiden QR-codetypes om mee te nemen: website, pdf, image, video, whatsapp, social, wifi, app, feedback, vcard, sms, payment, location, multilink, email of event. Zie QR-types.

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 }
]

Veelvoorkomende problemen

400 "QR has no associated link."

De QR-code heeft geen korte link, dus er zijn geen scans om te tellen.

404 bij filteren op domain en key

Er bestaat in je workspace geen korte link met dat domein en die slug. Kopieer domain en key uit het QR-code-object.

422 bij groupBy, interval of een filter

De waarde wordt niet ondersteund. Het foutbericht noemt de parameter en somt de geldige waarden op.

De cijfers komen niet overeen met het dashboard

Controleer of je hetzelfde datumbereik en dezelfde tijdzone gebruikt, en of je unieke scans (unique=true) of het totale aantal scans telt.

API

Wat de cijfers betekenen

Headers

Queryparameters

Datumbereiken

Dimensiefilters

Uitsplitsingen

Analytics voor een QR-code ophalen

Workspace-analytics ophalen

Veelvoorkomende problemen

Volgende stappen

Rapporten

QR-codes

Analytics in de app

Rate limits

​Wat de cijfers betekenen

​Headers

​Queryparameters

​Datumbereiken

​Dimensiefilters

​Uitsplitsingen

​Analytics voor een QR-code ophalen

​Workspace-analytics ophalen

​Veelvoorkomende problemen

​Volgende stappen

Rapporten

QR-codes

Analytics in de app

Rate limits

Wat de cijfers betekenen

Headers

Queryparameters

Datumbereiken

Dimensiefilters

Uitsplitsingen

Analytics voor een QR-code ophalen

Workspace-analytics ophalen

Veelvoorkomende problemen

Volgende stappen