---
title: "List Cwv Metrics"
method: GET
path: "/sites/{site_id}/cwv"
tags: ["cwv"]
---

# List Cwv Metrics

`GET /sites/{site_id}/cwv`

## Request

- Base URL: `https://api.xeorank.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.xeorank.com/sites/{site_id}/cwv`
- Auth: API key in header `X-Agent-Key`

Return recent CWV metrics for a site.

Optionally filter by page URL and/or device. ``include_diagnostics=false``
drops the Lighthouse blob (screenshot, filmstrip, audits — 600-700 KB per
row): the MCP tools pass it, because technical_health on a 3-row site came
back as 478 KB and the concise shaper had to omit the whole CWV section
(2026-09-26). The dashboard keeps the default.

## Path parameters

- `site_id` string, required

## Query parameters

- `email` string, nullable
- `url` string, nullable
- `device` string, nullable
- `limit` integer
- `include_diagnostics` boolean

## Response `200`

Successful Response

- CwvMetricOut[]
  - `id` string, required
  - `site_id` string, required
  - `url` string, required
  - `source` string, required
  - `device` string, required
  - `lcp_ms` number, nullable
  - `inp_ms` number, nullable
  - `cls` number, nullable
  - `fcp_ms` number, nullable
  - `ttfb_ms` number, nullable
  - `tbt_ms` number, nullable
  - `speed_index` number, nullable
  - `performance_score` number, nullable
  - `dom_size` integer, nullable
  - `dom_depth` integer, nullable
  - `page_load_ms` integer, nullable
  - `diagnostics` union
    - object
    - object[]
  - `measured_at` string, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/xeorank/apis/seo-intelligence-engine.md) · [All operations](https://skmtc.dev/xeorank/apis/seo-intelligence-engine/llms.txt) · [OpenAPI document](https://skmtc.dev/xeorank/apis/seo-intelligence-engine/revisions/449a3fd73454?raw)