Scans Timeline
QR Code Analytics
Scans Timeline
Get time-series scan data for your QR codes
GET
Scans Timeline
Get scan data over time with configurable granularity. This endpoint returns time-series data showing scan counts, unique scanners, and unique scans for each time period.
This endpoint returns user-level aggregated timeline data across all your QR codes. For timeline data on a specific QR code, use the Complete Analytics endpoint.
Query Parameters
Number of days to include in the timeline (1-365).
Time interval granularity for grouping data:
hour, day, week.hour- Best for short timeframes (1-7 days)day- Best for medium timeframes (7-90 days)week- Best for long timeframes (30-365 days)
Response
Array of timeline data points.
Request Examples
- cURL
- Node.js
- TypeScript
- Python
- PHP
- Go
- Java
Response Examples
- 200 OK
Use Cases
Build a scan trends chart
Build a scan trends chart
Prepare timeline data for visualization in a chart library like Chart.js or Recharts.
Detect scan patterns
Detect scan patterns
Analyze scan patterns to identify peak usage times.
Calculate week-over-week growth
Calculate week-over-week growth
Compare current week performance to the previous week.
Related Endpoints
Analytics Overview
Get aggregated summary statistics
Top Performing QR Codes
See which QR codes drive the most scans
Recent Activity
View the latest scan events
Complete Analytics
Get all analytics for a specific QR code