@graph8/sdk 0.245.0 → 0.260.0

package/docs/api/webAnalytics.d.ts

@@ -0,0 +1,964 @@
+/* Generated by sdk/js/scripts/generate-agent-docs.ts from developer-contract/openapi.json. Regenerated on every build. */
+
+/**
+ * Types for `g8.api.webAnalytics` (Web Analytics): 38 operations.
+ *
+ * For reading. In code, import from the package instead:
+ *   import type { ApiInput, ApiOutput, G8Contract } from "@graph8/sdk";
+ *   type In = ApiInput<"get_acquisition_campaigns_analytics_acquisition_campaigns_get">;
+ *
+ * Reference with examples: webAnalytics.md
+ */
+/* eslint-disable */
+
+/** `g8.api.webAnalytics.<member>` -> the operationId it calls. */
+export interface WebAnalyticsMembers {
+  getAcquisitionCampaigns: "get_acquisition_campaigns_analytics_acquisition_campaigns_get";
+  getAcquisitionChannels: "get_acquisition_channels_analytics_acquisition_channels_get";
+  getAcquisitionChannelsTrend: "get_acquisition_channels_trend_analytics_acquisition_channels_trend_get";
+  getAcquisitionReferrals: "get_acquisition_referrals_analytics_acquisition_referrals_get";
+  getAcquisitionSearch: "get_acquisition_search_analytics_acquisition_search_get";
+  getAcquisitionSocial: "get_acquisition_social_analytics_acquisition_social_get";
+  getAcquisitionSources: "get_acquisition_sources_analytics_acquisition_sources_get";
+  getAudienceBehavior: "get_audience_behavior_analytics_audience_behavior_get";
+  getAudienceDemographics: "get_audience_demographics_analytics_audience_demographics_get";
+  getAudienceLanguages: "get_audience_languages_analytics_audience_languages_get";
+  getAudienceOverview: "get_audience_overview_analytics_audience_overview_get";
+  getAudienceTrend: "get_audience_trend_analytics_audience_trend_get";
+  getConversionRate: "get_conversion_rate_analytics_conversions_rate_get";
+  getEngagementByCampaign: "get_engagement_by_campaign_analytics_engagement_by_campaign_get";
+  getEngagementByChannel: "get_engagement_by_channel_analytics_engagement_by_channel_get";
+  getEngagementByLandingPage: "get_engagement_by_landing_page_analytics_engagement_by_landing_page_get";
+  getEngagementOverview: "get_engagement_overview_analytics_engagement_overview_get";
+  getEngagementTrend: "get_engagement_trend_analytics_engagement_trend_get";
+  getEvents: "get_events_analytics_behavior_events_get";
+  getExitPages: "get_exit_pages_analytics_behavior_exit_pages_get";
+  getFormAnalysis: "get_form_analysis_analytics_conversions_forms_analysis_get";
+  getForms: "get_forms_analytics_conversions_forms_get";
+  getFormsTrend: "get_forms_trend_analytics_conversions_forms_trend_get";
+  getFunnel: "get_funnel_analytics_conversions_funnel_get";
+  getGeoCities: "get_geo_cities_analytics_audience_geo_cities_get";
+  getGeoCountries: "get_geo_countries_analytics_audience_geo_get";
+  getGoals: "get_goals_analytics_conversions_goals_get";
+  getGoalsTrend: "get_goals_trend_analytics_conversions_goals_trend_get";
+  getLandingPages: "get_landing_pages_analytics_behavior_landing_pages_get";
+  getPageMetrics: "get_page_metrics_analytics_behavior_page_metrics_get";
+  getRealtime: "get_realtime_analytics_realtime_get";
+  getRealtimeLocations: "get_realtime_locations_analytics_realtime_locations_get";
+  getRealtimePages: "get_realtime_pages_analytics_realtime_pages_get";
+  getRealtimeSources: "get_realtime_sources_analytics_realtime_sources_get";
+  getSessionDepthDistribution: "get_session_depth_distribution_analytics_engagement_depth_distribution_get";
+  getTechnologyOverview: "get_technology_overview_analytics_audience_technology_get";
+  getTimeOnSiteDistribution: "get_time_on_site_distribution_analytics_engagement_time_distribution_get";
+  getTopPages: "get_top_pages_analytics_behavior_pages_get";
+}
+
+/** Input and output of every `g8.api.webAnalytics` operation, keyed by operationId. */
+export interface WebAnalyticsOperations {
+  /**
+   * GET /analytics/acquisition/campaigns
+   * Get Acquisition Campaigns
+   * tier: read · scope: analytics:read
+   */
+  get_acquisition_campaigns_analytics_acquisition_campaigns_get: {
+    input: {
+    query?: {
+      /** Number of campaigns to return */
+      limit?: number;
+      /** Comma-separated public keys to filter by */
+      write_key?: string | null;
+      /** Number of days to analyze */
+      days?: number;
+      /** Anchored window start (YYYY-MM-DD). Must be sent with date_to. */
+      date_from?: string | null;
+      /** Anchored window end (YYYY-MM-DD). Must be sent with date_from. */
+      date_to?: string | null;
+    };
+    headers?: {
+      "X-Org-Id"?: string | null;
+    };
+  };
+    output: AnalyticsResponse;
+  };
+  /**
+   * GET /analytics/acquisition/channels
+   * Get Acquisition Channels
+   * tier: read · scope: analytics:read
+   */
+  get_acquisition_channels_analytics_acquisition_channels_get: {
+    input: {
+    query?: {
+      /** Comma-separated public keys to filter by */
+      write_key?: string | null;
+      /** Number of days to analyze */
+      days?: number;
+      /** Anchored window start (YYYY-MM-DD). Must be sent with date_to. */
+      date_from?: string | null;
+      /** Anchored window end (YYYY-MM-DD). Must be sent with date_from. */
+      date_to?: string | null;
+    };
+    headers?: {
+      "X-Org-Id"?: string | null;
+    };
+  };
+    output: AnalyticsResponse;
+  };
+  /**
+   * GET /analytics/acquisition/channels/trend
+   * Get Acquisition Channels Trend
+   * tier: read · scope: analytics:read
+   */
+  get_acquisition_channels_trend_analytics_acquisition_channels_trend_get: {
+    input: {
+    query?: {
+      /** Comma-separated public keys to filter by */
+      write_key?: string | null;
+      /** Number of days to analyze */
+      days?: number;
+      /** Anchored window start (YYYY-MM-DD). Must be sent with date_to. */
+      date_from?: string | null;
+      /** Anchored window end (YYYY-MM-DD). Must be sent with date_from. */
+      date_to?: string | null;
+    };
+    headers?: {
+      "X-Org-Id"?: string | null;
+    };
+  };
+    output: AnalyticsResponse;
+  };
+  /**
+   * GET /analytics/acquisition/referrals
+   * Get Acquisition Referrals
+   * tier: read · scope: analytics:read
+   */
+  get_acquisition_referrals_analytics_acquisition_referrals_get: {
+    input: {
+    query?: {
+      /** Number of referrers to return */
+      limit?: number;
+      /** Comma-separated public keys to filter by */
+      write_key?: string | null;
+      /** Number of days to analyze */
+      days?: number;
+      /** Anchored window start (YYYY-MM-DD). Must be sent with date_to. */
+      date_from?: string | null;
+      /** Anchored window end (YYYY-MM-DD). Must be sent with date_from. */
+      date_to?: string | null;
+    };
+    headers?: {
+      "X-Org-Id"?: string | null;
+    };
+  };
+    output: AnalyticsResponse;
+  };
+  /**
+   * GET /analytics/acquisition/search
+   * Get Acquisition Search
+   * tier: read · scope: analytics:read
+   */
+  get_acquisition_search_analytics_acquisition_search_get: {
+    input: {
+    query?: {
+      /** Comma-separated public keys to filter by */
+      write_key?: string | null;
+      /** Number of days to analyze */
+      days?: number;
+      /** Anchored window start (YYYY-MM-DD). Must be sent with date_to. */
+      date_from?: string | null;
+      /** Anchored window end (YYYY-MM-DD). Must be sent with date_from. */
+      date_to?: string | null;
+    };
+    headers?: {
+      "X-Org-Id"?: string | null;
+    };
+  };
+    output: AnalyticsResponse;
+  };
+  /**
+   * GET /analytics/acquisition/social
+   * Get Acquisition Social
+   * tier: read · scope: analytics:read
+   */
+  get_acquisition_social_analytics_acquisition_social_get: {
+    input: {
+    query?: {
+      /** Comma-separated public keys to filter by */
+      write_key?: string | null;
+      /** Number of days to analyze */
+      days?: number;
+      /** Anchored window start (YYYY-MM-DD). Must be sent with date_to. */
+      date_from?: string | null;
+      /** Anchored window end (YYYY-MM-DD). Must be sent with date_from. */
+      date_to?: string | null;
+    };
+    headers?: {
+      "X-Org-Id"?: string | null;
+    };
+  };
+    output: AnalyticsResponse;
+  };
+  /**
+   * GET /analytics/acquisition/sources
+   * Get Acquisition Sources
+   * tier: read · scope: analytics:read
+   */
+  get_acquisition_sources_analytics_acquisition_sources_get: {
+    input: {
+    query?: {
+      /** Number of sources to return */
+      limit?: number;
+      /** Comma-separated public keys to filter by */
+      write_key?: string | null;
+      /** Number of days to analyze */
+      days?: number;
+      /** Anchored window start (YYYY-MM-DD). Must be sent with date_to. */
+      date_from?: string | null;
+      /** Anchored window end (YYYY-MM-DD). Must be sent with date_from. */
+      date_to?: string | null;
+    };
+    headers?: {
+      "X-Org-Id"?: string | null;
+    };
+  };
+    output: AnalyticsResponse;
+  };
+  /**
+   * GET /analytics/audience/behavior
+   * Get Audience Behavior
+   * tier: read · scope: analytics:read
+   */
+  get_audience_behavior_analytics_audience_behavior_get: {
+    input: {
+    query?: {
+      /** Comma-separated public keys to filter by */
+      write_key?: string | null;
+      /** Number of days to analyze */
+      days?: number;
+      /** Anchored window start (YYYY-MM-DD). Must be sent with date_to. */
+      date_from?: string | null;
+      /** Anchored window end (YYYY-MM-DD). Must be sent with date_from. */
+      date_to?: string | null;
+    };
+    headers?: {
+      "X-Org-Id"?: string | null;
+    };
+  };
+    output: AnalyticsResponse;
+  };
+  /**
+   * GET /analytics/audience/demographics
+   * Get Audience Demographics
+   * tier: read · scope: analytics:read
+   */
+  get_audience_demographics_analytics_audience_demographics_get: {
+    input: {
+    query?: {
+      /** Comma-separated public keys to filter by */
+      write_key?: string | null;
+      /** Number of days to analyze */
+      days?: number;
+      /** Anchored window start (YYYY-MM-DD). Must be sent with date_to. */
+      date_from?: string | null;
+      /** Anchored window end (YYYY-MM-DD). Must be sent with date_from. */
+      date_to?: string | null;
+    };
+    headers?: {
+      "X-Org-Id"?: string | null;
+    };
+  };
+    output: AnalyticsResponse;
+  };
+  /**
+   * GET /analytics/audience/languages
+   * Get Audience Languages
+   * tier: read · scope: analytics:read
+   */
+  get_audience_languages_analytics_audience_languages_get: {
+    input: {
+    query?: {
+      /** Number of languages to return */
+      limit?: number;
+      /** Comma-separated public keys to filter by */
+      write_key?: string | null;
+      /** Number of days to analyze */
+      days?: number;
+      /** Anchored window start (YYYY-MM-DD). Must be sent with date_to. */
+      date_from?: string | null;
+      /** Anchored window end (YYYY-MM-DD). Must be sent with date_from. */
+      date_to?: string | null;
+    };
+    headers?: {
+      "X-Org-Id"?: string | null;
+    };
+  };
+    output: AnalyticsResponse;
+  };
+  /**
+   * GET /analytics/audience/overview
+   * Get Audience Overview
+   * tier: read · scope: analytics:read
+   */
+  get_audience_overview_analytics_audience_overview_get: {
+    input: {
+    query?: {
+      /** Comma-separated public keys to filter by */
+      write_key?: string | null;
+      /** Number of days to analyze */
+      days?: number;
+      /** Anchored window start (YYYY-MM-DD). Must be sent with date_to. */
+      date_from?: string | null;
+      /** Anchored window end (YYYY-MM-DD). Must be sent with date_from. */
+      date_to?: string | null;
+    };
+    headers?: {
+      "X-Org-Id"?: string | null;
+    };
+  };
+    output: AnalyticsResponse;
+  };
+  /**
+   * GET /analytics/audience/trend
+   * Get Audience Trend
+   * tier: read · scope: analytics:read
+   */
+  get_audience_trend_analytics_audience_trend_get: {
+    input: {
+    query?: {
+      /** Comma-separated public keys to filter by */
+      write_key?: string | null;
+      /** Number of days to analyze */
+      days?: number;
+      /** Anchored window start (YYYY-MM-DD). Must be sent with date_to. */
+      date_from?: string | null;
+      /** Anchored window end (YYYY-MM-DD). Must be sent with date_from. */
+      date_to?: string | null;
+    };
+    headers?: {
+      "X-Org-Id"?: string | null;
+    };
+  };
+    output: AnalyticsResponse;
+  };
+  /**
+   * GET /analytics/conversions/rate
+   * Get Conversion Rate
+   * tier: read · scope: analytics:read
+   */
+  get_conversion_rate_analytics_conversions_rate_get: {
+    input: {
+    query?: {
+      /** Comma-separated public keys to filter by */
+      write_key?: string | null;
+      /** Number of days to analyze */
+      days?: number;
+      /** Anchored window start (YYYY-MM-DD). Must be sent with date_to. */
+      date_from?: string | null;
+      /** Anchored window end (YYYY-MM-DD). Must be sent with date_from. */
+      date_to?: string | null;
+    };
+    headers?: {
+      "X-Org-Id"?: string | null;
+    };
+  };
+    output: AnalyticsResponse;
+  };
+  /**
+   * GET /analytics/engagement/by-campaign
+   * Get Engagement By Campaign
+   * tier: read · scope: analytics:read
+   */
+  get_engagement_by_campaign_analytics_engagement_by_campaign_get: {
+    input: {
+    query?: {
+      /** Number of campaigns to return */
+      limit?: number;
+      /** Comma-separated public keys to filter by */
+      write_key?: string | null;
+      /** Number of days to analyze */
+      days?: number;
+      /** Anchored window start (YYYY-MM-DD). Must be sent with date_to. */
+      date_from?: string | null;
+      /** Anchored window end (YYYY-MM-DD). Must be sent with date_from. */
+      date_to?: string | null;
+    };
+    headers?: {
+      "X-Org-Id"?: string | null;
+    };
+  };
+    output: AnalyticsResponse;
+  };
+  /**
+   * GET /analytics/engagement/by-channel
+   * Get Engagement By Channel
+   * tier: read · scope: analytics:read
+   */
+  get_engagement_by_channel_analytics_engagement_by_channel_get: {
+    input: {
+    query?: {
+      /** Comma-separated public keys to filter by */
+      write_key?: string | null;
+      /** Number of days to analyze */
+      days?: number;
+      /** Anchored window start (YYYY-MM-DD). Must be sent with date_to. */
+      date_from?: string | null;
+      /** Anchored window end (YYYY-MM-DD). Must be sent with date_from. */
+      date_to?: string | null;
+    };
+    headers?: {
+      "X-Org-Id"?: string | null;
+    };
+  };
+    output: AnalyticsResponse;
+  };
+  /**
+   * GET /analytics/engagement/by-landing-page
+   * Get Engagement By Landing Page
+   * tier: read · scope: analytics:read
+   */
+  get_engagement_by_landing_page_analytics_engagement_by_landing_page_get: {
+    input: {
+    query?: {
+      /** Number of pages to return */
+      limit?: number;
+      /** Comma-separated public keys to filter by */
+      write_key?: string | null;
+      /** Number of days to analyze */
+      days?: number;
+      /** Anchored window start (YYYY-MM-DD). Must be sent with date_to. */
+      date_from?: string | null;
+      /** Anchored window end (YYYY-MM-DD). Must be sent with date_from. */
+      date_to?: string | null;
+    };
+    headers?: {
+      "X-Org-Id"?: string | null;
+    };
+  };
+    output: AnalyticsResponse;
+  };
+  /**
+   * GET /analytics/engagement/overview
+   * Get Engagement Overview
+   * tier: read · scope: analytics:read
+   */
+  get_engagement_overview_analytics_engagement_overview_get: {
+    input: {
+    query?: {
+      /** Comma-separated public keys to filter by */
+      write_key?: string | null;
+      /** Number of days to analyze */
+      days?: number;
+      /** Anchored window start (YYYY-MM-DD). Must be sent with date_to. */
+      date_from?: string | null;
+      /** Anchored window end (YYYY-MM-DD). Must be sent with date_from. */
+      date_to?: string | null;
+    };
+    headers?: {
+      "X-Org-Id"?: string | null;
+    };
+  };
+    output: AnalyticsResponse;
+  };
+  /**
+   * GET /analytics/engagement/trend
+   * Get Engagement Trend
+   * tier: read · scope: analytics:read
+   */
+  get_engagement_trend_analytics_engagement_trend_get: {
+    input: {
+    query?: {
+      /** Comma-separated public keys to filter by */
+      write_key?: string | null;
+      /** Number of days to analyze */
+      days?: number;
+      /** Anchored window start (YYYY-MM-DD). Must be sent with date_to. */
+      date_from?: string | null;
+      /** Anchored window end (YYYY-MM-DD). Must be sent with date_from. */
+      date_to?: string | null;
+    };
+    headers?: {
+      "X-Org-Id"?: string | null;
+    };
+  };
+    output: AnalyticsResponse;
+  };
+  /**
+   * GET /analytics/behavior/events
+   * Get Events
+   * tier: read · scope: analytics:read
+   */
+  get_events_analytics_behavior_events_get: {
+    input: {
+    query?: {
+      /** Number of events to return */
+      limit?: number;
+      /** Comma-separated public keys to filter by */
+      write_key?: string | null;
+      /** Number of days to analyze */
+      days?: number;
+      /** Anchored window start (YYYY-MM-DD). Must be sent with date_to. */
+      date_from?: string | null;
+      /** Anchored window end (YYYY-MM-DD). Must be sent with date_from. */
+      date_to?: string | null;
+    };
+    headers?: {
+      "X-Org-Id"?: string | null;
+    };
+  };
+    output: AnalyticsResponse;
+  };
+  /**
+   * GET /analytics/behavior/exit-pages
+   * Get Exit Pages
+   * tier: read · scope: analytics:read
+   */
+  get_exit_pages_analytics_behavior_exit_pages_get: {
+    input: {
+    query?: {
+      /** Number of pages to return */
+      limit?: number;
+      /** Comma-separated public keys to filter by */
+      write_key?: string | null;
+      /** Number of days to analyze */
+      days?: number;
+      /** Anchored window start (YYYY-MM-DD). Must be sent with date_to. */
+      date_from?: string | null;
+      /** Anchored window end (YYYY-MM-DD). Must be sent with date_from. */
+      date_to?: string | null;
+    };
+    headers?: {
+      "X-Org-Id"?: string | null;
+    };
+  };
+    output: AnalyticsResponse;
+  };
+  /**
+   * GET /analytics/conversions/forms/analysis
+   * Get Form Analysis
+   * tier: read · scope: analytics:read
+   */
+  get_form_analysis_analytics_conversions_forms_analysis_get: {
+    input: {
+    query?: {
+      /** Number of forms to return */
+      limit?: number;
+      /** Comma-separated public keys to filter by */
+      write_key?: string | null;
+      /** Number of days to analyze */
+      days?: number;
+      /** Anchored window start (YYYY-MM-DD). Must be sent with date_to. */
+      date_from?: string | null;
+      /** Anchored window end (YYYY-MM-DD). Must be sent with date_from. */
+      date_to?: string | null;
+    };
+    headers?: {
+      "X-Org-Id"?: string | null;
+    };
+  };
+    output: AnalyticsResponse;
+  };
+  /**
+   * GET /analytics/conversions/forms
+   * Get Forms
+   * tier: read · scope: analytics:read
+   */
+  get_forms_analytics_conversions_forms_get: {
+    input: {
+    query?: {
+      /** Number of forms to return */
+      limit?: number;
+      /** Comma-separated public keys to filter by */
+      write_key?: string | null;
+      /** Number of days to analyze */
+      days?: number;
+      /** Anchored window start (YYYY-MM-DD). Must be sent with date_to. */
+      date_from?: string | null;
+      /** Anchored window end (YYYY-MM-DD). Must be sent with date_from. */
+      date_to?: string | null;
+    };
+    headers?: {
+      "X-Org-Id"?: string | null;
+    };
+  };
+    output: AnalyticsResponse;
+  };
+  /**
+   * GET /analytics/conversions/forms/trend
+   * Get Forms Trend
+   * tier: read · scope: analytics:read
+   */
+  get_forms_trend_analytics_conversions_forms_trend_get: {
+    input: {
+    query?: {
+      /** Comma-separated public keys to filter by */
+      write_key?: string | null;
+      /** Number of days to analyze */
+      days?: number;
+      /** Anchored window start (YYYY-MM-DD). Must be sent with date_to. */
+      date_from?: string | null;
+      /** Anchored window end (YYYY-MM-DD). Must be sent with date_from. */
+      date_to?: string | null;
+    };
+    headers?: {
+      "X-Org-Id"?: string | null;
+    };
+  };
+    output: AnalyticsResponse;
+  };
+  /**
+   * GET /analytics/conversions/funnel
+   * Get Funnel
+   * tier: read · scope: analytics:read
+   */
+  get_funnel_analytics_conversions_funnel_get: {
+    input: {
+    query?: {
+      /** Comma-separated public keys to filter by */
+      write_key?: string | null;
+      /** Number of days to analyze */
+      days?: number;
+      /** Anchored window start (YYYY-MM-DD). Must be sent with date_to. */
+      date_from?: string | null;
+      /** Anchored window end (YYYY-MM-DD). Must be sent with date_from. */
+      date_to?: string | null;
+    };
+    headers?: {
+      "X-Org-Id"?: string | null;
+    };
+  };
+    output: AnalyticsResponse;
+  };
+  /**
+   * GET /analytics/audience/geo/cities
+   * Get Geo Cities
+   * tier: read · scope: analytics:read
+   */
+  get_geo_cities_analytics_audience_geo_cities_get: {
+    input: {
+    query?: {
+      /** Number of cities to return */
+      limit?: number;
+      /** Comma-separated public keys to filter by */
+      write_key?: string | null;
+      /** Number of days to analyze */
+      days?: number;
+      /** Anchored window start (YYYY-MM-DD). Must be sent with date_to. */
+      date_from?: string | null;
+      /** Anchored window end (YYYY-MM-DD). Must be sent with date_from. */
+      date_to?: string | null;
+    };
+    headers?: {
+      "X-Org-Id"?: string | null;
+    };
+  };
+    output: AnalyticsResponse;
+  };
+  /**
+   * GET /analytics/audience/geo
+   * Get Geo Countries
+   * tier: read · scope: analytics:read
+   */
+  get_geo_countries_analytics_audience_geo_get: {
+    input: {
+    query?: {
+      /** Number of countries to return */
+      limit?: number;
+      /** Comma-separated public keys to filter by */
+      write_key?: string | null;
+      /** Number of days to analyze */
+      days?: number;
+      /** Anchored window start (YYYY-MM-DD). Must be sent with date_to. */
+      date_from?: string | null;
+      /** Anchored window end (YYYY-MM-DD). Must be sent with date_from. */
+      date_to?: string | null;
+    };
+    headers?: {
+      "X-Org-Id"?: string | null;
+    };
+  };
+    output: AnalyticsResponse;
+  };
+  /**
+   * GET /analytics/conversions/goals
+   * Get Goals
+   * tier: read · scope: analytics:read
+   */
+  get_goals_analytics_conversions_goals_get: {
+    input: {
+    query?: {
+      /** Comma-separated public keys to filter by */
+      write_key?: string | null;
+      /** Number of days to analyze */
+      days?: number;
+      /** Anchored window start (YYYY-MM-DD). Must be sent with date_to. */
+      date_from?: string | null;
+      /** Anchored window end (YYYY-MM-DD). Must be sent with date_from. */
+      date_to?: string | null;
+    };
+    headers?: {
+      "X-Org-Id"?: string | null;
+    };
+  };
+    output: AnalyticsResponse;
+  };
+  /**
+   * GET /analytics/conversions/goals/trend
+   * Get Goals Trend
+   * tier: read · scope: analytics:read
+   */
+  get_goals_trend_analytics_conversions_goals_trend_get: {
+    input: {
+    query?: {
+      /** Comma-separated public keys to filter by */
+      write_key?: string | null;
+      /** Number of days to analyze */
+      days?: number;
+      /** Anchored window start (YYYY-MM-DD). Must be sent with date_to. */
+      date_from?: string | null;
+      /** Anchored window end (YYYY-MM-DD). Must be sent with date_from. */
+      date_to?: string | null;
+    };
+    headers?: {
+      "X-Org-Id"?: string | null;
+    };
+  };
+    output: AnalyticsResponse;
+  };
+  /**
+   * GET /analytics/behavior/landing-pages
+   * Get Landing Pages
+   * tier: read · scope: analytics:read
+   */
+  get_landing_pages_analytics_behavior_landing_pages_get: {
+    input: {
+    query?: {
+      /** Number of pages to return */
+      limit?: number;
+      /** Comma-separated public keys to filter by */
+      write_key?: string | null;
+      /** Number of days to analyze */
+      days?: number;
+      /** Anchored window start (YYYY-MM-DD). Must be sent with date_to. */
+      date_from?: string | null;
+      /** Anchored window end (YYYY-MM-DD). Must be sent with date_from. */
+      date_to?: string | null;
+    };
+    headers?: {
+      "X-Org-Id"?: string | null;
+    };
+  };
+    output: AnalyticsResponse;
+  };
+  /**
+   * GET /analytics/behavior/page-metrics
+   * Get Page Metrics
+   * tier: read · scope: analytics:read
+   */
+  get_page_metrics_analytics_behavior_page_metrics_get: {
+    input: {
+    query: {
+      /** Exact context_page_path to roll up */
+      path: string;
+      /** Comma-separated public keys to filter by */
+      write_key?: string | null;
+      /** Number of days to analyze */
+      days?: number;
+      /** Anchored window start (YYYY-MM-DD). Must be sent with date_to. */
+      date_from?: string | null;
+      /** Anchored window end (YYYY-MM-DD). Must be sent with date_from. */
+      date_to?: string | null;
+    };
+    headers?: {
+      "X-Org-Id"?: string | null;
+    };
+  };
+    output: AnalyticsResponse;
+  };
+  /**
+   * GET /analytics/realtime
+   * Get Realtime
+   * tier: read · scope: analytics:read
+   */
+  get_realtime_analytics_realtime_get: {
+    input: {
+    query?: {
+      /** Comma-separated public keys to filter by */
+      write_key?: string | null;
+    };
+    headers?: {
+      "X-Org-Id"?: string | null;
+    };
+  };
+    output: AnalyticsResponse;
+  };
+  /**
+   * GET /analytics/realtime/locations
+   * Get Realtime Locations
+   * tier: read · scope: analytics:read
+   */
+  get_realtime_locations_analytics_realtime_locations_get: {
+    input: {
+    query?: {
+      /** Number of locations to return */
+      limit?: number | null;
+      /** Comma-separated public keys to filter by */
+      write_key?: string | null;
+    };
+    headers?: {
+      "X-Org-Id"?: string | null;
+    };
+  };
+    output: AnalyticsResponse;
+  };
+  /**
+   * GET /analytics/realtime/pages
+   * Get Realtime Pages
+   * tier: read · scope: analytics:read
+   */
+  get_realtime_pages_analytics_realtime_pages_get: {
+    input: {
+    query?: {
+      /** Number of pages to return */
+      limit?: number;
+      /** Comma-separated public keys to filter by */
+      write_key?: string | null;
+    };
+    headers?: {
+      "X-Org-Id"?: string | null;
+    };
+  };
+    output: AnalyticsResponse;
+  };
+  /**
+   * GET /analytics/realtime/sources
+   * Get Realtime Sources
+   * tier: read · scope: analytics:read
+   */
+  get_realtime_sources_analytics_realtime_sources_get: {
+    input: {
+    query?: {
+      /** Number of sources to return */
+      limit?: number;
+      /** Comma-separated public keys to filter by */
+      write_key?: string | null;
+    };
+    headers?: {
+      "X-Org-Id"?: string | null;
+    };
+  };
+    output: AnalyticsResponse;
+  };
+  /**
+   * GET /analytics/engagement/depth-distribution
+   * Get Session Depth Distribution
+   * tier: read · scope: analytics:read
+   */
+  get_session_depth_distribution_analytics_engagement_depth_distribution_get: {
+    input: {
+    query?: {
+      /** Comma-separated public keys to filter by */
+      write_key?: string | null;
+      /** Number of days to analyze */
+      days?: number;
+      /** Anchored window start (YYYY-MM-DD). Must be sent with date_to. */
+      date_from?: string | null;
+      /** Anchored window end (YYYY-MM-DD). Must be sent with date_from. */
+      date_to?: string | null;
+    };
+    headers?: {
+      "X-Org-Id"?: string | null;
+    };
+  };
+    output: AnalyticsResponse;
+  };
+  /**
+   * GET /analytics/audience/technology
+   * Get Technology Overview
+   * tier: read · scope: analytics:read
+   */
+  get_technology_overview_analytics_audience_technology_get: {
+    input: {
+    query?: {
+      /** Comma-separated public keys to filter by */
+      write_key?: string | null;
+      /** Number of days to analyze */
+      days?: number;
+      /** Anchored window start (YYYY-MM-DD). Must be sent with date_to. */
+      date_from?: string | null;
+      /** Anchored window end (YYYY-MM-DD). Must be sent with date_from. */
+      date_to?: string | null;
+    };
+    headers?: {
+      "X-Org-Id"?: string | null;
+    };
+  };
+    output: AnalyticsResponse;
+  };
+  /**
+   * GET /analytics/engagement/time-distribution
+   * Get Time On Site Distribution
+   * tier: read · scope: analytics:read
+   */
+  get_time_on_site_distribution_analytics_engagement_time_distribution_get: {
+    input: {
+    query?: {
+      /** Comma-separated public keys to filter by */
+      write_key?: string | null;
+      /** Number of days to analyze */
+      days?: number;
+      /** Anchored window start (YYYY-MM-DD). Must be sent with date_to. */
+      date_from?: string | null;
+      /** Anchored window end (YYYY-MM-DD). Must be sent with date_from. */
+      date_to?: string | null;
+    };
+    headers?: {
+      "X-Org-Id"?: string | null;
+    };
+  };
+    output: AnalyticsResponse;
+  };
+  /**
+   * GET /analytics/behavior/pages
+   * Get Top Pages
+   * tier: read · scope: analytics:read
+   */
+  get_top_pages_analytics_behavior_pages_get: {
+    input: {
+    query?: {
+      /** Number of pages to return */
+      limit?: number;
+      /** Comma-separated public keys to filter by */
+      write_key?: string | null;
+      /** Number of days to analyze */
+      days?: number;
+      /** Anchored window start (YYYY-MM-DD). Must be sent with date_to. */
+      date_from?: string | null;
+      /** Anchored window end (YYYY-MM-DD). Must be sent with date_from. */
+      date_to?: string | null;
+    };
+    headers?: {
+      "X-Org-Id"?: string | null;
+    };
+  };
+    output: AnalyticsResponse;
+  };
+}
+
+// 2 schemas referenced above (the same as G8Contract.<Name>).
+
+/** Metadata for analytics responses. */
+export interface AnalyticsMeta {
+  cache_ttl?: number;
+  cached: boolean;
+  days: number;
+  org_id: string;
+  query_time_ms?: number | null;
+  stale?: boolean;
+  timestamp: string;
+}
+
+/** Standard analytics response wrapper. */
+export interface AnalyticsResponse {
+  data: Record<string, unknown> | Array<unknown>;
+  meta: AnalyticsMeta;
+  success?: boolean;
+}