Estadísticas de códigos QR con la API: llevar los escaneos a tus propios informes

Qué se cuenta

Same-QR cuenta, para cada código QR dinámico, cuántas veces se ha escaneado. No se crea ningún perfil de las personas que escanean. El recuento se vuelve útil con una buena división: un código QR por lugar, soporte publicitario o sucursal. Las estadísticas de un código QR incluyen los escaneos totales, la fecha de creación, cuántas veces se ha cambiado el destino y si el código QR está inactivo, por ejemplo porque la cuenta supera el límite de su tarifa.

Paso 1: crear una clave de lectura

Para los informes nunca necesitas permisos de escritura. Crea en el panel, en Cuenta, “Acceso para CLI, scripts y agentes”, una clave de “solo lectura” y ponle un nombre según su finalidad, por ejemplo “Informe mensual”. Puede consultar cifras, pero no cambiar ni eliminar nada. Esto es especialmente importante en las tareas que se ejecutan sin supervisión.

Paso 2: consultar las cifras

Con la API REST, la lista de todos los códigos QR ya incluye el número de escaneos de cada código QR, y las estadísticas de un código QR concreto las obtienes de forma específica:

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

Con la línea de comandos es más corto:

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

Paso 3: construir el informe

Como las cifras de escaneos son totales acumulados, guardas cada mes un registro y lo comparas con el del mes anterior. La diferencia es el número de escaneos del mes. Informes típicos:

• Informe mensual para un cliente de una agencia con todos los códigos QR de su proyecto.
• Comparación de varias sucursales, cuando cada sucursal tiene sus propios códigos QR y su propia etiqueta.
• Evaluación de una campaña de carteles por ubicaciones.

También se puede sin un programa propio: un asistente como ChatGPT o Claude con Same-QR como conector responde “¿Cuáles son los cinco códigos QR más escaneados?” directamente en la conversación.

Límites de las cifras

• Un escaneo no significa que alguien haya leído la página.
• Pocos escaneos pueden deberse al lugar, por ejemplo a mala iluminación o a un código QR demasiado pequeño.
• Para el comportamiento en el sitio web necesitas la analítica web. Las campañas con parámetros utm unen ambas cosas.

Conclusión: por qué Same-QR

Same-QR cuenta con limpieza y con pocos datos, y llegas a las cifras como te convenga: en el panel, con la API, con la CLI o conversando con un asistente. Basta una clave de lectura, y la API viene incluida en todas las tarifas.

Empieza ya: regístrate gratis en sameqr.com, 20 códigos QR dinámicos son gratuitos para siempre. La API, la CLI y el servidor MCP están disponibles en todas las tarifas, y la documentación está en sameqr.com/entwickler.

Preguntas frecuentes