Analytics
Ogni scansione di un link dinamico viene conteggiata. I piani a pagamento ottengono anche breakdowns geo / device / time, letti per codice.
# Per-link analytics
curl "https://mostlyqr.com/api/v1/links/AZ4K9/analytics?range=30d" \
-H "Authorization: Bearer mtq_live_…"
| Query | Note |
|---|---|
range |
24h, 7d, 30d, o all (default all). |
{
"code": "AZ4K9",
"scan_count": 4218,
"range": "30d",
"analytics": {
"total": 4218,
"byDay": [{ "day": "2026-06-01", "count": 121 }],
"byCountry": [{ "key": "GB", "count": 2600 }],
"byDevice": [{ "key": "mobile", "count": 3900 }],
"byOS": [{ "key": "iOS", "count": 2360 }],
"byReferrer": [{ "key": "instagram.com", "count": 410 }]
}
}
# Free vs paid
- Free restituisce solo il conteggio delle scansioni (plafondato nel display a 1,000+), e il blocco analytics riporta
upgradeRequired: trueinvece delle sezioni geo/device — le scansioni non vengono mai perse, solo non suddivise. - Pro / Team / Enterprise restituiscono l’oggetto
analyticscompleto qui sopra.
I conteggi delle scansioni sono serviti da contatori economici; i breakdowns interrogano una finestra limitata di eventi di scansione, quindi i codici molto occupati si aggregano sulla loro fetta più recente (un flag truncated: true ti avvisa quando accade).
# Da dove provengono i dati
Il redirect registra ogni scansione con una geo derivata da IP approssimativa (≈ città) e uno user-agent analizzato — mai una posizione precisa o PII. Vedi la nota sulla privacy nel dashboard.
# Successivo
- Dynamic links · il riferimento API completo.