Lexicon Garden

space.highport.admin.listUserAgents

User agents that reached the network over a trailing window, with request counts and how each was classified, for reviewing crawlers, bots and automation. Operator only. Names no visitor: agents are grouped across all traffic, and the domain count is a number, never a list. Read from raw request events, so the window cannot reach past raw retention (30 days by default).

Repository @lexicons.highport.space did:plc:ciygg5hma4q7ah2kxaszkyob namespace authority
Details · query
Kindquery
Authorityadmin.highport.space
Indexed
Compare Edit in builder → Fork →

Query

query · GET

Parameters

query string

clientClass

string

Only return agents the classifier put in this class.

  • knownValues: bot | browser | unknown

days

integer

How many days back the window reaches from now.

  • minimum: 1
  • maximum: 30
  • default: 7

domain

string

Only count requests to this hostname.

limit

integer

Maximum agents to return, busiest first.

  • minimum: 1
  • maximum: 200
  • default: 50

Output

application/json

agents

requiredarray
itemsref
Reference

Errors

AnalyticsDisabled

No analytics store is configured, so no traffic was recorded.

#agent

object

One user agent's share of the window.

Properties

clientClass

requiredstring

What the classifier made of this agent.

  • knownValues: bot | browser | unknown

domains

requiredinteger

How many distinct domains it reached.

lastSeen

requiredstring · datetime

The most recent response to this agent.

requests

requiredinteger

Responses to this agent in the window, at any status.

userAgent

string

The User-Agent as sent, cut to 512 bytes. Absent for requests that sent none, and for requests logged before the edge recorded agents.

  • maxLength: 512

Similar lexicons

semantic match

Lexicons whose schemas describe something close to this one. Check them before publishing a new one that overlaps.

  • space.highport.admin.listTopSites

    query

    Domains ranked by successful, non-crawler requests over a trailing window. Safe to publish: a domain is left out if it is not serving, has a malware finding, or is denylisted in any way (directly, by pattern, or through its identity, space, record or serving CID). Counts can lag by up to ten minutes.