Lexicon Garden

space.highport.admin.listTopSites

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.

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

Showing version bafyreiaezx2yog6hol4mwhbmhiz7p6fpkgd6mlxldkkhri3u4p2wg76ucu. Show the latest

Compare Edit in builder → Fork →

Query

query · GET

Parameters

query string

days

integer

How many days back the window reaches from now.

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

limit

integer

Maximum sites to return. Fewer come back if not enough domains qualify.

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

minRequests

integer

Minimum requests a domain needs to be ranked, so near-dead domains do not rank in a quiet window.

  • minimum: 0
  • default: 0

Output

application/json

sites

requiredarray
itemsref
Reference

Errors

AnalyticsDisabled

No analytics store is configured, so no traffic was recorded. An empty list means something else: the window had no traffic worth ranking.

#topSite

object

One domain's rank in the window, and what it publishes.

Properties

botRequests

requiredinteger

Crawler responses at any status, reported separately from requests so callers can see what was excluded.

domain

requiredstring

The hostname.

recordCid

string · cid

The record version behind the serving snapshot, which lets a later run tell a republished site from an unchanged one. Absent when the domain serves without an active snapshot.

requests

requiredinteger

Non-crawler 2xx responses in the window. The ranking uses this figure, so bytes, error loops and scrapers cannot move it.

siteDid

requiredstring · did

The domain's registered 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).