---
title: "Headline analytics summary"
method: GET
path: "/org/analytics/summary"
tags: ["Analytics"]
---

# Headline analytics summary

`GET /org/analytics/summary`

## Request

- Base URL: `https://apiv2.senso.ai/api/v1`
- URL: `https://apiv2.senso.ai/api/v1/org/analytics/summary`
- Auth: API key in header `X-API-Key`

One-call dashboard: every headline metric with the additive counts behind it, the preceding equal-length window, and the window-over-window deltas. Requires the GEO product.

## Query parameters

- `from` string, date
- `to` string, date
- `models` string
- `location` string
- `prompt_type` 'awareness' | 'consideration' | 'evaluation' | 'decision'
- `tag` string

## Response `200`

The summary dashboard for the effective window.

- OrgAnalyticsSummaryResponse: The headline dashboard for one window.
  - `window` AnalyticsWindow, required: The effective window every number in the payload was computed over.
    - `from` string, date, required: First day in the window (inclusive).
    - `to` string, date, required: Last day in the window (inclusive).
    - `days` integer, required: Number of days spanned, inclusive.
    - `latest_data_day` string, date, nullable, required: Most recent day with data for the active model/location filter, or null if none.
  - `totals` AnalyticsTotals, required: The additive count block — every numerator and denominator behind the metrics, summed over the window and filter. All are additive, so they can be recombined across windows; ratios cannot.
    - `run_count` integer, required: Prompt-run answers attempted.
    - `answered_count` integer, required: Non-empty answers — the mention-rate denominator.
    - `mentioned_count` integer, required: Answers naming the org (mention-rate numerator).
    - `mention_total` integer, required: Mention instances for the org (Share of Voice numerator).
    - `tracked_mention_total` integer, required: Mention instances over {org + tracked competitors}. NOT the Share of Voice denominator.
    - `brand_mention_total` integer, required: Mention instances over ALL brands — the Share of Voice denominator.
    - `rank_sum` integer, required: Σ ordinal position over mentioned answers (avg-rank numerator).
    - `sentiment` SentimentCounts, required: The mention-sentiment split. positive + neutral + negative = mentioned_count.
      - `positive` integer, required
      - `neutral` integer, required
      - `negative` integer, required
    - `cited_run_count` integer, required: Answers with ≥1 citation of any tier — this is D, the Citation Rate and Coverage denominator.
    - `primary_cited_run_count` integer, required: Answers citing an owned domain.
    - `tracked_cited_run_count` integer, required: Answers citing a tracked source.
    - `external_cited_run_count` integer, required: Answers citing a third-party domain.
    - `cited_total` integer, required: Total citation instances, all tiers — this is S, the Citation Share denominator.
    - `primary_cited_total` integer, required: Citation instances pointing at an owned domain.
    - `tracked_cited_total` integer, required: Citation instances pointing at a tracked source.
    - `external_cited_total` integer, required: Citation instances pointing at a third-party domain.
    - `prompt_count` integer, required: Distinct prompts contributing to the window.
    - `model_count` integer, required: Distinct models contributing to the window.
    - `location_count` integer, required: Distinct locations contributing to the window.
  - `metrics` AnalyticsMetrics, required: Every ratio derivable from the totals. Each is null when its denominator is zero. Tier RATES divide by D and are independent (can sum past 100%); tier SHARES divide by S and partition (sum to exactly 100%).
    - `mention_rate` MetricValue, nullable, required: A ratio, shipped as an unrounded fraction plus a ready-to-quote string. Use `value` for math and `display` verbatim for anything a human reads — it is why `0.012` never reaches a slide as "0.012%". `value` is a 0–1 fraction for rates and shares, an average position for ranks, and an intensity for frequencies. Wherever a field of this shape is nullable, `null` means the metric's denominator was zero, so the metric was **not measured** in this window; it never means the metric was measured as zero.
      - `value` number, required: The raw number for math — a 0–1 fraction for rates/shares, an average position for ranks, an intensity for frequencies.
      - `display` string, required: The presentation string, safe to quote verbatim (e.g. "2.6%", "#1.4", "4.20 citations per cited answer").
    - `share_of_voice` MetricValue, nullable, required: A ratio, shipped as an unrounded fraction plus a ready-to-quote string. Use `value` for math and `display` verbatim for anything a human reads — it is why `0.012` never reaches a slide as "0.012%". `value` is a 0–1 fraction for rates and shares, an average position for ranks, and an intensity for frequencies. Wherever a field of this shape is nullable, `null` means the metric's denominator was zero, so the metric was **not measured** in this window; it never means the metric was measured as zero.
      - `value` number, required: The raw number for math — a 0–1 fraction for rates/shares, an average position for ranks, an intensity for frequencies.
      - `display` string, required: The presentation string, safe to quote verbatim (e.g. "2.6%", "#1.4", "4.20 citations per cited answer").
    - `avg_rank` MetricValue, nullable, required: A ratio, shipped as an unrounded fraction plus a ready-to-quote string. Use `value` for math and `display` verbatim for anything a human reads — it is why `0.012` never reaches a slide as "0.012%". `value` is a 0–1 fraction for rates and shares, an average position for ranks, and an intensity for frequencies. Wherever a field of this shape is nullable, `null` means the metric's denominator was zero, so the metric was **not measured** in this window; it never means the metric was measured as zero.
      - `value` number, required: The raw number for math — a 0–1 fraction for rates/shares, an average position for ranks, an intensity for frequencies.
      - `display` string, required: The presentation string, safe to quote verbatim (e.g. "2.6%", "#1.4", "4.20 citations per cited answer").
    - `primary_citation_rate` MetricValue, nullable, required: A ratio, shipped as an unrounded fraction plus a ready-to-quote string. Use `value` for math and `display` verbatim for anything a human reads — it is why `0.012` never reaches a slide as "0.012%". `value` is a 0–1 fraction for rates and shares, an average position for ranks, and an intensity for frequencies. Wherever a field of this shape is nullable, `null` means the metric's denominator was zero, so the metric was **not measured** in this window; it never means the metric was measured as zero.
      - `value` number, required: The raw number for math — a 0–1 fraction for rates/shares, an average position for ranks, an intensity for frequencies.
      - `display` string, required: The presentation string, safe to quote verbatim (e.g. "2.6%", "#1.4", "4.20 citations per cited answer").
    - `tracked_citation_rate` MetricValue, nullable, required: A ratio, shipped as an unrounded fraction plus a ready-to-quote string. Use `value` for math and `display` verbatim for anything a human reads — it is why `0.012` never reaches a slide as "0.012%". `value` is a 0–1 fraction for rates and shares, an average position for ranks, and an intensity for frequencies. Wherever a field of this shape is nullable, `null` means the metric's denominator was zero, so the metric was **not measured** in this window; it never means the metric was measured as zero.
      - `value` number, required: The raw number for math — a 0–1 fraction for rates/shares, an average position for ranks, an intensity for frequencies.
      - `display` string, required: The presentation string, safe to quote verbatim (e.g. "2.6%", "#1.4", "4.20 citations per cited answer").
    - `external_citation_rate` MetricValue, nullable, required: A ratio, shipped as an unrounded fraction plus a ready-to-quote string. Use `value` for math and `display` verbatim for anything a human reads — it is why `0.012` never reaches a slide as "0.012%". `value` is a 0–1 fraction for rates and shares, an average position for ranks, and an intensity for frequencies. Wherever a field of this shape is nullable, `null` means the metric's denominator was zero, so the metric was **not measured** in this window; it never means the metric was measured as zero.
      - `value` number, required: The raw number for math — a 0–1 fraction for rates/shares, an average position for ranks, an intensity for frequencies.
      - `display` string, required: The presentation string, safe to quote verbatim (e.g. "2.6%", "#1.4", "4.20 citations per cited answer").
    - `primary_citation_share` MetricValue, nullable, required: A ratio, shipped as an unrounded fraction plus a ready-to-quote string. Use `value` for math and `display` verbatim for anything a human reads — it is why `0.012` never reaches a slide as "0.012%". `value` is a 0–1 fraction for rates and shares, an average position for ranks, and an intensity for frequencies. Wherever a field of this shape is nullable, `null` means the metric's denominator was zero, so the metric was **not measured** in this window; it never means the metric was measured as zero.
      - `value` number, required: The raw number for math — a 0–1 fraction for rates/shares, an average position for ranks, an intensity for frequencies.
      - `display` string, required: The presentation string, safe to quote verbatim (e.g. "2.6%", "#1.4", "4.20 citations per cited answer").
    - `tracked_citation_share` MetricValue, nullable, required: A ratio, shipped as an unrounded fraction plus a ready-to-quote string. Use `value` for math and `display` verbatim for anything a human reads — it is why `0.012` never reaches a slide as "0.012%". `value` is a 0–1 fraction for rates and shares, an average position for ranks, and an intensity for frequencies. Wherever a field of this shape is nullable, `null` means the metric's denominator was zero, so the metric was **not measured** in this window; it never means the metric was measured as zero.
      - `value` number, required: The raw number for math — a 0–1 fraction for rates/shares, an average position for ranks, an intensity for frequencies.
      - `display` string, required: The presentation string, safe to quote verbatim (e.g. "2.6%", "#1.4", "4.20 citations per cited answer").
    - `external_citation_share` MetricValue, nullable, required: A ratio, shipped as an unrounded fraction plus a ready-to-quote string. Use `value` for math and `display` verbatim for anything a human reads — it is why `0.012` never reaches a slide as "0.012%". `value` is a 0–1 fraction for rates and shares, an average position for ranks, and an intensity for frequencies. Wherever a field of this shape is nullable, `null` means the metric's denominator was zero, so the metric was **not measured** in this window; it never means the metric was measured as zero.
      - `value` number, required: The raw number for math — a 0–1 fraction for rates/shares, an average position for ranks, an intensity for frequencies.
      - `display` string, required: The presentation string, safe to quote verbatim (e.g. "2.6%", "#1.4", "4.20 citations per cited answer").
    - `citations_per_answer` MetricValue, nullable, required: A ratio, shipped as an unrounded fraction plus a ready-to-quote string. Use `value` for math and `display` verbatim for anything a human reads — it is why `0.012` never reaches a slide as "0.012%". `value` is a 0–1 fraction for rates and shares, an average position for ranks, and an intensity for frequencies. Wherever a field of this shape is nullable, `null` means the metric's denominator was zero, so the metric was **not measured** in this window; it never means the metric was measured as zero.
      - `value` number, required: The raw number for math — a 0–1 fraction for rates/shares, an average position for ranks, an intensity for frequencies.
      - `display` string, required: The presentation string, safe to quote verbatim (e.g. "2.6%", "#1.4", "4.20 citations per cited answer").
  - `previous_window` OrgAnalyticsPeriod, nullable, required: A window's totals and derived metrics — used for the comparison window.
    - `window` AnalyticsWindow, required: The effective window every number in the payload was computed over.
      - `from` string, date, required: First day in the window (inclusive).
      - `to` string, date, required: Last day in the window (inclusive).
      - `days` integer, required: Number of days spanned, inclusive.
      - `latest_data_day` string, date, nullable, required: Most recent day with data for the active model/location filter, or null if none.
    - `totals` AnalyticsTotals, required: The additive count block — every numerator and denominator behind the metrics, summed over the window and filter. All are additive, so they can be recombined across windows; ratios cannot.
      - `run_count` integer, required: Prompt-run answers attempted.
      - `answered_count` integer, required: Non-empty answers — the mention-rate denominator.
      - `mentioned_count` integer, required: Answers naming the org (mention-rate numerator).
      - `mention_total` integer, required: Mention instances for the org (Share of Voice numerator).
      - `tracked_mention_total` integer, required: Mention instances over {org + tracked competitors}. NOT the Share of Voice denominator.
      - `brand_mention_total` integer, required: Mention instances over ALL brands — the Share of Voice denominator.
      - `rank_sum` integer, required: Σ ordinal position over mentioned answers (avg-rank numerator).
      - `sentiment` SentimentCounts, required: The mention-sentiment split. positive + neutral + negative = mentioned_count.
        - `positive` integer, required
        - `neutral` integer, required
        - `negative` integer, required
      - `cited_run_count` integer, required: Answers with ≥1 citation of any tier — this is D, the Citation Rate and Coverage denominator.
      - `primary_cited_run_count` integer, required: Answers citing an owned domain.
      - `tracked_cited_run_count` integer, required: Answers citing a tracked source.
      - `external_cited_run_count` integer, required: Answers citing a third-party domain.
      - `cited_total` integer, required: Total citation instances, all tiers — this is S, the Citation Share denominator.
      - `primary_cited_total` integer, required: Citation instances pointing at an owned domain.
      - `tracked_cited_total` integer, required: Citation instances pointing at a tracked source.
      - `external_cited_total` integer, required: Citation instances pointing at a third-party domain.
      - `prompt_count` integer, required: Distinct prompts contributing to the window.
      - `model_count` integer, required: Distinct models contributing to the window.
      - `location_count` integer, required: Distinct locations contributing to the window.
    - `metrics` AnalyticsMetrics, required: Every ratio derivable from the totals. Each is null when its denominator is zero. Tier RATES divide by D and are independent (can sum past 100%); tier SHARES divide by S and partition (sum to exactly 100%).
      - `mention_rate` MetricValue, nullable, required: A ratio, shipped as an unrounded fraction plus a ready-to-quote string. Use `value` for math and `display` verbatim for anything a human reads — it is why `0.012` never reaches a slide as "0.012%". `value` is a 0–1 fraction for rates and shares, an average position for ranks, and an intensity for frequencies. Wherever a field of this shape is nullable, `null` means the metric's denominator was zero, so the metric was **not measured** in this window; it never means the metric was measured as zero.
        - `value` number, required: The raw number for math — a 0–1 fraction for rates/shares, an average position for ranks, an intensity for frequencies.
        - `display` string, required: The presentation string, safe to quote verbatim (e.g. "2.6%", "#1.4", "4.20 citations per cited answer").
      - `share_of_voice` MetricValue, nullable, required: A ratio, shipped as an unrounded fraction plus a ready-to-quote string. Use `value` for math and `display` verbatim for anything a human reads — it is why `0.012` never reaches a slide as "0.012%". `value` is a 0–1 fraction for rates and shares, an average position for ranks, and an intensity for frequencies. Wherever a field of this shape is nullable, `null` means the metric's denominator was zero, so the metric was **not measured** in this window; it never means the metric was measured as zero.
        - `value` number, required: The raw number for math — a 0–1 fraction for rates/shares, an average position for ranks, an intensity for frequencies.
        - `display` string, required: The presentation string, safe to quote verbatim (e.g. "2.6%", "#1.4", "4.20 citations per cited answer").
      - `avg_rank` MetricValue, nullable, required: A ratio, shipped as an unrounded fraction plus a ready-to-quote string. Use `value` for math and `display` verbatim for anything a human reads — it is why `0.012` never reaches a slide as "0.012%". `value` is a 0–1 fraction for rates and shares, an average position for ranks, and an intensity for frequencies. Wherever a field of this shape is nullable, `null` means the metric's denominator was zero, so the metric was **not measured** in this window; it never means the metric was measured as zero.
        - `value` number, required: The raw number for math — a 0–1 fraction for rates/shares, an average position for ranks, an intensity for frequencies.
        - `display` string, required: The presentation string, safe to quote verbatim (e.g. "2.6%", "#1.4", "4.20 citations per cited answer").
      - `primary_citation_rate` MetricValue, nullable, required: A ratio, shipped as an unrounded fraction plus a ready-to-quote string. Use `value` for math and `display` verbatim for anything a human reads — it is why `0.012` never reaches a slide as "0.012%". `value` is a 0–1 fraction for rates and shares, an average position for ranks, and an intensity for frequencies. Wherever a field of this shape is nullable, `null` means the metric's denominator was zero, so the metric was **not measured** in this window; it never means the metric was measured as zero.
        - `value` number, required: The raw number for math — a 0–1 fraction for rates/shares, an average position for ranks, an intensity for frequencies.
        - `display` string, required: The presentation string, safe to quote verbatim (e.g. "2.6%", "#1.4", "4.20 citations per cited answer").
      - `tracked_citation_rate` MetricValue, nullable, required: A ratio, shipped as an unrounded fraction plus a ready-to-quote string. Use `value` for math and `display` verbatim for anything a human reads — it is why `0.012` never reaches a slide as "0.012%". `value` is a 0–1 fraction for rates and shares, an average position for ranks, and an intensity for frequencies. Wherever a field of this shape is nullable, `null` means the metric's denominator was zero, so the metric was **not measured** in this window; it never means the metric was measured as zero.
        - `value` number, required: The raw number for math — a 0–1 fraction for rates/shares, an average position for ranks, an intensity for frequencies.
        - `display` string, required: The presentation string, safe to quote verbatim (e.g. "2.6%", "#1.4", "4.20 citations per cited answer").
      - `external_citation_rate` MetricValue, nullable, required: A ratio, shipped as an unrounded fraction plus a ready-to-quote string. Use `value` for math and `display` verbatim for anything a human reads — it is why `0.012` never reaches a slide as "0.012%". `value` is a 0–1 fraction for rates and shares, an average position for ranks, and an intensity for frequencies. Wherever a field of this shape is nullable, `null` means the metric's denominator was zero, so the metric was **not measured** in this window; it never means the metric was measured as zero.
        - `value` number, required: The raw number for math — a 0–1 fraction for rates/shares, an average position for ranks, an intensity for frequencies.
        - `display` string, required: The presentation string, safe to quote verbatim (e.g. "2.6%", "#1.4", "4.20 citations per cited answer").
      - `primary_citation_share` MetricValue, nullable, required: A ratio, shipped as an unrounded fraction plus a ready-to-quote string. Use `value` for math and `display` verbatim for anything a human reads — it is why `0.012` never reaches a slide as "0.012%". `value` is a 0–1 fraction for rates and shares, an average position for ranks, and an intensity for frequencies. Wherever a field of this shape is nullable, `null` means the metric's denominator was zero, so the metric was **not measured** in this window; it never means the metric was measured as zero.
        - `value` number, required: The raw number for math — a 0–1 fraction for rates/shares, an average position for ranks, an intensity for frequencies.
        - `display` string, required: The presentation string, safe to quote verbatim (e.g. "2.6%", "#1.4", "4.20 citations per cited answer").
      - `tracked_citation_share` MetricValue, nullable, required: A ratio, shipped as an unrounded fraction plus a ready-to-quote string. Use `value` for math and `display` verbatim for anything a human reads — it is why `0.012` never reaches a slide as "0.012%". `value` is a 0–1 fraction for rates and shares, an average position for ranks, and an intensity for frequencies. Wherever a field of this shape is nullable, `null` means the metric's denominator was zero, so the metric was **not measured** in this window; it never means the metric was measured as zero.
        - `value` number, required: The raw number for math — a 0–1 fraction for rates/shares, an average position for ranks, an intensity for frequencies.
        - `display` string, required: The presentation string, safe to quote verbatim (e.g. "2.6%", "#1.4", "4.20 citations per cited answer").
      - `external_citation_share` MetricValue, nullable, required: A ratio, shipped as an unrounded fraction plus a ready-to-quote string. Use `value` for math and `display` verbatim for anything a human reads — it is why `0.012` never reaches a slide as "0.012%". `value` is a 0–1 fraction for rates and shares, an average position for ranks, and an intensity for frequencies. Wherever a field of this shape is nullable, `null` means the metric's denominator was zero, so the metric was **not measured** in this window; it never means the metric was measured as zero.
        - `value` number, required: The raw number for math — a 0–1 fraction for rates/shares, an average position for ranks, an intensity for frequencies.
        - `display` string, required: The presentation string, safe to quote verbatim (e.g. "2.6%", "#1.4", "4.20 citations per cited answer").
      - `citations_per_answer` MetricValue, nullable, required: A ratio, shipped as an unrounded fraction plus a ready-to-quote string. Use `value` for math and `display` verbatim for anything a human reads — it is why `0.012` never reaches a slide as "0.012%". `value` is a 0–1 fraction for rates and shares, an average position for ranks, and an intensity for frequencies. Wherever a field of this shape is nullable, `null` means the metric's denominator was zero, so the metric was **not measured** in this window; it never means the metric was measured as zero.
        - `value` number, required: The raw number for math — a 0–1 fraction for rates/shares, an average position for ranks, an intensity for frequencies.
        - `display` string, required: The presentation string, safe to quote verbatim (e.g. "2.6%", "#1.4", "4.20 citations per cited answer").
  - `deltas` OrgAnalyticsDeltas, nullable, required: Window-over-window movement of the headline metrics.
    - `mention_rate` RateTrend, nullable, required: A rate metric's movement versus the prior window. Null when either window lacked the denominator.
      - `prev` number, required: The prior window's value (a 0–1 fraction).
      - `delta` number, required: Change in absolute points (0.005 = +0.5 pts).
      - `direction` 'improved' | 'declined' | 'flat', required: Semantic movement — higher is better for every trended metric.
      - `display` string, required: Presentation string in points (e.g. "+0.5 pts").
    - `share_of_voice` RateTrend, nullable, required: A rate metric's movement versus the prior window. Null when either window lacked the denominator.
      - `prev` number, required: The prior window's value (a 0–1 fraction).
      - `delta` number, required: Change in absolute points (0.005 = +0.5 pts).
      - `direction` 'improved' | 'declined' | 'flat', required: Semantic movement — higher is better for every trended metric.
      - `display` string, required: Presentation string in points (e.g. "+0.5 pts").
    - `primary_citation_rate` RateTrend, nullable, required: A rate metric's movement versus the prior window. Null when either window lacked the denominator.
      - `prev` number, required: The prior window's value (a 0–1 fraction).
      - `delta` number, required: Change in absolute points (0.005 = +0.5 pts).
      - `direction` 'improved' | 'declined' | 'flat', required: Semantic movement — higher is better for every trended metric.
      - `display` string, required: Presentation string in points (e.g. "+0.5 pts").
  - `data_quality` DataQuality, required: Deterministic sample-quality flag driven by the answered-run count.
    - `level` 'high' | 'medium' | 'low', required: low (<100 answered runs), medium (<400), high otherwise.
    - `answered_count` integer, required: The answered-run count the flag was derived from.
    - `reasons` string[], required: Human-readable caveats when confidence is below high; empty otherwise.
  - `notes` string[], required: Prose caveats generated for this specific response.
  - `definitions` object, required: One-line definition of each metric in the payload, keyed by metric name.

## Other responses

- `400`: The request was malformed — a bad path/query parameter or an invalid value.
- `401`: Missing or invalid credentials — supply a valid org API key in the `X-API-Key` header.
- `403`: The API key is authenticated but not permitted to access this resource.

---

[API](https://skmtc.dev/senso/apis/senso-org-api.md) - [All operations](https://skmtc.dev/senso/apis/senso-org-api/llms.txt) - [OpenAPI document](https://skmtc.dev/senso/apis/senso-org-api/revisions/d789b4fcbe84?raw)