---
title: "Aggregated metrics summary"
method: GET
path: "/metrics/summary"
tags: ["Metrics"]
---

# Aggregated metrics summary

`GET /metrics/summary`

Same as /metrics/timeseries with an extra summary + position_distribution block. Citations and citation rate include visible citations and background source references; background references use position 0 and are excluded from avg_position and position distributions. total is a SUM for count metrics and an AVERAGE across periods for rate/percentage metrics (never summed); each summary row carries an aggregation field (sum or average).

## Query parameters

- `project_id` integer, required
- `metrics` string
- `granularity` 'day' | 'week' | 'month'
- `range` integer
- `from` string, date-time
- `to` string, date-time
- `competitors` string
- `model` 'chatgpt' | 'perplexity' | 'gemini' | 'ai_overview' | 'ai_mode' | 'copilot' | 'claude' | 'grok' | 'deepseek' | 'meta_ai' | 'amazon_rufus'
- `collection_id` integer
- `prompt` integer
- `prompt_type` 'informational' | 'navigational' | 'commercial' | 'transactional'
- `brand_kind` 'brand' | 'brand_other' | 'non_brand'
- `output` 'flat' | 'csv'

## Response `200`

Summary metrics

## Changes

> 11 revisions in range; 6 could not be searched.

- **2026-07-27** `c01e99c81c66` — 1 info
  - added the new optional `query` request parameter `output`

[Change history](https://skmtc.dev/llmpulse/apis/llm-pulse-api/changes/metrics/summary/get.md)

---

[API](https://skmtc.dev/llmpulse/apis/llm-pulse-api.md) · [All operations](https://skmtc.dev/llmpulse/apis/llm-pulse-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/llmpulse/llm-pulse-api/revisions/b1f6040a24b9/schema)