@seekora-ai/admin-api 1.0.48 → 1.0.50

package/dist/esm/api.d.ts

@@ -357,6 +357,49 @@ export interface AdminAnalyticsStoreXStoreIDItemsDiscoveryGet200Response {
      */
     'total'?: number;
 }
+/**
+ *
+ * @export
+ * @interface AdminAnalyticsStoreXStoreIDItemsItemIdInsightsGet200Response
+ */
+export interface AdminAnalyticsStoreXStoreIDItemsItemIdInsightsGet200Response {
+    /**
+     * Comparison metadata when in compare mode
+     * @type {AnalyticsComparisonMeta}
+     * @memberof AdminAnalyticsStoreXStoreIDItemsItemIdInsightsGet200Response
+     */
+    'comparison'?: AnalyticsComparisonMeta;
+    /**
+     *
+     * @type {AnalyticsItemInsights}
+     * @memberof AdminAnalyticsStoreXStoreIDItemsItemIdInsightsGet200Response
+     */
+    'data'?: AnalyticsItemInsights;
+    /**
+     *
+     * @type {string}
+     * @memberof AdminAnalyticsStoreXStoreIDItemsItemIdInsightsGet200Response
+     */
+    'error'?: string;
+    /**
+     *
+     * @type {string}
+     * @memberof AdminAnalyticsStoreXStoreIDItemsItemIdInsightsGet200Response
+     */
+    'status'?: string;
+    /**
+     *
+     * @type {string}
+     * @memberof AdminAnalyticsStoreXStoreIDItemsItemIdInsightsGet200Response
+     */
+    'timestamp'?: string;
+    /**
+     *
+     * @type {number}
+     * @memberof AdminAnalyticsStoreXStoreIDItemsItemIdInsightsGet200Response
+     */
+    'total'?: number;
+}
 /**
  *
  * @export
@@ -1066,11 +1109,11 @@ export interface AnalyticsExtendedKPIResponse {
      */
     'compare_summary'?: AnalyticsKPIMetrics;
     /**
-     *
-     * @type {Array<AnalyticsKPIPointExtended>}
+     * Can be []KPIPointExtended or []ComparisonMetrics
+     * @type {object}
      * @memberof AnalyticsExtendedKPIResponse
      */
-    'data'?: Array<AnalyticsKPIPointExtended>;
+    'data'?: object;
     /**
      *
      * @type {string}
@@ -1138,12 +1181,24 @@ export interface AnalyticsFilterAnalyticsResponse {
      * @memberof AnalyticsFilterAnalyticsResponse
      */
     'filter_key'?: string;
+    /**
+     *
+     * @type {number}
+     * @memberof AnalyticsFilterAnalyticsResponse
+     */
+    'limit'?: number;
     /**
      *
      * @type {string}
      * @memberof AnalyticsFilterAnalyticsResponse
      */
     'org_id'?: string;
+    /**
+     *
+     * @type {number}
+     * @memberof AnalyticsFilterAnalyticsResponse
+     */
+    'page'?: number;
     /**
      *
      * @type {string}
@@ -1174,6 +1229,12 @@ export interface AnalyticsFilterAnalyticsResponse {
      * @memberof AnalyticsFilterAnalyticsResponse
      */
     'store_id'?: string;
+    /**
+     *
+     * @type {number}
+     * @memberof AnalyticsFilterAnalyticsResponse
+     */
+    'total'?: number;
 }
 /**
  *
@@ -1409,12 +1470,24 @@ export interface AnalyticsFilterTrendsResponse {
      * @memberof AnalyticsFilterTrendsResponse
      */
     'granularity'?: string;
+    /**
+     *
+     * @type {number}
+     * @memberof AnalyticsFilterTrendsResponse
+     */
+    'limit'?: number;
     /**
      *
      * @type {string}
      * @memberof AnalyticsFilterTrendsResponse
      */
     'org_id'?: string;
+    /**
+     *
+     * @type {number}
+     * @memberof AnalyticsFilterTrendsResponse
+     */
+    'page'?: number;
     /**
      *
      * @type {string}
@@ -1445,6 +1518,12 @@ export interface AnalyticsFilterTrendsResponse {
      * @memberof AnalyticsFilterTrendsResponse
      */
     'top_filters'?: number;
+    /**
+     *
+     * @type {number}
+     * @memberof AnalyticsFilterTrendsResponse
+     */
+    'total'?: number;
     /**
      *
      * @type {{ [key: string]: Array<AnalyticsTimeSeriesPoint>; }}
@@ -1881,6 +1960,86 @@ export interface AnalyticsItemComparisonAnalyticsComparisonMetrics {
      */
     'worst_performer'?: string;
 }
+/**
+ *
+ * @export
+ * @interface AnalyticsItemCompetitor
+ */
+export interface AnalyticsItemCompetitor {
+    /**
+     *
+     * @type {number}
+     * @memberof AnalyticsItemCompetitor
+     */
+    'avg_position'?: number;
+    /**
+     *
+     * @type {number}
+     * @memberof AnalyticsItemCompetitor
+     */
+    'competition_score'?: number;
+    /**
+     *
+     * @type {string}
+     * @memberof AnalyticsItemCompetitor
+     */
+    'item_id'?: string;
+    /**
+     *
+     * @type {string}
+     * @memberof AnalyticsItemCompetitor
+     */
+    'item_name'?: string;
+    /**
+     * percentage of shared context
+     * @type {number}
+     * @memberof AnalyticsItemCompetitor
+     */
+    'overlap'?: number;
+    /**
+     *
+     * @type {number}
+     * @memberof AnalyticsItemCompetitor
+     */
+    'shared_filters'?: number;
+    /**
+     *
+     * @type {number}
+     * @memberof AnalyticsItemCompetitor
+     */
+    'shared_queries'?: number;
+}
+/**
+ *
+ * @export
+ * @interface AnalyticsItemCompetitorAnalysis
+ */
+export interface AnalyticsItemCompetitorAnalysis {
+    /**
+     *
+     * @type {Array<AnalyticsItemCompetitor>}
+     * @memberof AnalyticsItemCompetitorAnalysis
+     */
+    'competing_items'?: Array<AnalyticsItemCompetitor>;
+    /**
+     *
+     * @type {number}
+     * @memberof AnalyticsItemCompetitorAnalysis
+     */
+    'market_share'?: number;
+    /**
+     * average position relative to competitors
+     * @type {number}
+     * @memberof AnalyticsItemCompetitorAnalysis
+     */
+    'position_advantage'?: number;
+    /**
+     *
+     * @type {Array<AnalyticsSharedQueryAnalysis>}
+     * @memberof AnalyticsItemCompetitorAnalysis
+     */
+    'shared_queries'?: Array<AnalyticsSharedQueryAnalysis>;
+}
 /**
  *
  * @export
@@ -1961,6 +2120,207 @@ export interface AnalyticsItemDiscoveryAnalytics {
      */
     'total_impressions'?: number;
 }
+/**
+ *
+ * @export
+ * @interface AnalyticsItemGeoAnalytic
+ */
+export interface AnalyticsItemGeoAnalytic {
+    /**
+     *
+     * @type {number}
+     * @memberof AnalyticsItemGeoAnalytic
+     */
+    'avg_position'?: number;
+    /**
+     *
+     * @type {string}
+     * @memberof AnalyticsItemGeoAnalytic
+     */
+    'city'?: string;
+    /**
+     *
+     * @type {number}
+     * @memberof AnalyticsItemGeoAnalytic
+     */
+    'click_through_rate'?: number;
+    /**
+     *
+     * @type {number}
+     * @memberof AnalyticsItemGeoAnalytic
+     */
+    'clicks'?: number;
+    /**
+     *
+     * @type {string}
+     * @memberof AnalyticsItemGeoAnalytic
+     */
+    'country'?: string;
+    /**
+     *
+     * @type {string}
+     * @memberof AnalyticsItemGeoAnalytic
+     */
+    'country_code'?: string;
+    /**
+     *
+     * @type {number}
+     * @memberof AnalyticsItemGeoAnalytic
+     */
+    'impressions'?: number;
+    /**
+     *
+     * @type {string}
+     * @memberof AnalyticsItemGeoAnalytic
+     */
+    'region'?: string;
+    /**
+     * percentage of total impressions for this item
+     * @type {number}
+     * @memberof AnalyticsItemGeoAnalytic
+     */
+    'share'?: number;
+    /**
+     *
+     * @type {number}
+     * @memberof AnalyticsItemGeoAnalytic
+     */
+    'unique_users'?: number;
+}
+/**
+ *
+ * @export
+ * @interface AnalyticsItemGeoAnalyticsSection
+ */
+export interface AnalyticsItemGeoAnalyticsSection {
+    /**
+     *
+     * @type {Array<AnalyticsItemGeoAnalytic>}
+     * @memberof AnalyticsItemGeoAnalyticsSection
+     */
+    'items'?: Array<AnalyticsItemGeoAnalytic>;
+    /**
+     *
+     * @type {AnalyticsPaginationMeta}
+     * @memberof AnalyticsItemGeoAnalyticsSection
+     */
+    'meta'?: AnalyticsPaginationMeta;
+}
+/**
+ *
+ * @export
+ * @interface AnalyticsItemInsights
+ */
+export interface AnalyticsItemInsights {
+    /**
+     *
+     * @type {number}
+     * @memberof AnalyticsItemInsights
+     */
+    'avg_position'?: number;
+    /**
+     *
+     * @type {number}
+     * @memberof AnalyticsItemInsights
+     */
+    'click_through_rate'?: number;
+    /**
+     *
+     * @type {AnalyticsItemCompetitorAnalysis}
+     * @memberof AnalyticsItemInsights
+     */
+    'competitor_analysis'?: AnalyticsItemCompetitorAnalysis;
+    /**
+     *
+     * @type {number}
+     * @memberof AnalyticsItemInsights
+     */
+    'conversion_rate'?: number;
+    /**
+     *
+     * @type {number}
+     * @memberof AnalyticsItemInsights
+     */
+    'discovery_score'?: number;
+    /**
+     *
+     * @type {AnalyticsItemGeoAnalyticsSection}
+     * @memberof AnalyticsItemInsights
+     */
+    'geo_analytics'?: AnalyticsItemGeoAnalyticsSection;
+    /**
+     *
+     * @type {string}
+     * @memberof AnalyticsItemInsights
+     */
+    'item_id'?: string;
+    /**
+     *
+     * @type {string}
+     * @memberof AnalyticsItemInsights
+     */
+    'item_name'?: string;
+    /**
+     *
+     * @type {string}
+     * @memberof AnalyticsItemInsights
+     */
+    'last_seen'?: string;
+    /**
+     *
+     * @type {Array<AnalyticsItemTrendData>}
+     * @memberof AnalyticsItemInsights
+     */
+    'performance_trends'?: Array<AnalyticsItemTrendData>;
+    /**
+     *
+     * @type {AnalyticsItemPopularFiltersSection}
+     * @memberof AnalyticsItemInsights
+     */
+    'popular_filters'?: AnalyticsItemPopularFiltersSection;
+    /**
+     *
+     * @type {AnalyticsItemPopularQueriesSection}
+     * @memberof AnalyticsItemInsights
+     */
+    'popular_queries'?: AnalyticsItemPopularQueriesSection;
+    /**
+     *
+     * @type {Array<AnalyticsItemPositionBucket>}
+     * @memberof AnalyticsItemInsights
+     */
+    'position_distribution'?: Array<AnalyticsItemPositionBucket>;
+    /**
+     *
+     * @type {number}
+     * @memberof AnalyticsItemInsights
+     */
+    'top_10_impression_rate'?: number;
+    /**
+     *
+     * @type {number}
+     * @memberof AnalyticsItemInsights
+     */
+    'top_3_impression_rate'?: number;
+    /**
+     *
+     * @type {number}
+     * @memberof AnalyticsItemInsights
+     */
+    'total_impressions'?: number;
+    /**
+     *
+     * @type {number}
+     * @memberof AnalyticsItemInsights
+     */
+    'unique_searches'?: number;
+    /**
+     *
+     * @type {number}
+     * @memberof AnalyticsItemInsights
+     */
+    'unique_users'?: number;
+}
 /**
  *
  * @export
@@ -2234,6 +2594,161 @@ export interface AnalyticsItemPerformanceWithWidget {
      */
     'widget'?: AnalyticsWidgetData;
 }
+/**
+ *
+ * @export
+ * @interface AnalyticsItemPopularFilter
+ */
+export interface AnalyticsItemPopularFilter {
+    /**
+     *
+     * @type {number}
+     * @memberof AnalyticsItemPopularFilter
+     */
+    'avg_position'?: number;
+    /**
+     *
+     * @type {string}
+     * @memberof AnalyticsItemPopularFilter
+     */
+    'filter_key'?: string;
+    /**
+     *
+     * @type {string}
+     * @memberof AnalyticsItemPopularFilter
+     */
+    'filter_value'?: string;
+    /**
+     *
+     * @type {number}
+     * @memberof AnalyticsItemPopularFilter
+     */
+    'impressions'?: number;
+    /**
+     * percentage of impressions for this item
+     * @type {number}
+     * @memberof AnalyticsItemPopularFilter
+     */
+    'share'?: number;
+}
+/**
+ *
+ * @export
+ * @interface AnalyticsItemPopularFiltersSection
+ */
+export interface AnalyticsItemPopularFiltersSection {
+    /**
+     *
+     * @type {Array<AnalyticsItemPopularFilter>}
+     * @memberof AnalyticsItemPopularFiltersSection
+     */
+    'items'?: Array<AnalyticsItemPopularFilter>;
+    /**
+     *
+     * @type {AnalyticsPaginationMeta}
+     * @memberof AnalyticsItemPopularFiltersSection
+     */
+    'meta'?: AnalyticsPaginationMeta;
+}
+/**
+ *
+ * @export
+ * @interface AnalyticsItemPopularQueriesSection
+ */
+export interface AnalyticsItemPopularQueriesSection {
+    /**
+     *
+     * @type {Array<AnalyticsItemPopularQuery>}
+     * @memberof AnalyticsItemPopularQueriesSection
+     */
+    'items'?: Array<AnalyticsItemPopularQuery>;
+    /**
+     *
+     * @type {AnalyticsPaginationMeta}
+     * @memberof AnalyticsItemPopularQueriesSection
+     */
+    'meta'?: AnalyticsPaginationMeta;
+}
+/**
+ *
+ * @export
+ * @interface AnalyticsItemPopularQuery
+ */
+export interface AnalyticsItemPopularQuery {
+    /**
+     *
+     * @type {number}
+     * @memberof AnalyticsItemPopularQuery
+     */
+    'avg_position'?: number;
+    /**
+     *
+     * @type {number}
+     * @memberof AnalyticsItemPopularQuery
+     */
+    'click_through_rate'?: number;
+    /**
+     *
+     * @type {number}
+     * @memberof AnalyticsItemPopularQuery
+     */
+    'clicks'?: number;
+    /**
+     *
+     * @type {number}
+     * @memberof AnalyticsItemPopularQuery
+     */
+    'impressions'?: number;
+    /**
+     *
+     * @type {string}
+     * @memberof AnalyticsItemPopularQuery
+     */
+    'query'?: string;
+    /**
+     * percentage of total impressions for this item
+     * @type {number}
+     * @memberof AnalyticsItemPopularQuery
+     */
+    'share'?: number;
+}
+/**
+ *
+ * @export
+ * @interface AnalyticsItemPositionBucket
+ */
+export interface AnalyticsItemPositionBucket {
+    /**
+     *
+     * @type {number}
+     * @memberof AnalyticsItemPositionBucket
+     */
+    'click_rate'?: number;
+    /**
+     *
+     * @type {number}
+     * @memberof AnalyticsItemPositionBucket
+     */
+    'clicks'?: number;
+    /**
+     *
+     * @type {number}
+     * @memberof AnalyticsItemPositionBucket
+     */
+    'impressions'?: number;
+    /**
+     * \"1\", \"2\", \"3\", \"4-5\", \"6-10\", \"11-20\", \"21+\"
+     * @type {string}
+     * @memberof AnalyticsItemPositionBucket
+     */
+    'position_range'?: string;
+    /**
+     * percentage of total impressions for this item
+     * @type {number}
+     * @memberof AnalyticsItemPositionBucket
+     */
+    'share'?: number;
+}
 /**
  *
  * @export
@@ -2798,6 +3313,86 @@ export interface AnalyticsQueryFilterUsage {
      */
     'unique_searches'?: number;
 }
+/**
+ *
+ * @export
+ * @interface AnalyticsQueryGeoAnalytic
+ */
+export interface AnalyticsQueryGeoAnalytic {
+    /**
+     *
+     * @type {string}
+     * @memberof AnalyticsQueryGeoAnalytic
+     */
+    'city'?: string;
+    /**
+     *
+     * @type {number}
+     * @memberof AnalyticsQueryGeoAnalytic
+     */
+    'click_through_rate'?: number;
+    /**
+     *
+     * @type {number}
+     * @memberof AnalyticsQueryGeoAnalytic
+     */
+    'clicks'?: number;
+    /**
+     *
+     * @type {string}
+     * @memberof AnalyticsQueryGeoAnalytic
+     */
+    'country'?: string;
+    /**
+     *
+     * @type {string}
+     * @memberof AnalyticsQueryGeoAnalytic
+     */
+    'country_code'?: string;
+    /**
+     *
+     * @type {string}
+     * @memberof AnalyticsQueryGeoAnalytic
+     */
+    'region'?: string;
+    /**
+     *
+     * @type {number}
+     * @memberof AnalyticsQueryGeoAnalytic
+     */
+    'searches'?: number;
+    /**
+     * percentage of total searches for this query
+     * @type {number}
+     * @memberof AnalyticsQueryGeoAnalytic
+     */
+    'share'?: number;
+    /**
+     *
+     * @type {number}
+     * @memberof AnalyticsQueryGeoAnalytic
+     */
+    'unique_users'?: number;
+}
+/**
+ *
+ * @export
+ * @interface AnalyticsQueryGeoAnalyticsSection
+ */
+export interface AnalyticsQueryGeoAnalyticsSection {
+    /**
+     *
+     * @type {Array<AnalyticsQueryGeoAnalytic>}
+     * @memberof AnalyticsQueryGeoAnalyticsSection
+     */
+    'items'?: Array<AnalyticsQueryGeoAnalytic>;
+    /**
+     *
+     * @type {AnalyticsPaginationMeta}
+     * @memberof AnalyticsQueryGeoAnalyticsSection
+     */
+    'meta'?: AnalyticsPaginationMeta;
+}
 /**
  *
  * @export
@@ -2834,6 +3429,12 @@ export interface AnalyticsQueryInsights {
      * @memberof AnalyticsQueryInsights
      */
     'filter_analytics'?: AnalyticsQueryFilterAnalytics;
+    /**
+     *
+     * @type {AnalyticsQueryGeoAnalyticsSection}
+     * @memberof AnalyticsQueryInsights
+     */
+    'geo_analytics'?: AnalyticsQueryGeoAnalyticsSection;
     /**
      *
      * @type {string}
@@ -3183,6 +3784,49 @@ export interface AnalyticsQueryResponse {
      */
     'total'?: number;
 }
+/**
+ *
+ * @export
+ * @interface AnalyticsSharedQueryAnalysis
+ */
+export interface AnalyticsSharedQueryAnalysis {
+    /**
+     *
+     * @type {string}
+     * @memberof AnalyticsSharedQueryAnalysis
+     */
+    'competitor_id'?: string;
+    /**
+     *
+     * @type {number}
+     * @memberof AnalyticsSharedQueryAnalysis
+     */
+    'competitor_position'?: number;
+    /**
+     *
+     * @type {number}
+     * @memberof AnalyticsSharedQueryAnalysis
+     */
+    'impressions'?: number;
+    /**
+     *
+     * @type {number}
+     * @memberof AnalyticsSharedQueryAnalysis
+     */
+    'position_advantage'?: number;
+    /**
+     *
+     * @type {string}
+     * @memberof AnalyticsSharedQueryAnalysis
+     */
+    'query'?: string;
+    /**
+     *
+     * @type {number}
+     * @memberof AnalyticsSharedQueryAnalysis
+     */
+    'this_item_position'?: number;
+}
 /**
  *
  * @export
@@ -6015,11 +6659,17 @@ export interface DataTypesErrorMetaResponse {
  */
 export interface DataTypesEventPayload {
     /**
-     *
+     * Journey Tracking & Analytics
      * @type {Array<string>}
      * @memberof DataTypesEventPayload
      */
     'analytics_tags'?: Array<string>;
+    /**
+     * Anonymous user identifier
+     * @type {string}
+     * @memberof DataTypesEventPayload
+     */
+    'anon_id'?: string;
     /**
      *
      * @type {string}
@@ -6027,13 +6677,13 @@ export interface DataTypesEventPayload {
      */
     'city'?: string;
     /**
-     *
+     * Click/Interaction Event Fields
      * @type {string}
      * @memberof DataTypesEventPayload
      */
     'clicked_product_id'?: string;
     /**
-     * Geo data fields for direct submission
+     * Enhanced Geo data fields for direct submission
      * @type {string}
      * @memberof DataTypesEventPayload
      */
@@ -6044,6 +6694,12 @@ export interface DataTypesEventPayload {
      * @memberof DataTypesEventPayload
      */
     'country_code'?: string;
+    /**
+     * Currency for value
+     * @type {string}
+     * @memberof DataTypesEventPayload
+     */
+    'currency'?: string;
     /**
      *
      * @type {string}
@@ -6051,7 +6707,7 @@ export interface DataTypesEventPayload {
      */
     'device_type'?: string;
     /**
-     *
+     * Core Event Information
      * @type {string}
      * @memberof DataTypesEventPayload
      */
@@ -6063,25 +6719,25 @@ export interface DataTypesEventPayload {
      */
     'event_name'?: string;
     /**
-     *
+     * Device & Location Context
      * @type {string}
      * @memberof DataTypesEventPayload
      */
     'ip'?: string;
     /**
-     *
+     * Performance
      * @type {number}
      * @memberof DataTypesEventPayload
      */
     'latency_ms'?: number;
     /**
-     *
+     * Legacy field
      * @type {string}
      * @memberof DataTypesEventPayload
      */
     'location'?: string;
     /**
-     *
+     * Flexible metadata including search_id, position, etc.
      * @type {{ [key: string]: any; }}
      * @memberof DataTypesEventPayload
      */
@@ -6095,7 +6751,13 @@ export interface DataTypesEventPayload {
      */
     'org_id'?: string;
     /**
-     *
+     * web, ios, android
+     * @type {string}
+     * @memberof DataTypesEventPayload
+     */
+    'platform'?: string;
+    /**
+     * Search Event Fields
      * @type {string}
      * @memberof DataTypesEventPayload
      */
@@ -6113,7 +6775,13 @@ export interface DataTypesEventPayload {
      */
     'results_count'?: number;
     /**
-     *
+     * Session identifier for journey tracking
+     * @type {string}
+     * @memberof DataTypesEventPayload
+     */
+    'session_id'?: string;
+    /**
+     * Organization Context
      * @type {string}
      * @memberof DataTypesEventPayload
      */
@@ -6125,11 +6793,17 @@ export interface DataTypesEventPayload {
      */
     'timestamp'?: string;
     /**
-     *
+     * User Context
      * @type {string}
      * @memberof DataTypesEventPayload
      */
     'user_id'?: string;
+    /**
+     * Business Context
+     * @type {number}
+     * @memberof DataTypesEventPayload
+     */
+    'value'?: number;
 }
 /**
  *
@@ -13191,21 +13865,31 @@ export declare const AnalyticsApiAxiosParamCreator: (configuration?: Configurati
      */
     adminAnalyticsStoreXStoreIDQueriesNoResultsGet: (xStoreID: string, startTime?: string, endTime?: string, search?: string, analyticsTags?: string, tagsMatchMode?: AdminAnalyticsStoreXStoreIDQueriesNoResultsGetTagsMatchModeEnum, tagsExclude?: string, tagKeyFilter?: string, tagValueFilter?: string, compareMode?: boolean, compareStartTime?: string, compareEndTime?: string, compareAnalyticsTags?: string, compareTagsMatchMode?: AdminAnalyticsStoreXStoreIDQueriesNoResultsGetCompareTagsMatchModeEnum, compareTagsExclude?: string, compareTagKeyFilter?: string, compareTagValueFilter?: string, limit?: number, offset?: number, page?: number, pageSize?: number, sortBy?: AdminAnalyticsStoreXStoreIDQueriesNoResultsGetSortByEnum, sortOrder?: AdminAnalyticsStoreXStoreIDQueriesNoResultsGetSortOrderEnum, sort?: string, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
     /**
-     * Retrieve comprehensive analytics for a specific search query including popular results, filters, click position histogram, and performance metrics with independent pagination for popular results and filters
+     * Retrieve comprehensive analytics for a specific search query including popular results, filters, click position histogram, geo analytics, and performance metrics with deep comparison mode support and independent pagination for popular results and filters
      * @summary Get Query Insights
      * @param {string} xStoreID Store ID
      * @param {string} query Search query to analyze
      * @param {string} [startTime] Start time in RFC3339 format
      * @param {string} [endTime] End time in RFC3339 format
+     * @param {boolean} [compareMode] Enable comparison mode to compare with another time period/tag set
+     * @param {string} [compareStartTime] Comparison period start time in RFC3339 format
+     * @param {string} [compareEndTime] Comparison period end time in RFC3339 format
+     * @param {string} [compareAnalyticsTags] Comma-separated analytics tags for comparison period
+     * @param {AdminAnalyticsStoreXStoreIDQueriesQueryInsightsGetCompareTagsMatchModeEnum} [compareTagsMatchMode] How to match comparison analytics tags
+     * @param {string} [compareTagsExclude] Comma-separated analytics tags to exclude in comparison
+     * @param {string} [compareTagKeyFilter] Tag key filter for comparison period
+     * @param {string} [compareTagValueFilter] Tag value filter for comparison period
      * @param {number} [resultsPage] Page number for popular results pagination
      * @param {number} [resultsPageSize] Number of results per page for popular results
      * @param {number} [filtersPage] Page number for popular filters pagination
-     * @param {number} [filtersPageSize] Number of filters per page for popular filters
+     * @param {number} [filtersPageSize] Number of filters per page
+     * @param {number} [geoPage] Page number for geo analytics pagination
+     * @param {number} [geoPageSize] Number of geo locations per page
      * @param {boolean} [includeWidget] Whether to include widget display fields for popular results
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
-    adminAnalyticsStoreXStoreIDQueriesQueryInsightsGet: (xStoreID: string, query: string, startTime?: string, endTime?: string, resultsPage?: number, resultsPageSize?: number, filtersPage?: number, filtersPageSize?: number, includeWidget?: boolean, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
+    adminAnalyticsStoreXStoreIDQueriesQueryInsightsGet: (xStoreID: string, query: string, startTime?: string, endTime?: string, compareMode?: boolean, compareStartTime?: string, compareEndTime?: string, compareAnalyticsTags?: string, compareTagsMatchMode?: AdminAnalyticsStoreXStoreIDQueriesQueryInsightsGetCompareTagsMatchModeEnum, compareTagsExclude?: string, compareTagKeyFilter?: string, compareTagValueFilter?: string, resultsPage?: number, resultsPageSize?: number, filtersPage?: number, filtersPageSize?: number, geoPage?: number, geoPageSize?: number, includeWidget?: boolean, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
     /**
      * Retrieve analytics for top performing search results with optional enrichment. By default returns widget display fields for UI presentation. Use include_documents=true for full document data (heavier response). Supports lightweight widget-only mode for dashboards with analytics tags filtering and comparison mode support.
      * @summary Get Top Results Analytics
@@ -13548,21 +14232,31 @@ export declare const AnalyticsApiFp: (configuration?: Configuration) => {
      */
     adminAnalyticsStoreXStoreIDQueriesNoResultsGet(xStoreID: string, startTime?: string, endTime?: string, search?: string, analyticsTags?: string, tagsMatchMode?: AdminAnalyticsStoreXStoreIDQueriesNoResultsGetTagsMatchModeEnum, tagsExclude?: string, tagKeyFilter?: string, tagValueFilter?: string, compareMode?: boolean, compareStartTime?: string, compareEndTime?: string, compareAnalyticsTags?: string, compareTagsMatchMode?: AdminAnalyticsStoreXStoreIDQueriesNoResultsGetCompareTagsMatchModeEnum, compareTagsExclude?: string, compareTagKeyFilter?: string, compareTagValueFilter?: string, limit?: number, offset?: number, page?: number, pageSize?: number, sortBy?: AdminAnalyticsStoreXStoreIDQueriesNoResultsGetSortByEnum, sortOrder?: AdminAnalyticsStoreXStoreIDQueriesNoResultsGetSortOrderEnum, sort?: string, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<AdminAnalyticsStoreXStoreIDQueriesNoClicksGet200Response>>;
     /**
-     * Retrieve comprehensive analytics for a specific search query including popular results, filters, click position histogram, and performance metrics with independent pagination for popular results and filters
+     * Retrieve comprehensive analytics for a specific search query including popular results, filters, click position histogram, geo analytics, and performance metrics with deep comparison mode support and independent pagination for popular results and filters
      * @summary Get Query Insights
      * @param {string} xStoreID Store ID
      * @param {string} query Search query to analyze
      * @param {string} [startTime] Start time in RFC3339 format
      * @param {string} [endTime] End time in RFC3339 format
+     * @param {boolean} [compareMode] Enable comparison mode to compare with another time period/tag set
+     * @param {string} [compareStartTime] Comparison period start time in RFC3339 format
+     * @param {string} [compareEndTime] Comparison period end time in RFC3339 format
+     * @param {string} [compareAnalyticsTags] Comma-separated analytics tags for comparison period
+     * @param {AdminAnalyticsStoreXStoreIDQueriesQueryInsightsGetCompareTagsMatchModeEnum} [compareTagsMatchMode] How to match comparison analytics tags
+     * @param {string} [compareTagsExclude] Comma-separated analytics tags to exclude in comparison
+     * @param {string} [compareTagKeyFilter] Tag key filter for comparison period
+     * @param {string} [compareTagValueFilter] Tag value filter for comparison period
      * @param {number} [resultsPage] Page number for popular results pagination
      * @param {number} [resultsPageSize] Number of results per page for popular results
      * @param {number} [filtersPage] Page number for popular filters pagination
-     * @param {number} [filtersPageSize] Number of filters per page for popular filters
+     * @param {number} [filtersPageSize] Number of filters per page
+     * @param {number} [geoPage] Page number for geo analytics pagination
+     * @param {number} [geoPageSize] Number of geo locations per page
      * @param {boolean} [includeWidget] Whether to include widget display fields for popular results
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
-    adminAnalyticsStoreXStoreIDQueriesQueryInsightsGet(xStoreID: string, query: string, startTime?: string, endTime?: string, resultsPage?: number, resultsPageSize?: number, filtersPage?: number, filtersPageSize?: number, includeWidget?: boolean, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<AdminAnalyticsStoreXStoreIDQueriesQueryInsightsGet200Response>>;
+    adminAnalyticsStoreXStoreIDQueriesQueryInsightsGet(xStoreID: string, query: string, startTime?: string, endTime?: string, compareMode?: boolean, compareStartTime?: string, compareEndTime?: string, compareAnalyticsTags?: string, compareTagsMatchMode?: AdminAnalyticsStoreXStoreIDQueriesQueryInsightsGetCompareTagsMatchModeEnum, compareTagsExclude?: string, compareTagKeyFilter?: string, compareTagValueFilter?: string, resultsPage?: number, resultsPageSize?: number, filtersPage?: number, filtersPageSize?: number, geoPage?: number, geoPageSize?: number, includeWidget?: boolean, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<AdminAnalyticsStoreXStoreIDQueriesQueryInsightsGet200Response>>;
     /**
      * Retrieve analytics for top performing search results with optional enrichment. By default returns widget display fields for UI presentation. Use include_documents=true for full document data (heavier response). Supports lightweight widget-only mode for dashboards with analytics tags filtering and comparison mode support.
      * @summary Get Top Results Analytics
@@ -13905,21 +14599,31 @@ export declare const AnalyticsApiFactory: (configuration?: Configuration, basePa
      */
     adminAnalyticsStoreXStoreIDQueriesNoResultsGet(xStoreID: string, startTime?: string, endTime?: string, search?: string, analyticsTags?: string, tagsMatchMode?: AdminAnalyticsStoreXStoreIDQueriesNoResultsGetTagsMatchModeEnum, tagsExclude?: string, tagKeyFilter?: string, tagValueFilter?: string, compareMode?: boolean, compareStartTime?: string, compareEndTime?: string, compareAnalyticsTags?: string, compareTagsMatchMode?: AdminAnalyticsStoreXStoreIDQueriesNoResultsGetCompareTagsMatchModeEnum, compareTagsExclude?: string, compareTagKeyFilter?: string, compareTagValueFilter?: string, limit?: number, offset?: number, page?: number, pageSize?: number, sortBy?: AdminAnalyticsStoreXStoreIDQueriesNoResultsGetSortByEnum, sortOrder?: AdminAnalyticsStoreXStoreIDQueriesNoResultsGetSortOrderEnum, sort?: string, options?: RawAxiosRequestConfig): AxiosPromise<AdminAnalyticsStoreXStoreIDQueriesNoClicksGet200Response>;
     /**
-     * Retrieve comprehensive analytics for a specific search query including popular results, filters, click position histogram, and performance metrics with independent pagination for popular results and filters
+     * Retrieve comprehensive analytics for a specific search query including popular results, filters, click position histogram, geo analytics, and performance metrics with deep comparison mode support and independent pagination for popular results and filters
      * @summary Get Query Insights
      * @param {string} xStoreID Store ID
      * @param {string} query Search query to analyze
      * @param {string} [startTime] Start time in RFC3339 format
      * @param {string} [endTime] End time in RFC3339 format
+     * @param {boolean} [compareMode] Enable comparison mode to compare with another time period/tag set
+     * @param {string} [compareStartTime] Comparison period start time in RFC3339 format
+     * @param {string} [compareEndTime] Comparison period end time in RFC3339 format
+     * @param {string} [compareAnalyticsTags] Comma-separated analytics tags for comparison period
+     * @param {AdminAnalyticsStoreXStoreIDQueriesQueryInsightsGetCompareTagsMatchModeEnum} [compareTagsMatchMode] How to match comparison analytics tags
+     * @param {string} [compareTagsExclude] Comma-separated analytics tags to exclude in comparison
+     * @param {string} [compareTagKeyFilter] Tag key filter for comparison period
+     * @param {string} [compareTagValueFilter] Tag value filter for comparison period
      * @param {number} [resultsPage] Page number for popular results pagination
      * @param {number} [resultsPageSize] Number of results per page for popular results
      * @param {number} [filtersPage] Page number for popular filters pagination
-     * @param {number} [filtersPageSize] Number of filters per page for popular filters
+     * @param {number} [filtersPageSize] Number of filters per page
+     * @param {number} [geoPage] Page number for geo analytics pagination
+     * @param {number} [geoPageSize] Number of geo locations per page
      * @param {boolean} [includeWidget] Whether to include widget display fields for popular results
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
-    adminAnalyticsStoreXStoreIDQueriesQueryInsightsGet(xStoreID: string, query: string, startTime?: string, endTime?: string, resultsPage?: number, resultsPageSize?: number, filtersPage?: number, filtersPageSize?: number, includeWidget?: boolean, options?: RawAxiosRequestConfig): AxiosPromise<AdminAnalyticsStoreXStoreIDQueriesQueryInsightsGet200Response>;
+    adminAnalyticsStoreXStoreIDQueriesQueryInsightsGet(xStoreID: string, query: string, startTime?: string, endTime?: string, compareMode?: boolean, compareStartTime?: string, compareEndTime?: string, compareAnalyticsTags?: string, compareTagsMatchMode?: AdminAnalyticsStoreXStoreIDQueriesQueryInsightsGetCompareTagsMatchModeEnum, compareTagsExclude?: string, compareTagKeyFilter?: string, compareTagValueFilter?: string, resultsPage?: number, resultsPageSize?: number, filtersPage?: number, filtersPageSize?: number, geoPage?: number, geoPageSize?: number, includeWidget?: boolean, options?: RawAxiosRequestConfig): AxiosPromise<AdminAnalyticsStoreXStoreIDQueriesQueryInsightsGet200Response>;
     /**
      * Retrieve analytics for top performing search results with optional enrichment. By default returns widget display fields for UI presentation. Use include_documents=true for full document data (heavier response). Supports lightweight widget-only mode for dashboards with analytics tags filtering and comparison mode support.
      * @summary Get Top Results Analytics
@@ -14277,22 +14981,32 @@ export declare class AnalyticsApi extends BaseAPI {
      */
     adminAnalyticsStoreXStoreIDQueriesNoResultsGet(xStoreID: string, startTime?: string, endTime?: string, search?: string, analyticsTags?: string, tagsMatchMode?: AdminAnalyticsStoreXStoreIDQueriesNoResultsGetTagsMatchModeEnum, tagsExclude?: string, tagKeyFilter?: string, tagValueFilter?: string, compareMode?: boolean, compareStartTime?: string, compareEndTime?: string, compareAnalyticsTags?: string, compareTagsMatchMode?: AdminAnalyticsStoreXStoreIDQueriesNoResultsGetCompareTagsMatchModeEnum, compareTagsExclude?: string, compareTagKeyFilter?: string, compareTagValueFilter?: string, limit?: number, offset?: number, page?: number, pageSize?: number, sortBy?: AdminAnalyticsStoreXStoreIDQueriesNoResultsGetSortByEnum, sortOrder?: AdminAnalyticsStoreXStoreIDQueriesNoResultsGetSortOrderEnum, sort?: string, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<AdminAnalyticsStoreXStoreIDQueriesNoClicksGet200Response, any, {}>>;
     /**
-     * Retrieve comprehensive analytics for a specific search query including popular results, filters, click position histogram, and performance metrics with independent pagination for popular results and filters
+     * Retrieve comprehensive analytics for a specific search query including popular results, filters, click position histogram, geo analytics, and performance metrics with deep comparison mode support and independent pagination for popular results and filters
      * @summary Get Query Insights
      * @param {string} xStoreID Store ID
      * @param {string} query Search query to analyze
      * @param {string} [startTime] Start time in RFC3339 format
      * @param {string} [endTime] End time in RFC3339 format
+     * @param {boolean} [compareMode] Enable comparison mode to compare with another time period/tag set
+     * @param {string} [compareStartTime] Comparison period start time in RFC3339 format
+     * @param {string} [compareEndTime] Comparison period end time in RFC3339 format
+     * @param {string} [compareAnalyticsTags] Comma-separated analytics tags for comparison period
+     * @param {AdminAnalyticsStoreXStoreIDQueriesQueryInsightsGetCompareTagsMatchModeEnum} [compareTagsMatchMode] How to match comparison analytics tags
+     * @param {string} [compareTagsExclude] Comma-separated analytics tags to exclude in comparison
+     * @param {string} [compareTagKeyFilter] Tag key filter for comparison period
+     * @param {string} [compareTagValueFilter] Tag value filter for comparison period
      * @param {number} [resultsPage] Page number for popular results pagination
      * @param {number} [resultsPageSize] Number of results per page for popular results
      * @param {number} [filtersPage] Page number for popular filters pagination
-     * @param {number} [filtersPageSize] Number of filters per page for popular filters
+     * @param {number} [filtersPageSize] Number of filters per page
+     * @param {number} [geoPage] Page number for geo analytics pagination
+     * @param {number} [geoPageSize] Number of geo locations per page
      * @param {boolean} [includeWidget] Whether to include widget display fields for popular results
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      * @memberof AnalyticsApi
      */
-    adminAnalyticsStoreXStoreIDQueriesQueryInsightsGet(xStoreID: string, query: string, startTime?: string, endTime?: string, resultsPage?: number, resultsPageSize?: number, filtersPage?: number, filtersPageSize?: number, includeWidget?: boolean, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<AdminAnalyticsStoreXStoreIDQueriesQueryInsightsGet200Response, any, {}>>;
+    adminAnalyticsStoreXStoreIDQueriesQueryInsightsGet(xStoreID: string, query: string, startTime?: string, endTime?: string, compareMode?: boolean, compareStartTime?: string, compareEndTime?: string, compareAnalyticsTags?: string, compareTagsMatchMode?: AdminAnalyticsStoreXStoreIDQueriesQueryInsightsGetCompareTagsMatchModeEnum, compareTagsExclude?: string, compareTagKeyFilter?: string, compareTagValueFilter?: string, resultsPage?: number, resultsPageSize?: number, filtersPage?: number, filtersPageSize?: number, geoPage?: number, geoPageSize?: number, includeWidget?: boolean, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<AdminAnalyticsStoreXStoreIDQueriesQueryInsightsGet200Response, any, {}>>;
     /**
      * Retrieve analytics for top performing search results with optional enrichment. By default returns widget display fields for UI presentation. Use include_documents=true for full document data (heavier response). Supports lightweight widget-only mode for dashboards with analytics tags filtering and comparison mode support.
      * @summary Get Top Results Analytics
@@ -14658,6 +15372,14 @@ export declare const AdminAnalyticsStoreXStoreIDQueriesNoResultsGetSortOrderEnum
     readonly Desc: "desc";
 };
 export type AdminAnalyticsStoreXStoreIDQueriesNoResultsGetSortOrderEnum = typeof AdminAnalyticsStoreXStoreIDQueriesNoResultsGetSortOrderEnum[keyof typeof AdminAnalyticsStoreXStoreIDQueriesNoResultsGetSortOrderEnum];
+/**
+ * @export
+ */
+export declare const AdminAnalyticsStoreXStoreIDQueriesQueryInsightsGetCompareTagsMatchModeEnum: {
+    readonly Any: "any";
+    readonly All: "all";
+};
+export type AdminAnalyticsStoreXStoreIDQueriesQueryInsightsGetCompareTagsMatchModeEnum = typeof AdminAnalyticsStoreXStoreIDQueriesQueryInsightsGetCompareTagsMatchModeEnum[keyof typeof AdminAnalyticsStoreXStoreIDQueriesQueryInsightsGetCompareTagsMatchModeEnum];
 /**
  * @export
  */
@@ -16404,6 +17126,37 @@ export declare const ItemAnalyticsApiAxiosParamCreator: (configuration?: Configu
      * @throws {RequiredError}
      */
     adminAnalyticsStoreXStoreIDItemsItemIdGet: (xStoreID: string, itemId: string, startTime?: string, endTime?: string, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
+    /**
+     * Retrieve comprehensive analytics insights for a specific item including popular queries, filters, position distribution, geo analytics, and performance metrics with pagination support for subsections and optional comparison mode
+     * @summary Get Item Insights
+     * @param {string} xStoreID Store ID
+     * @param {string} itemId Item ID to analyze
+     * @param {string} [startTime] Start time in RFC3339 format
+     * @param {string} [endTime] End time in RFC3339 format
+     * @param {string} [analyticsTags] Comma-separated analytics tags to filter (e.g., \&#39;campaign:summer,source:email\&#39;)
+     * @param {AdminAnalyticsStoreXStoreIDItemsItemIdInsightsGetTagsMatchModeEnum} [tagsMatchMode] How to match multiple analytics tags
+     * @param {string} [tagsExclude] Comma-separated analytics tags to exclude
+     * @param {string} [tagKeyFilter] Filter by tag key pattern (matches tags starting with key:)
+     * @param {string} [tagValueFilter] Filter by tag value pattern (matches tags ending with :value)
+     * @param {boolean} [compareMode] Enable comparison mode to compare with another time period/tag set
+     * @param {string} [compareStartTime] Comparison period start time in RFC3339 format
+     * @param {string} [compareEndTime] Comparison period end time in RFC3339 format
+     * @param {string} [compareAnalyticsTags] Comma-separated analytics tags for comparison period
+     * @param {AdminAnalyticsStoreXStoreIDItemsItemIdInsightsGetCompareTagsMatchModeEnum} [compareTagsMatchMode] How to match comparison analytics tags
+     * @param {string} [compareTagsExclude] Comma-separated analytics tags to exclude in comparison
+     * @param {string} [compareTagKeyFilter] Tag key filter for comparison period
+     * @param {string} [compareTagValueFilter] Tag value filter for comparison period
+     * @param {number} [resultsPage] Page number for popular queries pagination
+     * @param {number} [resultsPageSize] Number of queries per page for popular queries
+     * @param {number} [filtersPage] Page number for popular filters pagination
+     * @param {number} [filtersPageSize] Number of filters per page
+     * @param {number} [geoPage] Page number for geo analytics pagination
+     * @param {number} [geoPageSize] Number of geo locations per page
+     * @param {AdminAnalyticsStoreXStoreIDItemsItemIdInsightsGetGroupByEnum} [groupBy] Include performance trends by date
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    adminAnalyticsStoreXStoreIDItemsItemIdInsightsGet: (xStoreID: string, itemId: string, startTime?: string, endTime?: string, analyticsTags?: string, tagsMatchMode?: AdminAnalyticsStoreXStoreIDItemsItemIdInsightsGetTagsMatchModeEnum, tagsExclude?: string, tagKeyFilter?: string, tagValueFilter?: string, compareMode?: boolean, compareStartTime?: string, compareEndTime?: string, compareAnalyticsTags?: string, compareTagsMatchMode?: AdminAnalyticsStoreXStoreIDItemsItemIdInsightsGetCompareTagsMatchModeEnum, compareTagsExclude?: string, compareTagKeyFilter?: string, compareTagValueFilter?: string, resultsPage?: number, resultsPageSize?: number, filtersPage?: number, filtersPageSize?: number, geoPage?: number, geoPageSize?: number, groupBy?: AdminAnalyticsStoreXStoreIDItemsItemIdInsightsGetGroupByEnum, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
     /**
      * Retrieve detailed performance metrics for items including click-through rates, conversion rates, and revenue data
      * @summary Get Item Performance Analytics
@@ -16536,6 +17289,37 @@ export declare const ItemAnalyticsApiFp: (configuration?: Configuration) => {
      * @throws {RequiredError}
      */
     adminAnalyticsStoreXStoreIDItemsItemIdGet(xStoreID: string, itemId: string, startTime?: string, endTime?: string, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<AnalyticsAnalyticsAPIResponse>>;
+    /**
+     * Retrieve comprehensive analytics insights for a specific item including popular queries, filters, position distribution, geo analytics, and performance metrics with pagination support for subsections and optional comparison mode
+     * @summary Get Item Insights
+     * @param {string} xStoreID Store ID
+     * @param {string} itemId Item ID to analyze
+     * @param {string} [startTime] Start time in RFC3339 format
+     * @param {string} [endTime] End time in RFC3339 format
+     * @param {string} [analyticsTags] Comma-separated analytics tags to filter (e.g., \&#39;campaign:summer,source:email\&#39;)
+     * @param {AdminAnalyticsStoreXStoreIDItemsItemIdInsightsGetTagsMatchModeEnum} [tagsMatchMode] How to match multiple analytics tags
+     * @param {string} [tagsExclude] Comma-separated analytics tags to exclude
+     * @param {string} [tagKeyFilter] Filter by tag key pattern (matches tags starting with key:)
+     * @param {string} [tagValueFilter] Filter by tag value pattern (matches tags ending with :value)
+     * @param {boolean} [compareMode] Enable comparison mode to compare with another time period/tag set
+     * @param {string} [compareStartTime] Comparison period start time in RFC3339 format
+     * @param {string} [compareEndTime] Comparison period end time in RFC3339 format
+     * @param {string} [compareAnalyticsTags] Comma-separated analytics tags for comparison period
+     * @param {AdminAnalyticsStoreXStoreIDItemsItemIdInsightsGetCompareTagsMatchModeEnum} [compareTagsMatchMode] How to match comparison analytics tags
+     * @param {string} [compareTagsExclude] Comma-separated analytics tags to exclude in comparison
+     * @param {string} [compareTagKeyFilter] Tag key filter for comparison period
+     * @param {string} [compareTagValueFilter] Tag value filter for comparison period
+     * @param {number} [resultsPage] Page number for popular queries pagination
+     * @param {number} [resultsPageSize] Number of queries per page for popular queries
+     * @param {number} [filtersPage] Page number for popular filters pagination
+     * @param {number} [filtersPageSize] Number of filters per page
+     * @param {number} [geoPage] Page number for geo analytics pagination
+     * @param {number} [geoPageSize] Number of geo locations per page
+     * @param {AdminAnalyticsStoreXStoreIDItemsItemIdInsightsGetGroupByEnum} [groupBy] Include performance trends by date
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    adminAnalyticsStoreXStoreIDItemsItemIdInsightsGet(xStoreID: string, itemId: string, startTime?: string, endTime?: string, analyticsTags?: string, tagsMatchMode?: AdminAnalyticsStoreXStoreIDItemsItemIdInsightsGetTagsMatchModeEnum, tagsExclude?: string, tagKeyFilter?: string, tagValueFilter?: string, compareMode?: boolean, compareStartTime?: string, compareEndTime?: string, compareAnalyticsTags?: string, compareTagsMatchMode?: AdminAnalyticsStoreXStoreIDItemsItemIdInsightsGetCompareTagsMatchModeEnum, compareTagsExclude?: string, compareTagKeyFilter?: string, compareTagValueFilter?: string, resultsPage?: number, resultsPageSize?: number, filtersPage?: number, filtersPageSize?: number, geoPage?: number, geoPageSize?: number, groupBy?: AdminAnalyticsStoreXStoreIDItemsItemIdInsightsGetGroupByEnum, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<AdminAnalyticsStoreXStoreIDItemsItemIdInsightsGet200Response>>;
     /**
      * Retrieve detailed performance metrics for items including click-through rates, conversion rates, and revenue data
      * @summary Get Item Performance Analytics
@@ -16668,6 +17452,37 @@ export declare const ItemAnalyticsApiFactory: (configuration?: Configuration, ba
      * @throws {RequiredError}
      */
     adminAnalyticsStoreXStoreIDItemsItemIdGet(xStoreID: string, itemId: string, startTime?: string, endTime?: string, options?: RawAxiosRequestConfig): AxiosPromise<AnalyticsAnalyticsAPIResponse>;
+    /**
+     * Retrieve comprehensive analytics insights for a specific item including popular queries, filters, position distribution, geo analytics, and performance metrics with pagination support for subsections and optional comparison mode
+     * @summary Get Item Insights
+     * @param {string} xStoreID Store ID
+     * @param {string} itemId Item ID to analyze
+     * @param {string} [startTime] Start time in RFC3339 format
+     * @param {string} [endTime] End time in RFC3339 format
+     * @param {string} [analyticsTags] Comma-separated analytics tags to filter (e.g., \&#39;campaign:summer,source:email\&#39;)
+     * @param {AdminAnalyticsStoreXStoreIDItemsItemIdInsightsGetTagsMatchModeEnum} [tagsMatchMode] How to match multiple analytics tags
+     * @param {string} [tagsExclude] Comma-separated analytics tags to exclude
+     * @param {string} [tagKeyFilter] Filter by tag key pattern (matches tags starting with key:)
+     * @param {string} [tagValueFilter] Filter by tag value pattern (matches tags ending with :value)
+     * @param {boolean} [compareMode] Enable comparison mode to compare with another time period/tag set
+     * @param {string} [compareStartTime] Comparison period start time in RFC3339 format
+     * @param {string} [compareEndTime] Comparison period end time in RFC3339 format
+     * @param {string} [compareAnalyticsTags] Comma-separated analytics tags for comparison period
+     * @param {AdminAnalyticsStoreXStoreIDItemsItemIdInsightsGetCompareTagsMatchModeEnum} [compareTagsMatchMode] How to match comparison analytics tags
+     * @param {string} [compareTagsExclude] Comma-separated analytics tags to exclude in comparison
+     * @param {string} [compareTagKeyFilter] Tag key filter for comparison period
+     * @param {string} [compareTagValueFilter] Tag value filter for comparison period
+     * @param {number} [resultsPage] Page number for popular queries pagination
+     * @param {number} [resultsPageSize] Number of queries per page for popular queries
+     * @param {number} [filtersPage] Page number for popular filters pagination
+     * @param {number} [filtersPageSize] Number of filters per page
+     * @param {number} [geoPage] Page number for geo analytics pagination
+     * @param {number} [geoPageSize] Number of geo locations per page
+     * @param {AdminAnalyticsStoreXStoreIDItemsItemIdInsightsGetGroupByEnum} [groupBy] Include performance trends by date
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    adminAnalyticsStoreXStoreIDItemsItemIdInsightsGet(xStoreID: string, itemId: string, startTime?: string, endTime?: string, analyticsTags?: string, tagsMatchMode?: AdminAnalyticsStoreXStoreIDItemsItemIdInsightsGetTagsMatchModeEnum, tagsExclude?: string, tagKeyFilter?: string, tagValueFilter?: string, compareMode?: boolean, compareStartTime?: string, compareEndTime?: string, compareAnalyticsTags?: string, compareTagsMatchMode?: AdminAnalyticsStoreXStoreIDItemsItemIdInsightsGetCompareTagsMatchModeEnum, compareTagsExclude?: string, compareTagKeyFilter?: string, compareTagValueFilter?: string, resultsPage?: number, resultsPageSize?: number, filtersPage?: number, filtersPageSize?: number, geoPage?: number, geoPageSize?: number, groupBy?: AdminAnalyticsStoreXStoreIDItemsItemIdInsightsGetGroupByEnum, options?: RawAxiosRequestConfig): AxiosPromise<AdminAnalyticsStoreXStoreIDItemsItemIdInsightsGet200Response>;
     /**
      * Retrieve detailed performance metrics for items including click-through rates, conversion rates, and revenue data
      * @summary Get Item Performance Analytics
@@ -16806,6 +17621,38 @@ export declare class ItemAnalyticsApi extends BaseAPI {
      * @memberof ItemAnalyticsApi
      */
     adminAnalyticsStoreXStoreIDItemsItemIdGet(xStoreID: string, itemId: string, startTime?: string, endTime?: string, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<AnalyticsAnalyticsAPIResponse, any, {}>>;
+    /**
+     * Retrieve comprehensive analytics insights for a specific item including popular queries, filters, position distribution, geo analytics, and performance metrics with pagination support for subsections and optional comparison mode
+     * @summary Get Item Insights
+     * @param {string} xStoreID Store ID
+     * @param {string} itemId Item ID to analyze
+     * @param {string} [startTime] Start time in RFC3339 format
+     * @param {string} [endTime] End time in RFC3339 format
+     * @param {string} [analyticsTags] Comma-separated analytics tags to filter (e.g., \&#39;campaign:summer,source:email\&#39;)
+     * @param {AdminAnalyticsStoreXStoreIDItemsItemIdInsightsGetTagsMatchModeEnum} [tagsMatchMode] How to match multiple analytics tags
+     * @param {string} [tagsExclude] Comma-separated analytics tags to exclude
+     * @param {string} [tagKeyFilter] Filter by tag key pattern (matches tags starting with key:)
+     * @param {string} [tagValueFilter] Filter by tag value pattern (matches tags ending with :value)
+     * @param {boolean} [compareMode] Enable comparison mode to compare with another time period/tag set
+     * @param {string} [compareStartTime] Comparison period start time in RFC3339 format
+     * @param {string} [compareEndTime] Comparison period end time in RFC3339 format
+     * @param {string} [compareAnalyticsTags] Comma-separated analytics tags for comparison period
+     * @param {AdminAnalyticsStoreXStoreIDItemsItemIdInsightsGetCompareTagsMatchModeEnum} [compareTagsMatchMode] How to match comparison analytics tags
+     * @param {string} [compareTagsExclude] Comma-separated analytics tags to exclude in comparison
+     * @param {string} [compareTagKeyFilter] Tag key filter for comparison period
+     * @param {string} [compareTagValueFilter] Tag value filter for comparison period
+     * @param {number} [resultsPage] Page number for popular queries pagination
+     * @param {number} [resultsPageSize] Number of queries per page for popular queries
+     * @param {number} [filtersPage] Page number for popular filters pagination
+     * @param {number} [filtersPageSize] Number of filters per page
+     * @param {number} [geoPage] Page number for geo analytics pagination
+     * @param {number} [geoPageSize] Number of geo locations per page
+     * @param {AdminAnalyticsStoreXStoreIDItemsItemIdInsightsGetGroupByEnum} [groupBy] Include performance trends by date
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof ItemAnalyticsApi
+     */
+    adminAnalyticsStoreXStoreIDItemsItemIdInsightsGet(xStoreID: string, itemId: string, startTime?: string, endTime?: string, analyticsTags?: string, tagsMatchMode?: AdminAnalyticsStoreXStoreIDItemsItemIdInsightsGetTagsMatchModeEnum, tagsExclude?: string, tagKeyFilter?: string, tagValueFilter?: string, compareMode?: boolean, compareStartTime?: string, compareEndTime?: string, compareAnalyticsTags?: string, compareTagsMatchMode?: AdminAnalyticsStoreXStoreIDItemsItemIdInsightsGetCompareTagsMatchModeEnum, compareTagsExclude?: string, compareTagKeyFilter?: string, compareTagValueFilter?: string, resultsPage?: number, resultsPageSize?: number, filtersPage?: number, filtersPageSize?: number, geoPage?: number, geoPageSize?: number, groupBy?: AdminAnalyticsStoreXStoreIDItemsItemIdInsightsGetGroupByEnum, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<AdminAnalyticsStoreXStoreIDItemsItemIdInsightsGet200Response, any, {}>>;
     /**
      * Retrieve detailed performance metrics for items including click-through rates, conversion rates, and revenue data
      * @summary Get Item Performance Analytics
@@ -16908,6 +17755,29 @@ export declare const AdminAnalyticsStoreXStoreIDItemsGetSortOrderEnum: {
     readonly Desc: "desc";
 };
 export type AdminAnalyticsStoreXStoreIDItemsGetSortOrderEnum = typeof AdminAnalyticsStoreXStoreIDItemsGetSortOrderEnum[keyof typeof AdminAnalyticsStoreXStoreIDItemsGetSortOrderEnum];
+/**
+ * @export
+ */
+export declare const AdminAnalyticsStoreXStoreIDItemsItemIdInsightsGetTagsMatchModeEnum: {
+    readonly Any: "any";
+    readonly All: "all";
+};
+export type AdminAnalyticsStoreXStoreIDItemsItemIdInsightsGetTagsMatchModeEnum = typeof AdminAnalyticsStoreXStoreIDItemsItemIdInsightsGetTagsMatchModeEnum[keyof typeof AdminAnalyticsStoreXStoreIDItemsItemIdInsightsGetTagsMatchModeEnum];
+/**
+ * @export
+ */
+export declare const AdminAnalyticsStoreXStoreIDItemsItemIdInsightsGetCompareTagsMatchModeEnum: {
+    readonly Any: "any";
+    readonly All: "all";
+};
+export type AdminAnalyticsStoreXStoreIDItemsItemIdInsightsGetCompareTagsMatchModeEnum = typeof AdminAnalyticsStoreXStoreIDItemsItemIdInsightsGetCompareTagsMatchModeEnum[keyof typeof AdminAnalyticsStoreXStoreIDItemsItemIdInsightsGetCompareTagsMatchModeEnum];
+/**
+ * @export
+ */
+export declare const AdminAnalyticsStoreXStoreIDItemsItemIdInsightsGetGroupByEnum: {
+    readonly Date: "date";
+};
+export type AdminAnalyticsStoreXStoreIDItemsItemIdInsightsGetGroupByEnum = typeof AdminAnalyticsStoreXStoreIDItemsItemIdInsightsGetGroupByEnum[keyof typeof AdminAnalyticsStoreXStoreIDItemsItemIdInsightsGetGroupByEnum];
 /**
  * @export
  */