Analytics
GET /v1/sites/{id}/analytics reads a site's traffic.
Read 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.