Export Reports

SurfacedBy is designed to be the source of truth for your AI visibility data, but it is not the only place that data needs to live. This guide covers how to get data out, whether for a scheduled email to a stakeholder, a BI dashboard, or an ad-hoc analysis.

CSV export from the dashboard

Every data table in the dashboard offers a CSV export: cited pages, Prompts, competitors, and historical scan summaries. The exported file uses UTF-8 encoding and standard comma separation so it opens cleanly in Excel, Google Sheets, and every BI tool.

See CSV export for the column schema of each file.

The Reports surface

The Reports page in the dashboard is where you build, schedule, and share Reports. It has three tabs:

• My reports - the list of Reports you have already built or scheduled. Schedules sit at the top with their cadence and next-send time; manual Reports follow with their generated-at timestamp. The same view includes an Active shares table so you can see and revoke any public share links you have minted.
• Templates - pre-built starting points for the Builder. Pick a template to seed the draft and jump into the Builder.
• Builder - the editor where you choose the sections, cadence, recipients, and timezone for a new Report. Schedules dispatch automatically: Once for a single send, or Weekly, Monthly, and Quarterly for recurring delivery on the day and hour you set. Day-31 schedules in shorter months fire on the last day of the month.

The Reports page is plan-gated; see the Plans page for what is included on each tier.

Available fields

Exports include:

• Scan metadata: scan id, started-at, completed-at, platforms tested.
• Headline metrics: Visibility Score, Brand Coverage, total AI Mentions.
• Per-platform breakdown: AI Mentions for each platform.
• Cited pages: URL, total citations, per-platform citations.
• Prompts: Prompt text, citation status, search volume if known.
• Competitors: competitor domain, Market Position, Share of Voice.

Programmatic access

Reports are retained for audit and can be fetched programmatically at GET /domains/{domain_id}/reports. Subscribe to the report.ready webhook event to get notified the moment a new Report is generated.

Live data via API

For anything more sophisticated than a CSV, use the public API. Every surface in the dashboard is backed by an endpoint, and every historical scan is accessible via the scan_id query parameter on the analytics endpoint. That makes it straightforward to mirror SurfacedBy data into your own warehouse nightly.