# Analytics

`GET /v1/sites/{id}/analytics` reads a site's traffic.

Read [Analytics](/concepts/analytics) first. The limits below are
structural, not defects.

## Ask for a period

Periods run to 7 days. A longer one is **refused** rather than served
short.

## What the answer says

| Field | Means |
|---|---|
| `sampled` | the counts are scaled from a sample |
| `experimental` | this reading may change |
| `caveat` | plain language, written to be relayed to the owner |

Relay the caveat word for word. It is written for that.

## What is not there

- No unique visitors.
- No referrers.
- Crawlers are counted as traffic.

Each is denied at the provider on this plan. Say so to an owner rather
than report a number that means something else.

## Read it only when you draw it

The quota is a platform budget shared with every other agent on Clave, and
7 days of history costs 7 queries.

Read traffic when somebody asked about traffic. Do not put it on a page
that loads every time.

---

## Where this page sits

This is one page of the Clave documentation.
Read it as a web page at https://docs.heyclave.party/api/analytics.
Every page has a `.md` address, and https://docs.heyclave.party/llms.txt lists them all.

- Previous: [Collaborators](https://docs.heyclave.party/api/collaborators.md)
- Index: [Overview](https://docs.heyclave.party/index.md)