Pro plan

CSV export

Export readership data and captured leads to spreadsheet format with formula-injection protection.

Download your document's readership data and lead captures as a CSV file for analysis in Excel, Sheets, or other spreadsheet tools. Every CSV export is a Pro feature, and viewer-supplied text in them is escaped so it cannot execute as a spreadsheet formula.

Export readership sessions

The Export CSV button on a document's readership page downloads one row per viewing session, followed by a second section listing the contacts captured by your email-capture gate. The button only appears on Pro; the endpoint also rejects lower tiers with HTTP 403.

The sessions section has eleven columns:

  • reader — The pseudonymous reader label, in the form Reader #<id>. Blank when no reader identity was resolved for the session.
  • email — The email captured for that session, from the email gate, the lead-capture form, or an email invite. Blank otherwise.
  • source — Attribution for how the reader arrived: link, qr, email, or embed. Unrecognised values are recorded as link.
  • device — Device class derived from the user agent: desktop, mobile, tablet, or bot
  • browser — Browser name (e.g., Chrome, Safari)
  • os — Operating system (e.g., iOS, Windows)
  • country — Country resolved by IP geolocation at view time (the address itself is never stored)
  • pages_viewed — Number of pages the viewer read
  • duration_ms — Time spent reading in milliseconds
  • started_at — Session start timestamp (RFC 3339, UTC)
  • ended_at — Session end timestamp (RFC 3339, UTC)

If at least one contact has been captured, a blank row separates the sessions section from the contacts section. The contacts section includes:

  • contact_captured_at — Timestamp when the contact was captured (RFC 3339, UTC)
  • One column per field in your document's current gate form (e.g., name, company, phone)
  • Any additional keys found in stored submissions but no longer in the form — appended alphabetically after the current fields, so contacts captured under an older version of the form keep their values

Export proofing reports

If you enable page marks or annotations for your document, you can also export those reports as CSV. Both features and both reports are Pro.

Each of these reports is one endpoint that returns JSON by default and CSV when called with ?format=csv. The proofing sections of the readership page have their own export buttons, which navigate to that CSV form.

Page marks export contains:

  • viewer — The invitee's email address, or Anonymous reader <key> (a truncated pseudonymous viewer key) for viewers who were not invited
  • page — Page number
  • mark — Verdict (pick, reject, or maybe)
  • updated_at — Timestamp of the mark (RFC 3339, UTC)

Annotations export contains:

  • viewer — Same identity label as the page marks export
  • page — Page number
  • note — Annotation text
  • x, y, w, h — Rectangle coordinates, normalized to the 0–1 range against the page. Blank if the stored rectangle is missing a component.
  • created_at — Annotation timestamp (RFC 3339, UTC)

Formula-injection safety

Viewer-supplied values are escaped so they cannot execute as formulas when the file is opened in a spreadsheet application: if a cell value's first character is =, +, -, or @, it is prefixed with a single quote ('), which makes the spreadsheet treat the whole cell as literal text. Those four characters are the complete set that triggers the prefix.

The escaping is applied to every field a reader can influence: in the readership export, the email, source, device, browser, os, and country columns plus every captured contact value; in the page marks export, the viewer and mark columns; in the annotations export, the viewer and note columns. Server-generated fields — reader labels, page numbers, durations, coordinates, and timestamps — are written unescaped because their values cannot be attacker-controlled.

Programmatic access

If you need to retrieve readership data via code rather than downloading a file, use the events feed API, which lets you fetch view sessions, download records, and captured leads with cursor-based pagination.