@graph8/sdk 0.251.0 → 0.260.0

package/docs/api/webAnalytics.md

@@ -0,0 +1,1452 @@
+<!-- Generated by sdk/js/scripts/generate-agent-docs.ts from developer-contract/openapi.json. Regenerated on every build. -->
+
+# `g8.api.webAnalytics`: Web Analytics
+
+38 operations (38 read).
+
+No hand-written client covers this area. Call it through `g8.api.webAnalytics.*` as shown below, or by operationId with `g8.api.call(operationId, input)`.
+
+Every example below assumes this setup (server-side, API key):
+
+```ts
+import { g8 } from "@graph8/sdk";
+
+g8.init({ apiKey: process.env.G8_API_KEY! });
+```
+
+Example values are placeholders that match each field's type. Only required fields are shown. Every example is type-checked against the SDK in CI.
+
+Exact TypeScript types for every operation on this page, and every schema they use: [webAnalytics.d.ts](webAnalytics.d.ts).
+
+## Operations
+
+| Call | HTTP | Tier | Scope | Summary |
+|---|---|---|---|---|
+| [`getAcquisitionCampaigns`](#op-getacquisitioncampaigns) | `GET /api/v1/analytics/acquisition/campaigns` | read | `analytics:read` | Get Acquisition Campaigns |
+| [`getAcquisitionChannels`](#op-getacquisitionchannels) | `GET /api/v1/analytics/acquisition/channels` | read | `analytics:read` | Get Acquisition Channels |
+| [`getAcquisitionChannelsTrend`](#op-getacquisitionchannelstrend) | `GET /api/v1/analytics/acquisition/channels/trend` | read | `analytics:read` | Get Acquisition Channels Trend |
+| [`getAcquisitionReferrals`](#op-getacquisitionreferrals) | `GET /api/v1/analytics/acquisition/referrals` | read | `analytics:read` | Get Acquisition Referrals |
+| [`getAcquisitionSearch`](#op-getacquisitionsearch) | `GET /api/v1/analytics/acquisition/search` | read | `analytics:read` | Get Acquisition Search |
+| [`getAcquisitionSocial`](#op-getacquisitionsocial) | `GET /api/v1/analytics/acquisition/social` | read | `analytics:read` | Get Acquisition Social |
+| [`getAcquisitionSources`](#op-getacquisitionsources) | `GET /api/v1/analytics/acquisition/sources` | read | `analytics:read` | Get Acquisition Sources |
+| [`getAudienceBehavior`](#op-getaudiencebehavior) | `GET /api/v1/analytics/audience/behavior` | read | `analytics:read` | Get Audience Behavior |
+| [`getAudienceDemographics`](#op-getaudiencedemographics) | `GET /api/v1/analytics/audience/demographics` | read | `analytics:read` | Get Audience Demographics |
+| [`getAudienceLanguages`](#op-getaudiencelanguages) | `GET /api/v1/analytics/audience/languages` | read | `analytics:read` | Get Audience Languages |
+| [`getAudienceOverview`](#op-getaudienceoverview) | `GET /api/v1/analytics/audience/overview` | read | `analytics:read` | Get Audience Overview |
+| [`getAudienceTrend`](#op-getaudiencetrend) | `GET /api/v1/analytics/audience/trend` | read | `analytics:read` | Get Audience Trend |
+| [`getConversionRate`](#op-getconversionrate) | `GET /api/v1/analytics/conversions/rate` | read | `analytics:read` | Get Conversion Rate |
+| [`getEngagementByCampaign`](#op-getengagementbycampaign) | `GET /api/v1/analytics/engagement/by-campaign` | read | `analytics:read` | Get Engagement By Campaign |
+| [`getEngagementByChannel`](#op-getengagementbychannel) | `GET /api/v1/analytics/engagement/by-channel` | read | `analytics:read` | Get Engagement By Channel |
+| [`getEngagementByLandingPage`](#op-getengagementbylandingpage) | `GET /api/v1/analytics/engagement/by-landing-page` | read | `analytics:read` | Get Engagement By Landing Page |
+| [`getEngagementOverview`](#op-getengagementoverview) | `GET /api/v1/analytics/engagement/overview` | read | `analytics:read` | Get Engagement Overview |
+| [`getEngagementTrend`](#op-getengagementtrend) | `GET /api/v1/analytics/engagement/trend` | read | `analytics:read` | Get Engagement Trend |
+| [`getEvents`](#op-getevents) | `GET /api/v1/analytics/behavior/events` | read | `analytics:read` | Get Events |
+| [`getExitPages`](#op-getexitpages) | `GET /api/v1/analytics/behavior/exit-pages` | read | `analytics:read` | Get Exit Pages |
+| [`getFormAnalysis`](#op-getformanalysis) | `GET /api/v1/analytics/conversions/forms/analysis` | read | `analytics:read` | Get Form Analysis |
+| [`getForms`](#op-getforms) | `GET /api/v1/analytics/conversions/forms` | read | `analytics:read` | Get Forms |
+| [`getFormsTrend`](#op-getformstrend) | `GET /api/v1/analytics/conversions/forms/trend` | read | `analytics:read` | Get Forms Trend |
+| [`getFunnel`](#op-getfunnel) | `GET /api/v1/analytics/conversions/funnel` | read | `analytics:read` | Get Funnel |
+| [`getGeoCities`](#op-getgeocities) | `GET /api/v1/analytics/audience/geo/cities` | read | `analytics:read` | Get Geo Cities |
+| [`getGeoCountries`](#op-getgeocountries) | `GET /api/v1/analytics/audience/geo` | read | `analytics:read` | Get Geo Countries |
+| [`getGoals`](#op-getgoals) | `GET /api/v1/analytics/conversions/goals` | read | `analytics:read` | Get Goals |
+| [`getGoalsTrend`](#op-getgoalstrend) | `GET /api/v1/analytics/conversions/goals/trend` | read | `analytics:read` | Get Goals Trend |
+| [`getLandingPages`](#op-getlandingpages) | `GET /api/v1/analytics/behavior/landing-pages` | read | `analytics:read` | Get Landing Pages |
+| [`getPageMetrics`](#op-getpagemetrics) | `GET /api/v1/analytics/behavior/page-metrics` | read | `analytics:read` | Get Page Metrics |
+| [`getRealtime`](#op-getrealtime) | `GET /api/v1/analytics/realtime` | read | `analytics:read` | Get Realtime |
+| [`getRealtimeLocations`](#op-getrealtimelocations) | `GET /api/v1/analytics/realtime/locations` | read | `analytics:read` | Get Realtime Locations |
+| [`getRealtimePages`](#op-getrealtimepages) | `GET /api/v1/analytics/realtime/pages` | read | `analytics:read` | Get Realtime Pages |
+| [`getRealtimeSources`](#op-getrealtimesources) | `GET /api/v1/analytics/realtime/sources` | read | `analytics:read` | Get Realtime Sources |
+| [`getSessionDepthDistribution`](#op-getsessiondepthdistribution) | `GET /api/v1/analytics/engagement/depth-distribution` | read | `analytics:read` | Get Session Depth Distribution |
+| [`getTechnologyOverview`](#op-gettechnologyoverview) | `GET /api/v1/analytics/audience/technology` | read | `analytics:read` | Get Technology Overview |
+| [`getTimeOnSiteDistribution`](#op-gettimeonsitedistribution) | `GET /api/v1/analytics/engagement/time-distribution` | read | `analytics:read` | Get Time On Site Distribution |
+| [`getTopPages`](#op-gettoppages) | `GET /api/v1/analytics/behavior/pages` | read | `analytics:read` | Get Top Pages |
+
+---
+
+<a id="op-getacquisitioncampaigns"></a>
+
+### `g8.api.webAnalytics.getAcquisitionCampaigns(input?)`
+
+**Get Acquisition Campaigns**
+
+- HTTP: `GET /api/v1/analytics/acquisition/campaigns`
+- operationId: `get_acquisition_campaigns_analytics_acquisition_campaigns_get` (also callable as `g8.api.call("get_acquisition_campaigns_analytics_acquisition_campaigns_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `analytics:read`
+
+Get UTM campaign performance.
+
+**Cache TTL**: 300 seconds (5 min) - campaigns change less frequently.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `query.limit` | `integer` | no | Number of campaigns to return default `50` |
+| `query.write_key` | `string \| null` | no | Comma-separated public keys to filter by |
+| `query.days` | `integer` | no | Number of days to analyze default `30` |
+| `query.date_from` | `string \| null` | no | Anchored window start (YYYY-MM-DD). Must be sent with date_to. |
+| `query.date_to` | `string \| null` | no | Anchored window end (YYYY-MM-DD). Must be sent with date_from. |
+| `headers.X-Org-Id` | `string \| null` | no |  |
+
+**Returns** `AnalyticsResponse`: the envelope `{ data: Record<string, unknown> | Array<unknown>, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `meta` (AnalyticsMeta), `success` (boolean).
+
+**Example**
+
+```ts
+const result = await g8.api.webAnalytics.getAcquisitionCampaigns();
+```
+
+---
+
+<a id="op-getacquisitionchannels"></a>
+
+### `g8.api.webAnalytics.getAcquisitionChannels(input?)`
+
+**Get Acquisition Channels**
+
+- HTTP: `GET /api/v1/analytics/acquisition/channels`
+- operationId: `get_acquisition_channels_analytics_acquisition_channels_get` (also callable as `g8.api.call("get_acquisition_channels_analytics_acquisition_channels_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `analytics:read`
+
+Get acquisition by channel grouping.
+
+Channels: Direct, Organic Search, Paid Search, Organic Social,
+Paid Social, Email, Referral, Display, Affiliates, Other.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `query.write_key` | `string \| null` | no | Comma-separated public keys to filter by |
+| `query.days` | `integer` | no | Number of days to analyze default `30` |
+| `query.date_from` | `string \| null` | no | Anchored window start (YYYY-MM-DD). Must be sent with date_to. |
+| `query.date_to` | `string \| null` | no | Anchored window end (YYYY-MM-DD). Must be sent with date_from. |
+| `headers.X-Org-Id` | `string \| null` | no |  |
+
+**Returns** `AnalyticsResponse`: the envelope `{ data: Record<string, unknown> | Array<unknown>, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `meta` (AnalyticsMeta), `success` (boolean).
+
+**Example**
+
+```ts
+const result = await g8.api.webAnalytics.getAcquisitionChannels();
+```
+
+---
+
+<a id="op-getacquisitionchannelstrend"></a>
+
+### `g8.api.webAnalytics.getAcquisitionChannelsTrend(input?)`
+
+**Get Acquisition Channels Trend**
+
+- HTTP: `GET /api/v1/analytics/acquisition/channels/trend`
+- operationId: `get_acquisition_channels_trend_analytics_acquisition_channels_trend_get` (also callable as `g8.api.call("get_acquisition_channels_trend_analytics_acquisition_channels_trend_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `analytics:read`
+
+Get daily channel breakdown for stacked area charts.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `query.write_key` | `string \| null` | no | Comma-separated public keys to filter by |
+| `query.days` | `integer` | no | Number of days to analyze default `30` |
+| `query.date_from` | `string \| null` | no | Anchored window start (YYYY-MM-DD). Must be sent with date_to. |
+| `query.date_to` | `string \| null` | no | Anchored window end (YYYY-MM-DD). Must be sent with date_from. |
+| `headers.X-Org-Id` | `string \| null` | no |  |
+
+**Returns** `AnalyticsResponse`: the envelope `{ data: Record<string, unknown> | Array<unknown>, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `meta` (AnalyticsMeta), `success` (boolean).
+
+**Example**
+
+```ts
+const result = await g8.api.webAnalytics.getAcquisitionChannelsTrend();
+```
+
+---
+
+<a id="op-getacquisitionreferrals"></a>
+
+### `g8.api.webAnalytics.getAcquisitionReferrals(input?)`
+
+**Get Acquisition Referrals**
+
+- HTTP: `GET /api/v1/analytics/acquisition/referrals`
+- operationId: `get_acquisition_referrals_analytics_acquisition_referrals_get` (also callable as `g8.api.call("get_acquisition_referrals_analytics_acquisition_referrals_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `analytics:read`
+
+Get top referring domains.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `query.limit` | `integer` | no | Number of referrers to return default `50` |
+| `query.write_key` | `string \| null` | no | Comma-separated public keys to filter by |
+| `query.days` | `integer` | no | Number of days to analyze default `30` |
+| `query.date_from` | `string \| null` | no | Anchored window start (YYYY-MM-DD). Must be sent with date_to. |
+| `query.date_to` | `string \| null` | no | Anchored window end (YYYY-MM-DD). Must be sent with date_from. |
+| `headers.X-Org-Id` | `string \| null` | no |  |
+
+**Returns** `AnalyticsResponse`: the envelope `{ data: Record<string, unknown> | Array<unknown>, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `meta` (AnalyticsMeta), `success` (boolean).
+
+**Example**
+
+```ts
+const result = await g8.api.webAnalytics.getAcquisitionReferrals();
+```
+
+---
+
+<a id="op-getacquisitionsearch"></a>
+
+### `g8.api.webAnalytics.getAcquisitionSearch(input?)`
+
+**Get Acquisition Search**
+
+- HTTP: `GET /api/v1/analytics/acquisition/search`
+- operationId: `get_acquisition_search_analytics_acquisition_search_get` (also callable as `g8.api.call("get_acquisition_search_analytics_acquisition_search_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `analytics:read`
+
+Get acquisition from search engines.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `query.write_key` | `string \| null` | no | Comma-separated public keys to filter by |
+| `query.days` | `integer` | no | Number of days to analyze default `30` |
+| `query.date_from` | `string \| null` | no | Anchored window start (YYYY-MM-DD). Must be sent with date_to. |
+| `query.date_to` | `string \| null` | no | Anchored window end (YYYY-MM-DD). Must be sent with date_from. |
+| `headers.X-Org-Id` | `string \| null` | no |  |
+
+**Returns** `AnalyticsResponse`: the envelope `{ data: Record<string, unknown> | Array<unknown>, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `meta` (AnalyticsMeta), `success` (boolean).
+
+**Example**
+
+```ts
+const result = await g8.api.webAnalytics.getAcquisitionSearch();
+```
+
+---
+
+<a id="op-getacquisitionsocial"></a>
+
+### `g8.api.webAnalytics.getAcquisitionSocial(input?)`
+
+**Get Acquisition Social**
+
+- HTTP: `GET /api/v1/analytics/acquisition/social`
+- operationId: `get_acquisition_social_analytics_acquisition_social_get` (also callable as `g8.api.call("get_acquisition_social_analytics_acquisition_social_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `analytics:read`
+
+Get acquisition from social networks.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `query.write_key` | `string \| null` | no | Comma-separated public keys to filter by |
+| `query.days` | `integer` | no | Number of days to analyze default `30` |
+| `query.date_from` | `string \| null` | no | Anchored window start (YYYY-MM-DD). Must be sent with date_to. |
+| `query.date_to` | `string \| null` | no | Anchored window end (YYYY-MM-DD). Must be sent with date_from. |
+| `headers.X-Org-Id` | `string \| null` | no |  |
+
+**Returns** `AnalyticsResponse`: the envelope `{ data: Record<string, unknown> | Array<unknown>, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `meta` (AnalyticsMeta), `success` (boolean).
+
+**Example**
+
+```ts
+const result = await g8.api.webAnalytics.getAcquisitionSocial();
+```
+
+---
+
+<a id="op-getacquisitionsources"></a>
+
+### `g8.api.webAnalytics.getAcquisitionSources(input?)`
+
+**Get Acquisition Sources**
+
+- HTTP: `GET /api/v1/analytics/acquisition/sources`
+- operationId: `get_acquisition_sources_analytics_acquisition_sources_get` (also callable as `g8.api.call("get_acquisition_sources_analytics_acquisition_sources_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `analytics:read`
+
+Get acquisition by source/medium combination.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `query.limit` | `integer` | no | Number of sources to return default `50` |
+| `query.write_key` | `string \| null` | no | Comma-separated public keys to filter by |
+| `query.days` | `integer` | no | Number of days to analyze default `30` |
+| `query.date_from` | `string \| null` | no | Anchored window start (YYYY-MM-DD). Must be sent with date_to. |
+| `query.date_to` | `string \| null` | no | Anchored window end (YYYY-MM-DD). Must be sent with date_from. |
+| `headers.X-Org-Id` | `string \| null` | no |  |
+
+**Returns** `AnalyticsResponse`: the envelope `{ data: Record<string, unknown> | Array<unknown>, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `meta` (AnalyticsMeta), `success` (boolean).
+
+**Example**
+
+```ts
+const result = await g8.api.webAnalytics.getAcquisitionSources();
+```
+
+---
+
+<a id="op-getaudiencebehavior"></a>
+
+### `g8.api.webAnalytics.getAudienceBehavior(input?)`
+
+**Get Audience Behavior**
+
+- HTTP: `GET /api/v1/analytics/audience/behavior`
+- operationId: `get_audience_behavior_analytics_audience_behavior_get` (also callable as `g8.api.call("get_audience_behavior_analytics_audience_behavior_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `analytics:read`
+
+Get new vs returning visitors breakdown.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `query.write_key` | `string \| null` | no | Comma-separated public keys to filter by |
+| `query.days` | `integer` | no | Number of days to analyze default `30` |
+| `query.date_from` | `string \| null` | no | Anchored window start (YYYY-MM-DD). Must be sent with date_to. |
+| `query.date_to` | `string \| null` | no | Anchored window end (YYYY-MM-DD). Must be sent with date_from. |
+| `headers.X-Org-Id` | `string \| null` | no |  |
+
+**Returns** `AnalyticsResponse`: the envelope `{ data: Record<string, unknown> | Array<unknown>, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `meta` (AnalyticsMeta), `success` (boolean).
+
+**Example**
+
+```ts
+const result = await g8.api.webAnalytics.getAudienceBehavior();
+```
+
+---
+
+<a id="op-getaudiencedemographics"></a>
+
+### `g8.api.webAnalytics.getAudienceDemographics(input?)`
+
+**Get Audience Demographics**
+
+- HTTP: `GET /api/v1/analytics/audience/demographics`
+- operationId: `get_audience_demographics_analytics_audience_demographics_get` (also callable as `g8.api.call("get_audience_demographics_analytics_audience_demographics_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `analytics:read`
+
+Get combined demographics: countries, cities, languages.
+
+Aggregates geographic and language data for the demographics view.
+Returns top 10 entries for each category.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `query.write_key` | `string \| null` | no | Comma-separated public keys to filter by |
+| `query.days` | `integer` | no | Number of days to analyze default `30` |
+| `query.date_from` | `string \| null` | no | Anchored window start (YYYY-MM-DD). Must be sent with date_to. |
+| `query.date_to` | `string \| null` | no | Anchored window end (YYYY-MM-DD). Must be sent with date_from. |
+| `headers.X-Org-Id` | `string \| null` | no |  |
+
+**Returns** `AnalyticsResponse`: the envelope `{ data: Record<string, unknown> | Array<unknown>, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `meta` (AnalyticsMeta), `success` (boolean).
+
+**Example**
+
+```ts
+const result = await g8.api.webAnalytics.getAudienceDemographics();
+```
+
+---
+
+<a id="op-getaudiencelanguages"></a>
+
+### `g8.api.webAnalytics.getAudienceLanguages(input?)`
+
+**Get Audience Languages**
+
+- HTTP: `GET /api/v1/analytics/audience/languages`
+- operationId: `get_audience_languages_analytics_audience_languages_get` (also callable as `g8.api.call("get_audience_languages_analytics_audience_languages_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `analytics:read`
+
+Get visitor languages breakdown.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `query.limit` | `integer` | no | Number of languages to return default `20` |
+| `query.write_key` | `string \| null` | no | Comma-separated public keys to filter by |
+| `query.days` | `integer` | no | Number of days to analyze default `30` |
+| `query.date_from` | `string \| null` | no | Anchored window start (YYYY-MM-DD). Must be sent with date_to. |
+| `query.date_to` | `string \| null` | no | Anchored window end (YYYY-MM-DD). Must be sent with date_from. |
+| `headers.X-Org-Id` | `string \| null` | no |  |
+
+**Returns** `AnalyticsResponse`: the envelope `{ data: Record<string, unknown> | Array<unknown>, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `meta` (AnalyticsMeta), `success` (boolean).
+
+**Example**
+
+```ts
+const result = await g8.api.webAnalytics.getAudienceLanguages();
+```
+
+---
+
+<a id="op-getaudienceoverview"></a>
+
+### `g8.api.webAnalytics.getAudienceOverview(input?)`
+
+**Get Audience Overview**
+
+- HTTP: `GET /api/v1/analytics/audience/overview`
+- operationId: `get_audience_overview_analytics_audience_overview_get` (also callable as `g8.api.call("get_audience_overview_analytics_audience_overview_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `analytics:read`
+
+Get audience overview: total users, new users, sessions, page views.
+
+**Typical use**: Dashboard header metrics.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `query.write_key` | `string \| null` | no | Comma-separated public keys to filter by |
+| `query.days` | `integer` | no | Number of days to analyze default `30` |
+| `query.date_from` | `string \| null` | no | Anchored window start (YYYY-MM-DD). Must be sent with date_to. |
+| `query.date_to` | `string \| null` | no | Anchored window end (YYYY-MM-DD). Must be sent with date_from. |
+| `headers.X-Org-Id` | `string \| null` | no |  |
+
+**Returns** `AnalyticsResponse`: the envelope `{ data: Record<string, unknown> | Array<unknown>, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `meta` (AnalyticsMeta), `success` (boolean).
+
+**Example**
+
+```ts
+const result = await g8.api.webAnalytics.getAudienceOverview();
+```
+
+---
+
+<a id="op-getaudiencetrend"></a>
+
+### `g8.api.webAnalytics.getAudienceTrend(input?)`
+
+**Get Audience Trend**
+
+- HTTP: `GET /api/v1/analytics/audience/trend`
+- operationId: `get_audience_trend_analytics_audience_trend_get` (also callable as `g8.api.call("get_audience_trend_analytics_audience_trend_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `analytics:read`
+
+Get daily audience trend for line charts.
+
+Returns date, users, new_users, page_views, sessions per day.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `query.write_key` | `string \| null` | no | Comma-separated public keys to filter by |
+| `query.days` | `integer` | no | Number of days to analyze default `30` |
+| `query.date_from` | `string \| null` | no | Anchored window start (YYYY-MM-DD). Must be sent with date_to. |
+| `query.date_to` | `string \| null` | no | Anchored window end (YYYY-MM-DD). Must be sent with date_from. |
+| `headers.X-Org-Id` | `string \| null` | no |  |
+
+**Returns** `AnalyticsResponse`: the envelope `{ data: Record<string, unknown> | Array<unknown>, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `meta` (AnalyticsMeta), `success` (boolean).
+
+**Example**
+
+```ts
+const result = await g8.api.webAnalytics.getAudienceTrend();
+```
+
+---
+
+<a id="op-getconversionrate"></a>
+
+### `g8.api.webAnalytics.getConversionRate(input?)`
+
+**Get Conversion Rate**
+
+- HTTP: `GET /api/v1/analytics/conversions/rate`
+- operationId: `get_conversion_rate_analytics_conversions_rate_get` (also callable as `g8.api.call("get_conversion_rate_analytics_conversions_rate_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `analytics:read`
+
+Get overall visitor-to-conversion rate.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `query.write_key` | `string \| null` | no | Comma-separated public keys to filter by |
+| `query.days` | `integer` | no | Number of days to analyze default `30` |
+| `query.date_from` | `string \| null` | no | Anchored window start (YYYY-MM-DD). Must be sent with date_to. |
+| `query.date_to` | `string \| null` | no | Anchored window end (YYYY-MM-DD). Must be sent with date_from. |
+| `headers.X-Org-Id` | `string \| null` | no |  |
+
+**Returns** `AnalyticsResponse`: the envelope `{ data: Record<string, unknown> | Array<unknown>, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `meta` (AnalyticsMeta), `success` (boolean).
+
+**Example**
+
+```ts
+const result = await g8.api.webAnalytics.getConversionRate();
+```
+
+---
+
+<a id="op-getengagementbycampaign"></a>
+
+### `g8.api.webAnalytics.getEngagementByCampaign(input?)`
+
+**Get Engagement By Campaign**
+
+- HTTP: `GET /api/v1/analytics/engagement/by-campaign`
+- operationId: `get_engagement_by_campaign_analytics_engagement_by_campaign_get` (also callable as `g8.api.call("get_engagement_by_campaign_analytics_engagement_by_campaign_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `analytics:read`
+
+Get engagement metrics by UTM campaign.
+
+Extended campaign metrics including engagement quality.
+**Cache TTL**: 300 seconds (5 min) - campaigns change less frequently.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `query.limit` | `integer` | no | Number of campaigns to return default `50` |
+| `query.write_key` | `string \| null` | no | Comma-separated public keys to filter by |
+| `query.days` | `integer` | no | Number of days to analyze default `30` |
+| `query.date_from` | `string \| null` | no | Anchored window start (YYYY-MM-DD). Must be sent with date_to. |
+| `query.date_to` | `string \| null` | no | Anchored window end (YYYY-MM-DD). Must be sent with date_from. |
+| `headers.X-Org-Id` | `string \| null` | no |  |
+
+**Returns** `AnalyticsResponse`: the envelope `{ data: Record<string, unknown> | Array<unknown>, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `meta` (AnalyticsMeta), `success` (boolean).
+
+**Example**
+
+```ts
+const result = await g8.api.webAnalytics.getEngagementByCampaign();
+```
+
+---
+
+<a id="op-getengagementbychannel"></a>
+
+### `g8.api.webAnalytics.getEngagementByChannel(input?)`
+
+**Get Engagement By Channel**
+
+- HTTP: `GET /api/v1/analytics/engagement/by-channel`
+- operationId: `get_engagement_by_channel_analytics_engagement_by_channel_get` (also callable as `g8.api.call("get_engagement_by_channel_analytics_engagement_by_channel_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `analytics:read`
+
+Get engagement metrics by acquisition channel.
+
+Shows which channels drive best engagement quality.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `query.write_key` | `string \| null` | no | Comma-separated public keys to filter by |
+| `query.days` | `integer` | no | Number of days to analyze default `30` |
+| `query.date_from` | `string \| null` | no | Anchored window start (YYYY-MM-DD). Must be sent with date_to. |
+| `query.date_to` | `string \| null` | no | Anchored window end (YYYY-MM-DD). Must be sent with date_from. |
+| `headers.X-Org-Id` | `string \| null` | no |  |
+
+**Returns** `AnalyticsResponse`: the envelope `{ data: Record<string, unknown> | Array<unknown>, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `meta` (AnalyticsMeta), `success` (boolean).
+
+**Example**
+
+```ts
+const result = await g8.api.webAnalytics.getEngagementByChannel();
+```
+
+---
+
+<a id="op-getengagementbylandingpage"></a>
+
+### `g8.api.webAnalytics.getEngagementByLandingPage(input?)`
+
+**Get Engagement By Landing Page**
+
+- HTTP: `GET /api/v1/analytics/engagement/by-landing-page`
+- operationId: `get_engagement_by_landing_page_analytics_engagement_by_landing_page_get` (also callable as `g8.api.call("get_engagement_by_landing_page_analytics_engagement_by_landing_page_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `analytics:read`
+
+Get engagement metrics by landing page.
+
+Shows which landing pages drive best engagement quality.
+Only includes pages with at least 10 sessions.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `query.limit` | `integer` | no | Number of pages to return default `20` |
+| `query.write_key` | `string \| null` | no | Comma-separated public keys to filter by |
+| `query.days` | `integer` | no | Number of days to analyze default `30` |
+| `query.date_from` | `string \| null` | no | Anchored window start (YYYY-MM-DD). Must be sent with date_to. |
+| `query.date_to` | `string \| null` | no | Anchored window end (YYYY-MM-DD). Must be sent with date_from. |
+| `headers.X-Org-Id` | `string \| null` | no |  |
+
+**Returns** `AnalyticsResponse`: the envelope `{ data: Record<string, unknown> | Array<unknown>, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `meta` (AnalyticsMeta), `success` (boolean).
+
+**Example**
+
+```ts
+const result = await g8.api.webAnalytics.getEngagementByLandingPage();
+```
+
+---
+
+<a id="op-getengagementoverview"></a>
+
+### `g8.api.webAnalytics.getEngagementOverview(input?)`
+
+**Get Engagement Overview**
+
+- HTTP: `GET /api/v1/analytics/engagement/overview`
+- operationId: `get_engagement_overview_analytics_engagement_overview_get` (also callable as `g8.api.call("get_engagement_overview_analytics_engagement_overview_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `analytics:read`
+
+Get engagement quality overview with trend indicators.
+
+Returns:
+- **total_sessions**: Total session count
+- **avg_session_depth**: Average pages per session
+- **avg_time_minutes**: Average session duration in minutes
+- **bounce_rate**: Percentage of single-page sessions
+- **engaged_sessions**: Sessions with >1 page AND >30s duration
+- **engaged_pct**: Percentage of engaged sessions
+- **Trend indicators**: Period-over-period comparison for each metric
+
+**Typical use**: Marketing Intelligence dashboard - Engagement Quality card.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `query.write_key` | `string \| null` | no | Comma-separated public keys to filter by |
+| `query.days` | `integer` | no | Number of days to analyze default `30` |
+| `query.date_from` | `string \| null` | no | Anchored window start (YYYY-MM-DD). Must be sent with date_to. |
+| `query.date_to` | `string \| null` | no | Anchored window end (YYYY-MM-DD). Must be sent with date_from. |
+| `headers.X-Org-Id` | `string \| null` | no |  |
+
+**Returns** `AnalyticsResponse`: the envelope `{ data: Record<string, unknown> | Array<unknown>, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `meta` (AnalyticsMeta), `success` (boolean).
+
+**Example**
+
+```ts
+const result = await g8.api.webAnalytics.getEngagementOverview();
+```
+
+---
+
+<a id="op-getengagementtrend"></a>
+
+### `g8.api.webAnalytics.getEngagementTrend(input?)`
+
+**Get Engagement Trend**
+
+- HTTP: `GET /api/v1/analytics/engagement/trend`
+- operationId: `get_engagement_trend_analytics_engagement_trend_get` (also callable as `g8.api.call("get_engagement_trend_analytics_engagement_trend_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `analytics:read`
+
+Get daily engagement trend for line charts.
+
+Returns daily breakdown of:
+- sessions
+- avg_session_depth
+- avg_time_minutes
+- bounce_rate
+- engaged_sessions
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `query.write_key` | `string \| null` | no | Comma-separated public keys to filter by |
+| `query.days` | `integer` | no | Number of days to analyze default `30` |
+| `query.date_from` | `string \| null` | no | Anchored window start (YYYY-MM-DD). Must be sent with date_to. |
+| `query.date_to` | `string \| null` | no | Anchored window end (YYYY-MM-DD). Must be sent with date_from. |
+| `headers.X-Org-Id` | `string \| null` | no |  |
+
+**Returns** `AnalyticsResponse`: the envelope `{ data: Record<string, unknown> | Array<unknown>, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `meta` (AnalyticsMeta), `success` (boolean).
+
+**Example**
+
+```ts
+const result = await g8.api.webAnalytics.getEngagementTrend();
+```
+
+---
+
+<a id="op-getevents"></a>
+
+### `g8.api.webAnalytics.getEvents(input?)`
+
+**Get Events**
+
+- HTTP: `GET /api/v1/analytics/behavior/events`
+- operationId: `get_events_analytics_behavior_events_get` (also callable as `g8.api.call("get_events_analytics_behavior_events_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `analytics:read`
+
+Get custom events summary (track events).
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `query.limit` | `integer` | no | Number of events to return default `50` |
+| `query.write_key` | `string \| null` | no | Comma-separated public keys to filter by |
+| `query.days` | `integer` | no | Number of days to analyze default `30` |
+| `query.date_from` | `string \| null` | no | Anchored window start (YYYY-MM-DD). Must be sent with date_to. |
+| `query.date_to` | `string \| null` | no | Anchored window end (YYYY-MM-DD). Must be sent with date_from. |
+| `headers.X-Org-Id` | `string \| null` | no |  |
+
+**Returns** `AnalyticsResponse`: the envelope `{ data: Record<string, unknown> | Array<unknown>, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `meta` (AnalyticsMeta), `success` (boolean).
+
+**Example**
+
+```ts
+const result = await g8.api.webAnalytics.getEvents();
+```
+
+---
+
+<a id="op-getexitpages"></a>
+
+### `g8.api.webAnalytics.getExitPages(input?)`
+
+**Get Exit Pages**
+
+- HTTP: `GET /api/v1/analytics/behavior/exit-pages`
+- operationId: `get_exit_pages_analytics_behavior_exit_pages_get` (also callable as `g8.api.call("get_exit_pages_analytics_behavior_exit_pages_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `analytics:read`
+
+Get top exit pages (last pages in sessions).
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `query.limit` | `integer` | no | Number of pages to return default `50` |
+| `query.write_key` | `string \| null` | no | Comma-separated public keys to filter by |
+| `query.days` | `integer` | no | Number of days to analyze default `30` |
+| `query.date_from` | `string \| null` | no | Anchored window start (YYYY-MM-DD). Must be sent with date_to. |
+| `query.date_to` | `string \| null` | no | Anchored window end (YYYY-MM-DD). Must be sent with date_from. |
+| `headers.X-Org-Id` | `string \| null` | no |  |
+
+**Returns** `AnalyticsResponse`: the envelope `{ data: Record<string, unknown> | Array<unknown>, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `meta` (AnalyticsMeta), `success` (boolean).
+
+**Example**
+
+```ts
+const result = await g8.api.webAnalytics.getExitPages();
+```
+
+---
+
+<a id="op-getformanalysis"></a>
+
+### `g8.api.webAnalytics.getFormAnalysis(input?)`
+
+**Get Form Analysis**
+
+- HTTP: `GET /api/v1/analytics/conversions/forms/analysis`
+- operationId: `get_form_analysis_analytics_conversions_forms_analysis_get` (also callable as `g8.api.call("get_form_analysis_analytics_conversions_forms_analysis_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `analytics:read`
+
+Get detailed form analysis with conversion rates.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `query.limit` | `integer` | no | Number of forms to return default `20` |
+| `query.write_key` | `string \| null` | no | Comma-separated public keys to filter by |
+| `query.days` | `integer` | no | Number of days to analyze default `30` |
+| `query.date_from` | `string \| null` | no | Anchored window start (YYYY-MM-DD). Must be sent with date_to. |
+| `query.date_to` | `string \| null` | no | Anchored window end (YYYY-MM-DD). Must be sent with date_from. |
+| `headers.X-Org-Id` | `string \| null` | no |  |
+
+**Returns** `AnalyticsResponse`: the envelope `{ data: Record<string, unknown> | Array<unknown>, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `meta` (AnalyticsMeta), `success` (boolean).
+
+**Example**
+
+```ts
+const result = await g8.api.webAnalytics.getFormAnalysis();
+```
+
+---
+
+<a id="op-getforms"></a>
+
+### `g8.api.webAnalytics.getForms(input?)`
+
+**Get Forms**
+
+- HTTP: `GET /api/v1/analytics/conversions/forms`
+- operationId: `get_forms_analytics_conversions_forms_get` (also callable as `g8.api.call("get_forms_analytics_conversions_forms_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `analytics:read`
+
+Get form submission analytics.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `query.limit` | `integer` | no | Number of forms to return default `50` |
+| `query.write_key` | `string \| null` | no | Comma-separated public keys to filter by |
+| `query.days` | `integer` | no | Number of days to analyze default `30` |
+| `query.date_from` | `string \| null` | no | Anchored window start (YYYY-MM-DD). Must be sent with date_to. |
+| `query.date_to` | `string \| null` | no | Anchored window end (YYYY-MM-DD). Must be sent with date_from. |
+| `headers.X-Org-Id` | `string \| null` | no |  |
+
+**Returns** `AnalyticsResponse`: the envelope `{ data: Record<string, unknown> | Array<unknown>, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `meta` (AnalyticsMeta), `success` (boolean).
+
+**Example**
+
+```ts
+const result = await g8.api.webAnalytics.getForms();
+```
+
+---
+
+<a id="op-getformstrend"></a>
+
+### `g8.api.webAnalytics.getFormsTrend(input?)`
+
+**Get Forms Trend**
+
+- HTTP: `GET /api/v1/analytics/conversions/forms/trend`
+- operationId: `get_forms_trend_analytics_conversions_forms_trend_get` (also callable as `g8.api.call("get_forms_trend_analytics_conversions_forms_trend_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `analytics:read`
+
+Get daily form submissions trend.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `query.write_key` | `string \| null` | no | Comma-separated public keys to filter by |
+| `query.days` | `integer` | no | Number of days to analyze default `30` |
+| `query.date_from` | `string \| null` | no | Anchored window start (YYYY-MM-DD). Must be sent with date_to. |
+| `query.date_to` | `string \| null` | no | Anchored window end (YYYY-MM-DD). Must be sent with date_from. |
+| `headers.X-Org-Id` | `string \| null` | no |  |
+
+**Returns** `AnalyticsResponse`: the envelope `{ data: Record<string, unknown> | Array<unknown>, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `meta` (AnalyticsMeta), `success` (boolean).
+
+**Example**
+
+```ts
+const result = await g8.api.webAnalytics.getFormsTrend();
+```
+
+---
+
+<a id="op-getfunnel"></a>
+
+### `g8.api.webAnalytics.getFunnel(input?)`
+
+**Get Funnel**
+
+- HTTP: `GET /api/v1/analytics/conversions/funnel`
+- operationId: `get_funnel_analytics_conversions_funnel_get` (also callable as `g8.api.call("get_funnel_analytics_conversions_funnel_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `analytics:read`
+
+Get funnel analysis.
+
+Default funnel: Site Visitors → Viewed Form → Submitted Form → Booked Meeting
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `query.write_key` | `string \| null` | no | Comma-separated public keys to filter by |
+| `query.days` | `integer` | no | Number of days to analyze default `30` |
+| `query.date_from` | `string \| null` | no | Anchored window start (YYYY-MM-DD). Must be sent with date_to. |
+| `query.date_to` | `string \| null` | no | Anchored window end (YYYY-MM-DD). Must be sent with date_from. |
+| `headers.X-Org-Id` | `string \| null` | no |  |
+
+**Returns** `AnalyticsResponse`: the envelope `{ data: Record<string, unknown> | Array<unknown>, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `meta` (AnalyticsMeta), `success` (boolean).
+
+**Example**
+
+```ts
+const result = await g8.api.webAnalytics.getFunnel();
+```
+
+---
+
+<a id="op-getgeocities"></a>
+
+### `g8.api.webAnalytics.getGeoCities(input?)`
+
+**Get Geo Cities**
+
+- HTTP: `GET /api/v1/analytics/audience/geo/cities`
+- operationId: `get_geo_cities_analytics_audience_geo_cities_get` (also callable as `g8.api.call("get_geo_cities_analytics_audience_geo_cities_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `analytics:read`
+
+Get geographic distribution by city.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `query.limit` | `integer` | no | Number of cities to return default `50` |
+| `query.write_key` | `string \| null` | no | Comma-separated public keys to filter by |
+| `query.days` | `integer` | no | Number of days to analyze default `30` |
+| `query.date_from` | `string \| null` | no | Anchored window start (YYYY-MM-DD). Must be sent with date_to. |
+| `query.date_to` | `string \| null` | no | Anchored window end (YYYY-MM-DD). Must be sent with date_from. |
+| `headers.X-Org-Id` | `string \| null` | no |  |
+
+**Returns** `AnalyticsResponse`: the envelope `{ data: Record<string, unknown> | Array<unknown>, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `meta` (AnalyticsMeta), `success` (boolean).
+
+**Example**
+
+```ts
+const result = await g8.api.webAnalytics.getGeoCities();
+```
+
+---
+
+<a id="op-getgeocountries"></a>
+
+### `g8.api.webAnalytics.getGeoCountries(input?)`
+
+**Get Geo Countries**
+
+- HTTP: `GET /api/v1/analytics/audience/geo`
+- operationId: `get_geo_countries_analytics_audience_geo_get` (also callable as `g8.api.call("get_geo_countries_analytics_audience_geo_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `analytics:read`
+
+Get geographic distribution by country.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `query.limit` | `integer` | no | Number of countries to return default `50` |
+| `query.write_key` | `string \| null` | no | Comma-separated public keys to filter by |
+| `query.days` | `integer` | no | Number of days to analyze default `30` |
+| `query.date_from` | `string \| null` | no | Anchored window start (YYYY-MM-DD). Must be sent with date_to. |
+| `query.date_to` | `string \| null` | no | Anchored window end (YYYY-MM-DD). Must be sent with date_from. |
+| `headers.X-Org-Id` | `string \| null` | no |  |
+
+**Returns** `AnalyticsResponse`: the envelope `{ data: Record<string, unknown> | Array<unknown>, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `meta` (AnalyticsMeta), `success` (boolean).
+
+**Example**
+
+```ts
+const result = await g8.api.webAnalytics.getGeoCountries();
+```
+
+---
+
+<a id="op-getgoals"></a>
+
+### `g8.api.webAnalytics.getGoals(input?)`
+
+**Get Goals**
+
+- HTTP: `GET /api/v1/analytics/conversions/goals`
+- operationId: `get_goals_analytics_conversions_goals_get` (also callable as `g8.api.call("get_goals_analytics_conversions_goals_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `analytics:read`
+
+Get goal completions overview.
+
+Goals: Form Submissions, Meeting Booked, Signup, Purchase.
+**Cache TTL**: 300 seconds (5 min)
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `query.write_key` | `string \| null` | no | Comma-separated public keys to filter by |
+| `query.days` | `integer` | no | Number of days to analyze default `30` |
+| `query.date_from` | `string \| null` | no | Anchored window start (YYYY-MM-DD). Must be sent with date_to. |
+| `query.date_to` | `string \| null` | no | Anchored window end (YYYY-MM-DD). Must be sent with date_from. |
+| `headers.X-Org-Id` | `string \| null` | no |  |
+
+**Returns** `AnalyticsResponse`: the envelope `{ data: Record<string, unknown> | Array<unknown>, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `meta` (AnalyticsMeta), `success` (boolean).
+
+**Example**
+
+```ts
+const result = await g8.api.webAnalytics.getGoals();
+```
+
+---
+
+<a id="op-getgoalstrend"></a>
+
+### `g8.api.webAnalytics.getGoalsTrend(input?)`
+
+**Get Goals Trend**
+
+- HTTP: `GET /api/v1/analytics/conversions/goals/trend`
+- operationId: `get_goals_trend_analytics_conversions_goals_trend_get` (also callable as `g8.api.call("get_goals_trend_analytics_conversions_goals_trend_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `analytics:read`
+
+Get daily trend for goal completions.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `query.write_key` | `string \| null` | no | Comma-separated public keys to filter by |
+| `query.days` | `integer` | no | Number of days to analyze default `30` |
+| `query.date_from` | `string \| null` | no | Anchored window start (YYYY-MM-DD). Must be sent with date_to. |
+| `query.date_to` | `string \| null` | no | Anchored window end (YYYY-MM-DD). Must be sent with date_from. |
+| `headers.X-Org-Id` | `string \| null` | no |  |
+
+**Returns** `AnalyticsResponse`: the envelope `{ data: Record<string, unknown> | Array<unknown>, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `meta` (AnalyticsMeta), `success` (boolean).
+
+**Example**
+
+```ts
+const result = await g8.api.webAnalytics.getGoalsTrend();
+```
+
+---
+
+<a id="op-getlandingpages"></a>
+
+### `g8.api.webAnalytics.getLandingPages(input?)`
+
+**Get Landing Pages**
+
+- HTTP: `GET /api/v1/analytics/behavior/landing-pages`
+- operationId: `get_landing_pages_analytics_behavior_landing_pages_get` (also callable as `g8.api.call("get_landing_pages_analytics_behavior_landing_pages_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `analytics:read`
+
+Get top landing pages (entry pages).
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `query.limit` | `integer` | no | Number of pages to return default `50` |
+| `query.write_key` | `string \| null` | no | Comma-separated public keys to filter by |
+| `query.days` | `integer` | no | Number of days to analyze default `30` |
+| `query.date_from` | `string \| null` | no | Anchored window start (YYYY-MM-DD). Must be sent with date_to. |
+| `query.date_to` | `string \| null` | no | Anchored window end (YYYY-MM-DD). Must be sent with date_from. |
+| `headers.X-Org-Id` | `string \| null` | no |  |
+
+**Returns** `AnalyticsResponse`: the envelope `{ data: Record<string, unknown> | Array<unknown>, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `meta` (AnalyticsMeta), `success` (boolean).
+
+**Example**
+
+```ts
+const result = await g8.api.webAnalytics.getLandingPages();
+```
+
+---
+
+<a id="op-getpagemetrics"></a>
+
+### `g8.api.webAnalytics.getPageMetrics(input)`
+
+**Get Page Metrics**
+
+- HTTP: `GET /api/v1/analytics/behavior/page-metrics`
+- operationId: `get_page_metrics_analytics_behavior_page_metrics_get` (also callable as `g8.api.call("get_page_metrics_analytics_behavior_page_metrics_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `analytics:read`
+
+Single-page rollup (views/visitors/forms/bookings) — Studio Content Calendar overlay.
+
+The path goes into a ClickHouse SQL literal (escaped in the query builder);
+the strict charset check here is the boundary defense, mirroring
+``_parse_write_keys``.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `query.path` | `string` | yes | Exact context_page_path to roll up |
+| `query.write_key` | `string \| null` | no | Comma-separated public keys to filter by |
+| `query.days` | `integer` | no | Number of days to analyze default `30` |
+| `query.date_from` | `string \| null` | no | Anchored window start (YYYY-MM-DD). Must be sent with date_to. |
+| `query.date_to` | `string \| null` | no | Anchored window end (YYYY-MM-DD). Must be sent with date_from. |
+| `headers.X-Org-Id` | `string \| null` | no |  |
+
+**Returns** `AnalyticsResponse`: the envelope `{ data: Record<string, unknown> | Array<unknown>, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `meta` (AnalyticsMeta), `success` (boolean).
+
+**Example**
+
+```ts
+const result = await g8.api.webAnalytics.getPageMetrics({ query: { path: "example" } });
+```
+
+---
+
+<a id="op-getrealtime"></a>
+
+### `g8.api.webAnalytics.getRealtime(input?)`
+
+**Get Realtime**
+
+- HTTP: `GET /api/v1/analytics/realtime`
+- operationId: `get_realtime_analytics_realtime_get` (also callable as `g8.api.call("get_realtime_analytics_realtime_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `analytics:read`
+
+Get real-time analytics: active users in last 5 and 30 minutes.
+
+**Refresh rate**: Poll every 10 seconds for real-time updates.
+**Cache TTL**: 10 seconds
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `query.write_key` | `string \| null` | no | Comma-separated public keys to filter by |
+| `headers.X-Org-Id` | `string \| null` | no |  |
+
+**Returns** `AnalyticsResponse`: the envelope `{ data: Record<string, unknown> | Array<unknown>, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `meta` (AnalyticsMeta), `success` (boolean).
+
+**Example**
+
+```ts
+const result = await g8.api.webAnalytics.getRealtime();
+```
+
+---
+
+<a id="op-getrealtimelocations"></a>
+
+### `g8.api.webAnalytics.getRealtimeLocations(input?)`
+
+**Get Realtime Locations**
+
+- HTTP: `GET /api/v1/analytics/realtime/locations`
+- operationId: `get_realtime_locations_analytics_realtime_locations_get` (also callable as `g8.api.call("get_realtime_locations_analytics_realtime_locations_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `analytics:read`
+
+Get active locations in real-time (last 5 minutes).
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `query.limit` | `integer \| null` | no | Number of locations to return |
+| `query.write_key` | `string \| null` | no | Comma-separated public keys to filter by |
+| `headers.X-Org-Id` | `string \| null` | no |  |
+
+**Returns** `AnalyticsResponse`: the envelope `{ data: Record<string, unknown> | Array<unknown>, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `meta` (AnalyticsMeta), `success` (boolean).
+
+**Example**
+
+```ts
+const result = await g8.api.webAnalytics.getRealtimeLocations();
+```
+
+---
+
+<a id="op-getrealtimepages"></a>
+
+### `g8.api.webAnalytics.getRealtimePages(input?)`
+
+**Get Realtime Pages**
+
+- HTTP: `GET /api/v1/analytics/realtime/pages`
+- operationId: `get_realtime_pages_analytics_realtime_pages_get` (also callable as `g8.api.call("get_realtime_pages_analytics_realtime_pages_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `analytics:read`
+
+Get active pages in real-time (last 5 minutes).
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `query.limit` | `integer` | no | Number of pages to return default `10` |
+| `query.write_key` | `string \| null` | no | Comma-separated public keys to filter by |
+| `headers.X-Org-Id` | `string \| null` | no |  |
+
+**Returns** `AnalyticsResponse`: the envelope `{ data: Record<string, unknown> | Array<unknown>, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `meta` (AnalyticsMeta), `success` (boolean).
+
+**Example**
+
+```ts
+const result = await g8.api.webAnalytics.getRealtimePages();
+```
+
+---
+
+<a id="op-getrealtimesources"></a>
+
+### `g8.api.webAnalytics.getRealtimeSources(input?)`
+
+**Get Realtime Sources**
+
+- HTTP: `GET /api/v1/analytics/realtime/sources`
+- operationId: `get_realtime_sources_analytics_realtime_sources_get` (also callable as `g8.api.call("get_realtime_sources_analytics_realtime_sources_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `analytics:read`
+
+Get traffic sources in real-time (last 5 minutes).
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `query.limit` | `integer` | no | Number of sources to return default `10` |
+| `query.write_key` | `string \| null` | no | Comma-separated public keys to filter by |
+| `headers.X-Org-Id` | `string \| null` | no |  |
+
+**Returns** `AnalyticsResponse`: the envelope `{ data: Record<string, unknown> | Array<unknown>, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `meta` (AnalyticsMeta), `success` (boolean).
+
+**Example**
+
+```ts
+const result = await g8.api.webAnalytics.getRealtimeSources();
+```
+
+---
+
+<a id="op-getsessiondepthdistribution"></a>
+
+### `g8.api.webAnalytics.getSessionDepthDistribution(input?)`
+
+**Get Session Depth Distribution**
+
+- HTTP: `GET /api/v1/analytics/engagement/depth-distribution`
+- operationId: `get_session_depth_distribution_analytics_engagement_depth_distribution_get` (also callable as `g8.api.call("get_session_depth_distribution_analytics_engagement_depth_distribution_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `analytics:read`
+
+Get session depth distribution for histogram visualization.
+
+Returns buckets: 1 page, 2 pages, 3 pages, 4-5 pages, 6-10 pages, 10+ pages.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `query.write_key` | `string \| null` | no | Comma-separated public keys to filter by |
+| `query.days` | `integer` | no | Number of days to analyze default `30` |
+| `query.date_from` | `string \| null` | no | Anchored window start (YYYY-MM-DD). Must be sent with date_to. |
+| `query.date_to` | `string \| null` | no | Anchored window end (YYYY-MM-DD). Must be sent with date_from. |
+| `headers.X-Org-Id` | `string \| null` | no |  |
+
+**Returns** `AnalyticsResponse`: the envelope `{ data: Record<string, unknown> | Array<unknown>, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `meta` (AnalyticsMeta), `success` (boolean).
+
+**Example**
+
+```ts
+const result = await g8.api.webAnalytics.getSessionDepthDistribution();
+```
+
+---
+
+<a id="op-gettechnologyoverview"></a>
+
+### `g8.api.webAnalytics.getTechnologyOverview(input?)`
+
+**Get Technology Overview**
+
+- HTTP: `GET /api/v1/analytics/audience/technology`
+- operationId: `get_technology_overview_analytics_audience_technology_get` (also callable as `g8.api.call("get_technology_overview_analytics_audience_technology_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `analytics:read`
+
+Get technology overview: browsers, OS, and devices combined.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `query.write_key` | `string \| null` | no | Comma-separated public keys to filter by |
+| `query.days` | `integer` | no | Number of days to analyze default `30` |
+| `query.date_from` | `string \| null` | no | Anchored window start (YYYY-MM-DD). Must be sent with date_to. |
+| `query.date_to` | `string \| null` | no | Anchored window end (YYYY-MM-DD). Must be sent with date_from. |
+| `headers.X-Org-Id` | `string \| null` | no |  |
+
+**Returns** `AnalyticsResponse`: the envelope `{ data: Record<string, unknown> | Array<unknown>, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `meta` (AnalyticsMeta), `success` (boolean).
+
+**Example**
+
+```ts
+const result = await g8.api.webAnalytics.getTechnologyOverview();
+```
+
+---
+
+<a id="op-gettimeonsitedistribution"></a>
+
+### `g8.api.webAnalytics.getTimeOnSiteDistribution(input?)`
+
+**Get Time On Site Distribution**
+
+- HTTP: `GET /api/v1/analytics/engagement/time-distribution`
+- operationId: `get_time_on_site_distribution_analytics_engagement_time_distribution_get` (also callable as `g8.api.call("get_time_on_site_distribution_analytics_engagement_time_distribution_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `analytics:read`
+
+Get time on site distribution for histogram visualization.
+
+Returns buckets: 0s (bounce), 1-30s, 30s-1m, 1-3m, 3-10m, 10m+.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `query.write_key` | `string \| null` | no | Comma-separated public keys to filter by |
+| `query.days` | `integer` | no | Number of days to analyze default `30` |
+| `query.date_from` | `string \| null` | no | Anchored window start (YYYY-MM-DD). Must be sent with date_to. |
+| `query.date_to` | `string \| null` | no | Anchored window end (YYYY-MM-DD). Must be sent with date_from. |
+| `headers.X-Org-Id` | `string \| null` | no |  |
+
+**Returns** `AnalyticsResponse`: the envelope `{ data: Record<string, unknown> | Array<unknown>, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `meta` (AnalyticsMeta), `success` (boolean).
+
+**Example**
+
+```ts
+const result = await g8.api.webAnalytics.getTimeOnSiteDistribution();
+```
+
+---
+
+<a id="op-gettoppages"></a>
+
+### `g8.api.webAnalytics.getTopPages(input?)`
+
+**Get Top Pages**
+
+- HTTP: `GET /api/v1/analytics/behavior/pages`
+- operationId: `get_top_pages_analytics_behavior_pages_get` (also callable as `g8.api.call("get_top_pages_analytics_behavior_pages_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `analytics:read`
+
+Get top pages by views and unique visitors.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `query.limit` | `integer` | no | Number of pages to return default `50` |
+| `query.write_key` | `string \| null` | no | Comma-separated public keys to filter by |
+| `query.days` | `integer` | no | Number of days to analyze default `30` |
+| `query.date_from` | `string \| null` | no | Anchored window start (YYYY-MM-DD). Must be sent with date_to. |
+| `query.date_to` | `string \| null` | no | Anchored window end (YYYY-MM-DD). Must be sent with date_from. |
+| `headers.X-Org-Id` | `string \| null` | no |  |
+
+**Returns** `AnalyticsResponse`: the envelope `{ data: Record<string, unknown> | Array<unknown>, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `meta` (AnalyticsMeta), `success` (boolean).
+
+**Example**
+
+```ts
+const result = await g8.api.webAnalytics.getTopPages();
+```