---
title: "Traffic overview from RankControl's own page analytics: total page views, unique visitors, sessions, bounce rate, and average time on page. With scope \"site\" and Google Analytics connected, the whole site from Google Analytics instead: visits with the same days before, visits from search and from AI by engine, a visits trend, and top pages."
method: GET
path: "/api/v1/analytics/traffic"
---

# Traffic overview from RankControl's own page analytics: total page views, unique visitors, sessions, bounce rate, and average time on page. With scope "site" and Google Analytics connected, the whole site from Google Analytics instead: visits with the same days before, visits from search and from AI by engine, a visits trend, and top pages.

`GET /api/v1/analytics/traffic`

## Request

- Base URL: `https://api.rctrl.com`
- URL: `https://api.rctrl.com/api/v1/analytics/traffic`
- Auth: HTTP bearer

Requires the `read:analytics` scope.

## Query parameters

- `days` '7' | '30' | '90': Window in days, default 30
- `scope` 'ours' | 'site': "ours" (default): visits to your RankControl articles, from RankControl's own counter. "site": the whole site from Google Analytics, when it is connected.

## Response `200`

Success; the payload is wrapped in a data envelope

- object
  - `data` unknown

## Other responses

- `400`: Bad input
- `401`: Missing or invalid API key
- `403`: API key lacks the required scope
- `404`: Not found in this workspace
- `429`: Rate limited; the body includes a retryAfterMs hint

---

[API](https://skmtc.dev/rctrl/apis/rankcontrol-api.md) · [All operations](https://skmtc.dev/rctrl/apis/rankcontrol-api/llms.txt) · [OpenAPI document](https://skmtc.dev/rctrl/apis/rankcontrol-api/revisions/98ecd236394a?raw)