Sites

Has anyone opened it? Opens, comments and expiry for one page, for the agent that published it.

Read-only and content-free. Works with the credential the publisher already holds: Authorization: Claim <claim_token> for a page published without an account, or the account's API key or OAuth token. Every plan sees opened, first_opened_at, open comments and the expiry; unique_viewers, last_opened_at and opened_by (named opens) are for plans with view metrics and are null otherwise, with metrics_locked: true. summary is one sentence built only from those fields, safe to say to the owner as it stands. A single early open is often the owner checking their own link. To be called instead of polling, an account can register webhooks (POST /webhooks).

get/sites/{idOrSlug}/activity

Request

  • Base URL: https://api.stacktr.ee
  • URL: https://api.stacktr.ee/sites/{idOrSlug}/activity
  • Auth: one of:
    • HTTP bearer
    • OAuth 2 (authorization code, authorization URL https://api.stacktr.ee/oauth/authorize, token URL https://api.stacktr.ee/oauth/token, scopes: sites:read)
    • API key in header Authorization

Response

OK

idstring
urlstring
state'live' | 'expired' | 'removed' | 'burned' | 'disabled'
openedboolean
first_opened_atstring nullable

ISO 8601.

unique_viewersinteger nullable
last_opened_atstring nullable
expires_atinteger nullable
expires_at_isostring nullable
metrics_lockedboolean
summarystring
keep_urlstring

Claim-token reads only: the link that keeps the page, for the owner alone.

nextstring

Changes

No recorded changes to this operation across all 1 revision of this API.