Analytics & short links

Traffic for every site without a cookie or a consent banner, and branded short links on your workspace’s own subdomain with click counts alongside.

Traffic

A small beacon is injected into every HTML page at publish time. It reports a pageview and nothing else — no cookie, no local storage, no cross-site identifier. Each site’s page shows views, unique visitors, views per day, top pages, referrers and devices over 7, 30 or 90 days.

Uniques are counted with a hash of the visitor’s IP, user agent and the site, salted with a value that changes every day and is never stored. The same person is one visitor within a day and indistinguishable across days; there is nothing to subject- access, because nothing identifies anyone. Known bots are excluded. Events are kept for 90 days.

curl -H "Authorization: Bearer $COLOPHON_TOKEN" \
  "https://api.usercontent.colophon.fyi/api/v1/stats/sites/<site_id>?range=30d"

Short links

A short link is a code on your workspace’s subdomain that redirects to any public URL: https://acme.usercontent.colophon.fyi/l/q3. Create them underLinks or with the CLI:

colophon link https://example.com/report --code q3 --title "Q3 report"

• Codes are 3–32 characters of a-z, 0-9 and -, cannot be all digits, and cannot be a path the platform uses itself. Leave --code off for a random six-character one.
• An optional expiry is a date, in UTC, through the end of that day.
• Targets must resolve to a public address and are checked against Safe Browsing before the link is created. A flagged target still takes the code, so it cannot be re-issued, but the link answers 410.
• Every click reaches the server — redirects are never cached — so disabling a link takes effect on the very next click. Disabling is permanent: the code is never handed out again.