Análise
Cada varredura de um link dinâmico é contada. Planos pagos também obtêm detalhes de geo / dispositivo / hora, lidos por código.
# Análise por link
curl "https://mostlyqr.com/api/v1/links/AZ4K9/analytics?range=30d" \
-H "Authorization: Bearer mtq_live_…"
| Query | Notas |
|---|---|
range |
24h, 7d, 30d, ou all (padrão 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 }]
}
}
# Gratuito vs pago
- Gratuito retorna apenas a contagem de varreduras (limitado na exibição a 1.000+), e o bloco de análise reporta
upgradeRequired: trueem vez das seções de geo/dispositivo — as varreduras nunca são perdidas, apenas não são desagregadas. - Pro / Team / Enterprise retornam o objeto
analyticscompleto acima.
As contagens de varreduras são servidas por contadores baratos; as desagregações consultam uma janela limitada de eventos de varredura, então códigos muito movimentados se agregam em sua fatia mais recente (um sinalizador truncated: true informa quando).
# De onde vêm os dados
O redirecionador registra cada varredura com um geo derivado de IP de baixa precisão (≈ cidade) e um user-agent analisado — nunca localização precisa ou PII. Consulte a nota de privacidade no painel.
# Próximo
- Dynamic links · a referência de API completa.