---
title: "Get visitor analytics"
method: GET
path: "/v2/teamspaces/{teamspaceId}/sites/{siteId}/analytics/humans"
tags: ["Docs7 Analytics"]
---

# Get visitor analytics

`GET /v2/teamspaces/{teamspaceId}/sites/{siteId}/analytics/humans`

## Request

- Base URL: `https://context7.com/api`
- URL: `https://context7.com/api/v2/teamspaces/{teamspaceId}/sites/{siteId}/analytics/humans`
- Auth: HTTP bearer

Visitors and page views of people (known bots left out): totals, a series per day (per hour for `days=1`), the top 5 pages and referrers and the top 8 countries. Works for GitHub and CLI sites. Any member.

## Path parameters

- `teamspaceId` string, uuid, required
- `siteId` string, uuid, required

## Query parameters

- `days` integer
- `previews` '1'

## Response `200`

The report

- object
  - `data` Docs7HumanAnalytics, required
    - `days` integer, required
    - `hosts` string[], required: Hostnames the site serves now.
    - `hasPreviews` boolean, required: The site has branch previews.
    - `lastReceivedAt` string, date-time, nullable
    - `totals` object, required
      - `visitors` integer
      - `pageViews` integer
    - `dailySeries` object[], required
      - `date` string
      - `visitors` integer
      - `pageViews` integer
    - `topPages` object[], required
      - `path` string
      - `visitors` integer
      - `pageViews` integer
    - `topReferrers` object[], required
      - `referrer` string: `Direct` when there was none.
      - `visitors` integer
    - `topCountries` object[], required
      - `country` string
      - `visitors` integer

## Other responses

- `400`: Invalid teamspace or site id
- `401`: Missing or invalid bearer
- `403`: Not a member, missing role, or an API key of another teamspace
- `404`: No such site in this teamspace
- `500`: Internal error
- `503`: Analytics is not configured

## Changes

- **2026-10-22** `e17589fd8767`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/context7/apis/context7-public-api/changes/v2/teamspaces/:teamspaceId/sites/:siteId/analytics/humans/get.md)

---

[API](https://skmtc.dev/context7/apis/context7-public-api.md) - [All operations](https://skmtc.dev/context7/apis/context7-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/context7/apis/context7-public-api/revisions/945f7834fa8c?raw)