Skip to main content
POST
/
analytics
/
qr
/
raw
curl --request POST \
  --url https://management.scanova.io/analytics/qr/raw/ \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: multipart/form-data' \
  --form filter_by=qrid \
  --form 'q[0]=Qf94b25d768294148' \
  --form 'q[1]=Qf94b25d768294149'
"<string>"

​
Description

The Export Raw Scan Data endpoint returns a flat dataset where each row equals one scan event. Use it when you need to rebuild your own pivot tables, send the data to a warehouse, or debug anomalies at the event level. The query parameters mirror those in the analytics export endpoint so you can reuse the same request builder.

​
Query Parameters

ParameterTypeRequiredDescription
typestring✅ YesExport mode. Use raw for all scan events (humans + bots), or raw_bot to export only bot scan events.
fromstring (YYYY-MM-DD)✅ YesInclusive start date for the export window.
tostring (YYYY-MM-DD)✅ YesInclusive end date. Defaults to the current date when omitted.
file_formatstring✅ YesOutput format. Accepted values: csv, xls, xlsx. CSV is recommended for large pulls.
exclude_bot_scanbooleanNoWhen true, bot scan rows are excluded from the raw export. Use alongside type=raw to get a clean human-only dataset. Defaults to false.

​
Supported type Values

ValueDescription
rawExport all individual scan events (human and bot traffic combined).
raw_botExport only bot scan events. Useful for auditing or removing bot traffic separately.

​
Request Body

FieldTypeRequiredDescription
filter_bystring✅ YesFilter type — either qrid (QR code IDs), tags (tag names) and folder id.
qarray✅ YesList of QR IDs (if filter_by=qrid) or tags (if filter_by=tags) or folder id (if filter_by=folder) to include in the raw export.
When using form-data, pass one q field per ID or tag (for example: q=Qf94..., q=Qf95...).

​
Example Request

​
Export Raw Scan Data by QR IDs

curl -X POST "https://management.scanova.io/analytics/qr/raw/?type=raw&from=2025-10-28&to=2025-11-26&file_format=csv" \
  -H "Authorization: YOUR_API_KEY" \
  -F "filter_by=qrid" \
  -F "q=Qf94b25d768294148" \
  -F "q=Qf94b25d768294149"

​
Export Raw Scan Data by Tags

curl -X POST "https://management.scanova.io/analytics/qr/raw/?type=raw&from=2025-10-28&to=2025-11-26&file_format=csv" \
  -H "Authorization: YOUR_API_KEY" \
  -F "filter_by=tags" \
  -F "q=marketing" \
  -F "q=campaign"

​
Export Bot-Only Scan Data

curl -X POST "https://management.scanova.io/analytics/qr/raw/?type=raw_bot&from=2025-10-28&to=2025-11-26&file_format=csv" \
  -H "Authorization: YOUR_API_KEY" \
  -F "filter_by=qrid" \
  -F "q=Qf94b25d768294148"

​
Response

  • Status: 200 OK on success.
  • Content-Type: Matches the requested format (text/csv, application/vnd.ms-excel, or application/vnd.openxmlformats-officedocument.spreadsheetml.sheet).
  • Body: Each row represents a scan with timestamp, device, OS, browser, geo metadata, campaign references, and any other available scan attributes.
Raw files can grow quickly when exporting long date ranges or busy campaigns. For >50k scans, schedule the job during off-hours or break the date range into weekly slices.

​
Tips

  • Pair this export with the aggregate /analytics/qr/export/ report to validate funnel metrics.
  • CSV output is best suited for ETL/ELT jobs and scripting workflows.
  • XLS/XLSX provide richer formatting if you need to hand the dataset to stakeholders without additional tooling.

Authorizations

​
Authorization
string
header
required

API key authentication. Enter your API key directly in the Authorization header.

Query Parameters

​
type
enum<string>
required

Must be set to raw to retrieve raw scan data.

Available options:
raw
​
from
string<date>
required

Start date for scan data (inclusive). Format: YYYY-MM-DD

​
to
string<date>
required

End date for scan data (inclusive). Format: YYYY-MM-DD. Defaults to current date.

​
file_format
enum<string>
required

Export file format for the raw data. CSV is ideal for lightweight processing.

Available options:
csv,
xls,
xlsx

Body

multipart/form-data
​
filter_by
enum<string>
required

Filter by QR code ID or tags

Available options:
qrid,
tags
Example:

"qrid"

​
q
string[]
required

Array of QR code IDs (if filter_by is 'qrid') or tags (if filter_by is 'tags') to include in the raw export

Example:
["Qf94b25d768294148", "Qf94b25d768294149"]

Response

Raw scan data exported successfully

The response is of type file.