Analytics

August 25, 2026·2 min read

Analytics

Page views, referrers, search queries, and feedback stats for an app namespace. This API is read-only — event ingestion happens client-side through the tracking SDK, not through this API, so there is no endpoint here for writing events.

Concept

Term	Meaning
Overview	A single-call summary of visits, unique visitors, and top-level trends
Timeseries	Daily (or otherwise bucketed) counts over a window, for charting
`days=N`	Trailing N days from now
`since` / `until`	An explicit window, ms epoch or ISO 8601

Get an overview

curl -sf "https://api.falcata.io/api/v1/analytics/marozzo/overview?days=7" \
  -H "Authorization: Bearer $FURNACE_TOKEN" | jq '.data'

Chart a timeseries

curl -sf "https://api.falcata.io/api/v1/analytics/marozzo/timeseries?days=30" \
  -H "Authorization: Bearer $FURNACE_TOKEN" | jq '.data.points'

Tip

Use an explicit range instead of days when you need a fixed reporting period, such as a billing month:

curl -sf "https://api.falcata.io/api/v1/analytics/marozzo/overview?since=2026-05-01&until=2026-05-26" \
  -H "Authorization: Bearer $FURNACE_TOKEN" | jq '.data'

Find top paths and referrers

curl -sf "https://api.falcata.io/api/v1/analytics/marozzo/top-paths?days=14&limit=10" \
  -H "Authorization: Bearer $FURNACE_TOKEN" | jq '.data[] | {path, views}'

curl -sf "https://api.falcata.io/api/v1/analytics/marozzo/top-referrers?days=30" \
  -H "Authorization: Bearer $FURNACE_TOKEN" | jq '.data'

Inspect on-site search and feedback

# What people searched for
curl -sf "https://api.falcata.io/api/v1/analytics/marozzo/top-searches?days=30" \
  -H "Authorization: Bearer $FURNACE_TOKEN" | jq '.data'

# Thumbs-up / thumbs-down on content pages
curl -sf "https://api.falcata.io/api/v1/analytics/marozzo/feedback-stats?days=30" \
  -H "Authorization: Bearer $FURNACE_TOKEN" | jq '.data'

Feedback stats return zeros for a namespace that has no feedback widget on its pages — that's an expected empty state, not an error.

List raw events

curl -sf "https://api.falcata.io/api/v1/analytics/marozzo/list-events?days=1&limit=50" \
  -H "Authorization: Bearer $FURNACE_TOKEN" | jq '.data[] | {type, path, ts}'

Check a single user's activity

user-activity needs analytics:read permission and a specific userId — it doesn't do bulk exports.

curl -sf "https://api.falcata.io/api/v1/analytics/marozzo/user-activity?userId=$USER_ID&days=30" \
  -H "Authorization: Bearer $FURNACE_TOKEN" | jq '.data'

Everything else — event name catalogues and namespace discovery — in the full reference.