Retrieve page-view analytics

GET/analytics/views

Returns page views, unique visitors, and a time series for an owned resource. Omit resource_id to aggregate every resource of the selected type visible to the authenticated subject. Creator keys can query media_kit, link_in_bio, and campaign. Agency keys can query media_kit, roster, deck, and campaign. A roster resource means visits to the agency's public roster page; a campaign resource means visits to its public campaign report.

AuthorizationBearer <token>

Public API key from creator or agency settings. The complete secret is shown once.

In: header

Query Parameters

resource_type*string

Value in

  • "media_kit"
  • "link_in_bio"
  • "roster"
  • "deck"
  • "campaign"
resource_id?string

Optional owned resource ID. Omit it for an aggregate across all owned resources of the selected type.

Match^[a-fA-F0-9]{24}$
timeframe?string
Default"all"

Value in

  • "last24h"
  • "today"
  • "yesterday"
  • "last7d"
  • "wtd"
  • "mtd"
  • "ytd"
  • "all"
timezone?string

IANA timezone used to calculate calendar boundaries and time-series buckets.

Lengthlength <= 100
Default"UTC"

Response Body

application/json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

curl -X GET "https://example.com/analytics/views?resource_type=media_kit"
{  "data": {    "resource_type": "media_kit",    "resource_scope": "aggregate",    "resource_count": 1,    "resource_ids": [      "66b0f51d46071dc43b2db103"    ],    "metric": "page_views",    "totals": {      "page_views": 482,      "unique_visitors": 361    },    "timeframe": "all",    "timezone": "UTC",    "period": {      "start": null,      "end": "2026-08-14T10:00:00.000Z"    },    "granularity": "month",    "series": []  },  "request_id": "50c20a47-bf9a-4dfa-98ae-54fd89a172e1"}