---
title: "Get Sitemap Page Metrics"
method: GET
path: "/{brand_id}/sitemap/pages/{page_id}/metrics"
tags: ["sitemap"]
---

# Get Sitemap Page Metrics

`GET /{brand_id}/sitemap/pages/{page_id}/metrics`

Get time-series performance metrics (citations, AI referrals, agent traffic) for a single page.

## Path parameters

- `brand_id` integer, required — The unique identifier for the brand
- `page_id` integer, required — The page identifier

## Query parameters

- `start_date` string, nullable — Start date (YYYY-MM-DD). Defaults to 30 days ago.
- `end_date` string, nullable — End date (YYYY-MM-DD). Defaults to today.

## Response `200`

Successful Response

- SitemapPageMetricsResponse — Time-series metrics for a single page.
  - `granularity` string, required — Time-series granularity: daily or weekly
  - `metrics` UrlMetricsModel, required — Performance metrics for a single URL.
    - `citations` MetricRowModel[], required — Citation counts over time by AI platform
      - `date` string, required — Date in ISO 8601 format (YYYY-MM-DD)
      - `count_by_platform` object, required — Counts keyed by AI platform name (e.g. OpenAI, Perplexity, Gemini)
    - `ai_referrals` MetricRowModel[], required — AI referral counts over time by AI platform
      - `date` string, required — Date in ISO 8601 format (YYYY-MM-DD)
      - `count_by_platform` object, required — Counts keyed by AI platform name (e.g. OpenAI, Perplexity, Gemini)
    - `agent_traffic` MetricRowModel[], required — AI agent traffic counts over time by AI platform
      - `date` string, required — Date in ISO 8601 format (YYYY-MM-DD)
      - `count_by_platform` object, required — Counts keyed by AI platform name (e.g. OpenAI, Perplexity, Gemini)

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/scrunchai/apis/scrunch-data-api.md) · [All operations](https://skmtc.net/scrunchai/apis/scrunch-data-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/scrunchai/scrunch-data-api/revisions/c4fe20c603a3/schema)
