---
title: "GET /brands/{brandId}/analytics"
method: GET
path: "/brands/{brandId}/analytics"
---

# GET /brands/{brandId}/analytics

`GET /brands/{brandId}/analytics`

## Request

- Base URL: `https://api.publinio.com/v1`
- URL: `https://api.publinio.com/v1/brands/{brandId}/analytics`
- Auth: HTTP bearer

Read stored content metrics with captured_at timestamps. Missing metrics are unknown, not zero; does not trigger paid refreshes. For saved X and channel reports use get_report_capabilities and get_channel_report; for fresh reports use request_channel_report. Required scope: analytics:read.

## Path parameters

- `brandId` string, required

## Query parameters

- `limit` integer
- `cursor` string

## Response `200`

Result; lists contain data and nextCursor. Posts report their actual status and approval_state.

- object
  - `data` object[], required
  - `nextCursor` string, nullable, required

## Other responses

- `400`: Structured error with error.code, error.message and requestId.
- `401`: Structured error with error.code, error.message and requestId.
- `403`: Structured error with error.code, error.message and requestId.
- `404`: Structured error with error.code, error.message and requestId.
- `409`: Structured error with error.code, error.message and requestId.
- `422`: Structured error with error.code, error.message and requestId.
- `429`: Structured error with error.code, error.message and requestId.
- `500`: Structured error with error.code, error.message and requestId.

---

[API](https://skmtc.dev/publinio/apis/publinio-developer-api.md) · [All operations](https://skmtc.dev/publinio/apis/publinio-developer-api/llms.txt) · [OpenAPI document](https://skmtc.dev/publinio/apis/publinio-developer-api/revisions/2a193fb6939b?raw)