A PDF snapshot of your project’s visibility, suitable for sharing with clients. Generated on-demand from the latest usable run.Documentation Index
Fetch the complete documentation index at: https://docs.openlens.com/llms.txt
Use this file to discover all available pages before exploring further.
How to generate
Open a project. Click Download report. OpenLens generates the PDF in the background and returns it asapplication/pdf. The same data the dashboard shows, in a portable format.
The toggle: prompt-wise metrics
When you click Download report, there’s a toggle for prompt-wise metrics. Off by default. On adds an Appendix to the PDF with every prompt in your prompt set grouped by topic, with per-prompt visibility %, average position, citation %, sentiment, and platforms count (X/5 platforms that produced a measurable response). Turn it on when you’re auditing the prompt set with the client, when you want them to see which specific prompts drove a topic-level move, or when you’re doing a quarterly deep review. Leave it off for monthly check-ins. With around 100 prompts and 5 metrics each, the Appendix is most of the PDF.What the report contains
1. Cover page
Title, tracked URL, generated date, platforms covered, prompt set used. Also the exact UTC capture time of the underlying run, so anyone reading later knows the snapshot.2. Executive summary
Four KPI tiles: visibility, share of voice, average position, mentions (count out of total responses). Each tile shows your number plus a comparison line against the top competitor (e.g., “vs Profound: 10.0%”, “#4 of 4 brands”, “vs Profound: #2.5”). Below the tiles, a one-sentence trend callout: “Visibility has decreased by 13% since the previous measurement (1.5% → 1.3%).“3. Platform comparison
Table with one row per active AI platform. Columns: your score, top competitor + their score, gap in points, status chip (Behind, Close, Even, Ahead). Tells the reader which platforms know you and which don’t.4. Competitive landscape
Table of every tracked brand ranked by AI visibility. Columns: rank, brand, visibility, share of voice, average position, sentiment. Your row is highlighted.5. Topic performance
One row per topic. Columns: your score, the top competitor on that topic, their score, status (Gap, Close, etc.). Where the gaps are.6. Citation & source analysis
Total citations across the run, total unique domains, and a category-level breakdown (Third Party / UGC / Competitor with %). Then the top 5 most-cited domains with citation count, category, and which platforms cited them. The dashboard has the full breakdown. In the report we cap it at the top 5 to keep the page readable.7. Brand mentions
Topics where your brand was mentioned, with the source URLs cited alongside those mentions. Each row: topic, mention count, best position, sentiment, platforms. Then an indented list of the specific URLs cited for that topic.8. Engine patterns
One block per AI platform. Each block shows: average citations per response, average brand mentions per response, top sources for that platform, and a one-line summary of source-mix behaviour (e.g., “Heavily favors Third Party sources (91%)”). Reads like a scorecard for how each platform behaves on your topic set.9. AI recommendations
Actionable insights generated per topic. Free-form paragraphs that read like a senior consultant’s take: what’s working, what’s missing, what to do next, with specific platforms, competitor names, and citation sources called out. Where they come from. For each topic, OpenLens assembles a structured snapshot: your visibility and average position, per-platform breakdown vs the best competitor on each platform, every competitor’s scores, the top 5 cited domains for that topic, and the top 5 prompt-attribute sentiment scores. That snapshot goes to Claude Haiku 4.5 with a single instruction: write a 2 to 3 sentence actionable insight naming specific platforms and sources, direct, no hedging. The model returns one paragraph per topic. The same generator backs the/api/insights/topic endpoint. What you see in the report and what you fetch programmatically are the same paragraph.
10. Appendix: prompts by topic (toggle-gated)
Every prompt in your prompt set, grouped by topic. Columns: visibility %, avg position, citation %, sentiment, platforms (X/5). Same metrics as the Prompts tab in the dashboard. This section only appears when the prompt-wise metrics toggle is on.Where the data comes from
Computed from the same data as the dashboard, at the moment of export. The report locks in the snapshot. Re-generating after the next run produces a different report.How to use it
- Leave the toggle off for monthly check-ins. Turn it on when you’re doing a quarterly audit or want clients to see which prompts drove a topic-level move.
- Send the PDF as-is to clients. The cover page has everything they need to know about scope and timing.
- The AI Recommendations section is the part clients actually read first. Make sure the prompts driving them are tight before you ship.
API
GET /api/reports/visibility?projectId=... returns application/pdf. See REST API for the worked example.