Lexicon Garden

space.highport.admin.listTopSites

Domains ranked by successful, non-crawler request count over a trailing window. A popularity signal and nothing more, but one that is safe to publish: a domain that is not serving, that is denylisted directly or by pattern or through its identity, its space, its record or its serving CID, or that carries any malware finding, never appears. Answered from an hourly rollup that trails real time by up to ten minutes, which is invisible at this window's scale.

Repository @lexicons.highport.space did:plc:ciygg5hma4q7ah2kxaszkyob namespace authority
Details · query
Kindquery
Authorityadmin.highport.space
Indexed

Showing version bafyreia262wqkd4qmdyykcemm6vjlaewnpkm273snkc5mjhm77iorkekbu. Show the latest

Compare Edit in builder → Fork →

Query

query · GET

Parameters

query string

days

integer

Length of the trailing window, in days, ending now.

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

limit

integer

Maximum sites to return. Fewer come back when the window holds fewer ranked domains that are safe to show.

  • minimum: 1
  • maximum: 100
  • default: 20

minRequests

integer

Floor under the ranked figure, so a near-dead domain cannot rank on a quiet window.

  • minimum: 0
  • default: 0

Output

application/json

sites

requiredarray
itemsref
Reference

Errors

AnalyticsDisabled

This deployment has no analytics store configured, so no traffic was ever recorded. Distinct from an empty list, which means the window held no traffic worth ranking.

#topSite

object

One domain's standing in the window, and the identity of what is published there.

Properties

botRequests

requiredinteger

Crawler responses in the window, at every status, reported beside the ranked figure rather than folded into it — the same split getSiteTraffic's status mix reports, so a caller can see what was excluded.

domain

requiredstring

The hostname.

recordCid

string · cid

The record version the serving snapshot was built from, which is how a later run tells a republished site from unchanged bytes. Absent when the domain is serving without an active snapshot.

requests

requiredinteger

Responses in the window that were 2xx and not classified as a crawler. This is the figure the ranking is on: a showcase ranks what people read, so bytes do not decide it, an error loop cannot win it, and a scraper cannot either.

siteDid

requiredstring · did

The registration's owner.

Similar lexicons

semantic match

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

  • space.highport.manage.getSiteTraffic

    query

    Traffic to one of the caller's domains over a time range: hourly requests and bytes, the busiest paths, and status codes. Byte figures include a fixed per-response header estimate, since the edge logs only response bodies.

  • space.highport.manage.listSiteVisitors

    query

    Identities that signed in to one of the caller's domains, and what each spent there. Anonymous traffic is not listed, and no query links a visitor across domains.

  • space.highport.admin.listUserAgents

    query

    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).