Documentación de API

Analíticas

API de Análisis

Rastrea y analiza el rendimiento de los códigos QR con datos de escaneo detallados, información geográfica, desgloses por dispositivo y análisis de tendencias.

Tendencias de Escaneo

Rastrea los escaneos a lo largo del tiempo con desgloses diarios, semanales o mensuales

Datos Geográficos

Ve dónde se están escaneando tus códigos QR por país y ciudad

Información del Dispositivo

Entiende los tipos de dispositivos, sistemas operativos y navegadores

Datos de Referencia

Rastrea de dónde provienen los escaneos para la atribución de campañas

Endpoints

Método	Endpoint	Descripción
GET	/organizations/:orgId/qr-codes/analytics	Análisis a nivel organizacional
GET	/organizations/:orgId/qr-codes/:id/analytics	Análisis de un solo código QR
GET	/organizations/:orgId/qr-codes/:id/analytics/export	Exportar análisis como CSV
GET	/organizations/:orgId/qr-codes/:id/scans	Obtener registros de escaneo individuales

Obtener Análisis de Código QR

Recuperar análisis completos para un código QR específico.

GET

/organizations/:orgId/qr-codes/:id/analytics

Parámetros de Consulta

Parámetro	Tipo	Descripción
startDate	string	Fecha de inicio (formato ISO 8601)
endDate	string	Fecha de finalización (formato ISO 8601)
interval	string	Intervalo de agrupamiento: día, semana, mes

Ejemplo de Solicitud

curl -X GET \
  "https://api.iloveqr.com/api/v1/organizations/org_abc123/qr-codes/qr_xyz789/analytics?startDate=2024-01-01&endDate=2024-01-31&interval=day" \
  -H "X-API-Key: YOUR_API_KEY"

Respuesta

{
  "qrCodeId": "qr_xyz789",
  "period": {
    "start": "2024-01-01T00:00:00Z",
    "end": "2024-01-31T23:59:59Z"
  },
  "summary": {
    "totalScans": 1542,
    "uniqueScans": 1203,
    "avgDailyScans": 49.7
  },
  "timeline": [
    { "date": "2024-01-01", "scans": 45, "uniqueScans": 38 },
    { "date": "2024-01-02", "scans": 52, "uniqueScans": 41 },
    ...
  ],
  "geography": {
    "countries": [
      { "country": "US", "scans": 823, "percentage": 53.4 },
      { "country": "GB", "scans": 234, "percentage": 15.2 },
      { "country": "DE", "scans": 156, "percentage": 10.1 }
    ],
    "cities": [
      { "city": "New York", "country": "US", "scans": 234 },
      { "city": "London", "country": "GB", "scans": 189 },
      { "city": "Los Angeles", "country": "US", "scans": 145 }
    ]
  },
  "devices": {
    "types": [
      { "type": "mobile", "scans": 1234, "percentage": 80.0 },
      { "type": "desktop", "scans": 231, "percentage": 15.0 },
      { "type": "tablet", "scans": 77, "percentage": 5.0 }
    ],
    "os": [
      { "os": "iOS", "scans": 687, "percentage": 44.6 },
      { "os": "Android", "scans": 547, "percentage": 35.5 },
      { "os": "Windows", "scans": 189, "percentage": 12.3 }
    ],
    "browsers": [
      { "browser": "Safari", "scans": 654, "percentage": 42.4 },
      { "browser": "Chrome", "scans": 521, "percentage": 33.8 },
      { "browser": "Firefox", "scans": 156, "percentage": 10.1 }
    ]
  }
}

Análisis Geográfico

La respuesta de análisis incluye un desglose geográfico detallado de los escaneos por país y ciudad. Estos datos se derivan de la geolocalización IP de las solicitudes de escaneo.

Datos Geográficos Disponibles

• País: código de país ISO y conteo de escaneos
• Ciudad: nombre de la ciudad con contexto del país
• Porcentaje: distribución relativa de escaneos
• Coordenadas: lat/lng aproximados (cuando estén disponibles)

Nota de Privacidad: No almacenamos ubicaciones exactas de los usuarios. Los datos geográficos se derivan de direcciones IP y proporcionan una precisión aproximada a nivel de ciudad.

Exportar Análisis

Exportar datos de análisis como CSV para un análisis adicional en hojas de cálculo o herramientas de BI.

GET

/organizations/:orgId/qr-codes/:id/analytics/export

Exportar a CSV

curl -X GET \
  "https://api.iloveqr.com/api/v1/organizations/org_abc123/qr-codes/qr_xyz789/analytics/export?startDate=2024-01-01&endDate=2024-01-31" \
  -H "X-API-Key: YOUR_API_KEY" \
  -o analytics.csv

Columnas CSV

Columna	Descripción
timestamp	Marca de tiempo de escaneo (ISO 8601)
country	Código de país
city	Nombre de la ciudad
device_type	móvil, escritorio, tableta
os	Sistema operativo
browser	Nombre del navegador
is_unique	Escaneo de primera vez (verdadero/falso)

Análisis a nivel organizacional

Obtener análisis agregados de todos los códigos QR en tu organización.

GET

/organizations/:orgId/qr-codes/analytics

curl -X GET \
  "https://api.iloveqr.com/api/v1/organizations/org_abc123/qr-codes/analytics?startDate=2024-01-01&endDate=2024-01-31" \
  -H "X-API-Key: YOUR_API_KEY"

Próximos Pasos

Conoce sobre características relacionadas: