Docs
Analytics

One item's analytics

GET/analytics/content/{type}/{id}Needsanalytics.view

Totals, the previous period and a daily series; tours add a step funnel and checklists per-item completion.

Authorization

secretKey
headerAuthorizationBearer <sk_…>

A secret API key from Settings → API keys. It acts with its creator's role.

Path Parameters

type*string

Content type.

Value in"tour""tooltip""banner""checklist""survey""announcement"
id*integer

The item's id.

Range1 <= value

Query Parameters

days?integer

Time window in days.

Default30
Value in73090

Response Body

OK

application/json
  1. response
content*
totals*
previous*
series*array<>
funnel?array<>

Tours only: views per step.

checklist?

Checklists only.

Shell
curl -X GET 'https://app.cueston.com/api/analytics/content/tour/1'
Example Response
JSON
{
  "content": {
    "type": "tour",
    "id": 42,
    "name": "Onboarding tour"
  },
  "totals": {
    "impressions": 1840,
    "uniqueVisitors": 960,
    "completions": 412,
    "ctaClicks": 133,
    "dismissals": 210,
    "targetMissing": 3
  },
  "previous": {
    "range": {
      "from": "2026-10-26T09:30:00Z",
      "to": "2026-10-26T09:30:00Z"
    },
    "totals": {
      "impressions": 1840,
      "uniqueVisitors": 960,
      "completions": 412,
      "ctaClicks": 133,
      "dismissals": 210,
      "targetMissing": 3
    }
  },
  "series": [
    {
      "day": "2026-10-26",
      "impressions": 1840,
      "completions": 412
    }
  ],
  "funnel": [
    {
      "stepIndex": 1,
      "stepId": 311,
      "title": "Welcome to Acme",
      "views": 0,
      "dropOffRate": 0
    }
  ],
  "checklist": {
    "visitors": 0,
    "completedVisitors": 0,
    "items": [
      {
        "itemId": 0,
        "position": 0,
        "title": "Welcome to Acme",
        "completions": 412,
        "completionRate": 0.42
      }
    ]
  }
}