Usage
Which agents visit your sites, why they come, and which pages they read.
GET
/usageNeeds usage:read. The figures on the dashboard’s Overview, for one site or all of them.
Without by, the totals: requests, agent requests, the agents behind them, and how sure DNA is of each name. With by, one row per item under data:
by | One row per |
|---|---|
agent | Agent, most requests first; impersonator_requests counts others using its name |
purpose | Purpose, such as search or training |
path | Page, the 100 most requested |
time | Interval: 5 minutes in 1h, an hour in 24h, a day in 7d and 30d; bucket names it |
Authorization
apiKey AuthorizationBearer <token>
An API key (d3_k_…) from the dashboard’s API keys page.
In: header
Query Parameters
window?string
How far back to count, ending now.
Default
"7d"Value in
- "1h"
- "24h"
- "7d"
- "30d"
host?string
One site (example.com also counts www.example.com), or *.example.com for every host under the domain. Omit for every site.
by?string
One breakdown; omit it for the totals.
Default
"summary"Value in
- "summary"
- "agent"
- "purpose"
- "path"
- "time"
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/usage"{ "window": "7d", "host": null, "requests": 0, "agent_requests": 0, "agents": 0, "trust": { "verified": 0, "name_only": 0, "impersonator": 0, "no_name": 0 }, "previous": { "requests": 0, "agent_requests": 0 }}