Page-view analytics

Retrieve page views and unique visitors for CreatorsJet resources owned by the API subject.

GET /analytics/views returns page views, unique visitors, and a time series for one owned CreatorsJet resource or an aggregate of owned resources. It requires analytics:read.

Page views are not social-platform views

This endpoint measures visits to CreatorsJet pages. It does not return views, reach, impressions, or engagement for Instagram, TikTok, YouTube, or other social content.

Available resources

resource_typeCreator keyAgency keyMeasured page
media_kitYesYesOwned media-kit pages
link_in_bioYesNoThe creator's link-in-bio page
rosterNoYesThe agency's public roster page
deckNoYesAgency-owned pitch-deck pages
campaignYesYesOwned public campaign reports

Query one resource

Supply the resource's opaque ID through resource_id:

curl "https://api.creatorsjet.com/public/v1/analytics/views?resource_type=campaign&resource_id=$CAMPAIGN_ID&timeframe=last7d&timezone=Europe/Paris" \
  --header "Authorization: Bearer $CREATORSJET_API_KEY"

The timezone must be an IANA timezone. It controls calendar boundaries and time-series buckets.

Query an aggregate

Omit resource_id to aggregate every owned resource of that type:

curl "https://api.creatorsjet.com/public/v1/analytics/views?resource_type=media_kit&timeframe=mtd&timezone=UTC" \
  --header "Authorization: Bearer $CREATORSJET_API_KEY"

The response reports whether the request covered one resource or an aggregate:

{
  "data": {
    "resource_type": "campaign",
    "resource_scope": "resource",
    "resource_count": 1,
    "resource_ids": ["66b0f51d46071dc43b2db103"],
    "metric": "page_views",
    "totals": {
      "page_views": 482,
      "unique_visitors": 361
    },
    "timeframe": "last7d",
    "timezone": "Europe/Paris",
    "period": {
      "start": "2026-08-07T00:00:00.000Z",
      "end": "2026-08-14T10:00:00.000Z"
    },
    "granularity": "day",
    "series": []
  },
  "request_id": "50c20a47-bf9a-4dfa-98ae-54fd89a172e1"
}

Supported timeframe values are last24h, today, yesterday, last7d, wtd, mtd, ytd, and all.

Empty and inaccessible resources

An aggregate with no owned resources returns zero totals. A specific resource that is absent or belongs to another subject returns 404 NOT_FOUND.

Do not sum overlapping aggregate and resource responses. Use one aggregation strategy in your application and retain the response timezone with any stored series.

See the analytics endpoint reference for the complete schema.