Skip to main content
POST
Export analytics

Description

This endpoint allows you to export comprehensive analytics data for one or more QR codes over a specific date range.
The export includes scan details, device and OS data, and geographic insights โ€” formatted for spreadsheet analysis.
You can choose between:
  • .pdf for easy sharing and presentation-ready reports
  • .xls**/ ** .xlsx for advanced Excel-based reportingPurpose

Query Parameters

Request Body

Examples

Export Single QR Code (Excel)

Export Multiple QR Codes (PDF)

Export with Date Range

Export by Tags

Export with Bot Scans Excluded

When exclude_bot_scan=true, Excel exports include an additional Bot Scans sheet summarising total bot hits, unique bots, top bot types, and bot activity per QR code. PDF exports include the same data as a separate section.

Response

Success Response (200 OK)

The response returns a file download with the analytics data in the requested format.

Excel File (.xlsx/.xls)

  • Content-Type: application/vnd.openxmlformats-officedocument.spreadsheetml.sheet (xlsx) or application/vnd.ms-excel (xls)
  • Content: Multi-sheet Excel file with comprehensive analytics data
  • Sheets: Multiple sheets with different analytics views

PDF File (.pdf)

  • Content-Type: application/pdf
  • Content: PDF document containing formatted analytics data
  • Structure: Single file with all analytics data
The export endpoint returns a file download. Make sure your application can handle binary file responses and provide appropriate download functionality to users.
Excel files (.xlsx/.xls) provide the most comprehensive data structure with multiple sheets, while PDF files ideal for sharing, printing, and presenting analytics in a visually formatted report.
Large date ranges or many QR codes may result in large file sizes. Consider breaking down exports into smaller chunks if needed.

Integration Examples

JavaScript - Export Analytics

Python - Export Analytics

PHP - Export Analytics

Notes

  • โœ… Supports bulk analytics export for multiple QR codes at once.
  • โš™๏ธ Recommended file format:
    • .xlsx for visualization/reporting
    • .pdf for presentation, sharing, or archival purposes
  • ๐Ÿ“… Data range can span multiple months, depending on account plan limits.
  • โฑ๏ธ Large exports may take a few seconds to generate โ€” consider background processing for high-volume requests.

Example Use Cases

  • ๐Ÿ“Š Generate weekly or monthly QR scan reports
  • ๐Ÿงพ Export data for BI tools such as Power BI or Tableau
  • ๐Ÿ“ˆ Analyze trends by device, OS, or location in Excel
  • ๐Ÿ” Audit campaign performance across multiple QR codes

Authorizations

Authorization
string
header
required

Send your Management API key as the raw value of the Authorization header โ€” no "Bearer " or "Token " prefix, and no other characters. Example: Authorization: 401f7ac837da42b97f613d789819ff93537bee6a. A header containing more than one space-separated part is rejected outright. Requests also require the request's Host header to be the management API host (e.g. management.scanova.io) โ€” the same key sent to the regular API host will not authenticate.

Query Parameters

from
string<date>
required
to
string<date>
required
file_format
enum<string>
required
Available options:
csv,
xls,
xlsx,
pdf
exclude_bot_scan
boolean
default:false

Body

application/json
q
string[]
required
filter_by
enum<string>
default:qrid
Available options:
qrid,
tags,
id,
folder

Response

Binary file download โ€” application/zip for csv, spreadsheet mimetype for xls/xlsx, application/pdf for pdf.