@seekora-ai/admin-api 1.0.49 → 1.0.50

package/api.ts

@@ -367,6 +367,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
@@ -1917,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
@@ -1997,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
@@ -2270,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
@@ -2828,11 +3307,91 @@ export interface AnalyticsQueryFilterUsage {
      */
     'total_usage'?: number;
     /**
-     * Unique searches using this filter
-     * @type {number}
-     * @memberof AnalyticsQueryFilterUsage
+     * Unique searches using this filter
+     * @type {number}
+     * @memberof 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
      */
-    'unique_searches'?: number;
+    'meta'?: AnalyticsPaginationMeta;
 }
 /**
  * 
@@ -2870,6 +3429,12 @@ export interface AnalyticsQueryInsights {
      * @memberof AnalyticsQueryInsights
      */
     'filter_analytics'?: AnalyticsQueryFilterAnalytics;
+    /**
+     * 
+     * @type {AnalyticsQueryGeoAnalyticsSection}
+     * @memberof AnalyticsQueryInsights
+     */
+    'geo_analytics'?: AnalyticsQueryGeoAnalyticsSection;
     /**
      * 
      * @type {string}
@@ -3219,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
@@ -14746,7 +15354,7 @@ export const AnalyticsApiAxiosParamCreator = function (configuration?: Configura
             };
         },
         /**
-         * Retrieve comprehensive analytics for a specific search query including popular results, filters, click position histogram, and performance metrics with deep comparison mode support and 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
@@ -14763,12 +15371,14 @@ export const AnalyticsApiAxiosParamCreator = function (configuration?: Configura
          * @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: async (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, includeWidget?: boolean, options: RawAxiosRequestConfig = {}): Promise<RequestArgs> => {
+        adminAnalyticsStoreXStoreIDQueriesQueryInsightsGet: async (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> => {
             // verify required parameter 'xStoreID' is not null or undefined
             assertParamExists('adminAnalyticsStoreXStoreIDQueriesQueryInsightsGet', 'xStoreID', xStoreID)
             // verify required parameter 'query' is not null or undefined
@@ -14846,6 +15456,14 @@ export const AnalyticsApiAxiosParamCreator = function (configuration?: Configura
                 localVarQueryParameter['filters_page_size'] = filtersPageSize;
             }
 
+            if (geoPage !== undefined) {
+                localVarQueryParameter['geo_page'] = geoPage;
+            }
+
+            if (geoPageSize !== undefined) {
+                localVarQueryParameter['geo_page_size'] = geoPageSize;
+            }
+
             if (includeWidget !== undefined) {
                 localVarQueryParameter['include_widget'] = includeWidget;
             }
@@ -15545,7 +16163,7 @@ export const AnalyticsApiFp = function(configuration?: Configuration) {
             return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
         },
         /**
-         * Retrieve comprehensive analytics for a specific search query including popular results, filters, click position histogram, and performance metrics with deep comparison mode support and 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
@@ -15562,13 +16180,15 @@ export const AnalyticsApiFp = function(configuration?: Configuration) {
          * @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}
          */
-        async 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, includeWidget?: boolean, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<AdminAnalyticsStoreXStoreIDQueriesQueryInsightsGet200Response>> {
-            const localVarAxiosArgs = await localVarAxiosParamCreator.adminAnalyticsStoreXStoreIDQueriesQueryInsightsGet(xStoreID, query, startTime, endTime, compareMode, compareStartTime, compareEndTime, compareAnalyticsTags, compareTagsMatchMode, compareTagsExclude, compareTagKeyFilter, compareTagValueFilter, resultsPage, resultsPageSize, filtersPage, filtersPageSize, includeWidget, options);
+        async 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>> {
+            const localVarAxiosArgs = await localVarAxiosParamCreator.adminAnalyticsStoreXStoreIDQueriesQueryInsightsGet(xStoreID, query, startTime, endTime, compareMode, compareStartTime, compareEndTime, compareAnalyticsTags, compareTagsMatchMode, compareTagsExclude, compareTagKeyFilter, compareTagValueFilter, resultsPage, resultsPageSize, filtersPage, filtersPageSize, geoPage, geoPageSize, includeWidget, options);
             const localVarOperationServerIndex = configuration?.serverIndex ?? 0;
             const localVarOperationServerBasePath = operationServerMap['AnalyticsApi.adminAnalyticsStoreXStoreIDQueriesQueryInsightsGet']?.[localVarOperationServerIndex]?.url;
             return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
@@ -15960,7 +16580,7 @@ export const AnalyticsApiFactory = function (configuration?: Configuration, base
             return localVarFp.adminAnalyticsStoreXStoreIDQueriesNoResultsGet(xStoreID, startTime, endTime, search, analyticsTags, tagsMatchMode, tagsExclude, tagKeyFilter, tagValueFilter, compareMode, compareStartTime, compareEndTime, compareAnalyticsTags, compareTagsMatchMode, compareTagsExclude, compareTagKeyFilter, compareTagValueFilter, limit, offset, page, pageSize, sortBy, sortOrder, sort, options).then((request) => request(axios, basePath));
         },
         /**
-         * Retrieve comprehensive analytics for a specific search query including popular results, filters, click position histogram, and performance metrics with deep comparison mode support and 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
@@ -15977,13 +16597,15 @@ export const AnalyticsApiFactory = function (configuration?: Configuration, base
          * @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, compareMode?: boolean, compareStartTime?: string, compareEndTime?: string, compareAnalyticsTags?: string, compareTagsMatchMode?: AdminAnalyticsStoreXStoreIDQueriesQueryInsightsGetCompareTagsMatchModeEnum, compareTagsExclude?: string, compareTagKeyFilter?: string, compareTagValueFilter?: string, resultsPage?: number, resultsPageSize?: number, filtersPage?: number, filtersPageSize?: number, includeWidget?: boolean, options?: RawAxiosRequestConfig): AxiosPromise<AdminAnalyticsStoreXStoreIDQueriesQueryInsightsGet200Response> {
-            return localVarFp.adminAnalyticsStoreXStoreIDQueriesQueryInsightsGet(xStoreID, query, startTime, endTime, compareMode, compareStartTime, compareEndTime, compareAnalyticsTags, compareTagsMatchMode, compareTagsExclude, compareTagKeyFilter, compareTagValueFilter, resultsPage, resultsPageSize, filtersPage, filtersPageSize, includeWidget, options).then((request) => request(axios, basePath));
+        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> {
+            return localVarFp.adminAnalyticsStoreXStoreIDQueriesQueryInsightsGet(xStoreID, query, startTime, endTime, compareMode, compareStartTime, compareEndTime, compareAnalyticsTags, compareTagsMatchMode, compareTagsExclude, compareTagKeyFilter, compareTagValueFilter, resultsPage, resultsPageSize, filtersPage, filtersPageSize, geoPage, geoPageSize, includeWidget, options).then((request) => request(axios, basePath));
         },
         /**
          * 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.
@@ -16389,7 +17011,7 @@ export class AnalyticsApi extends BaseAPI {
     }
 
     /**
-     * Retrieve comprehensive analytics for a specific search query including popular results, filters, click position histogram, and performance metrics with deep comparison mode support and 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
@@ -16406,14 +17028,16 @@ export class AnalyticsApi extends BaseAPI {
      * @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
      */
-    public 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, includeWidget?: boolean, options?: RawAxiosRequestConfig) {
-        return AnalyticsApiFp(this.configuration).adminAnalyticsStoreXStoreIDQueriesQueryInsightsGet(xStoreID, query, startTime, endTime, compareMode, compareStartTime, compareEndTime, compareAnalyticsTags, compareTagsMatchMode, compareTagsExclude, compareTagKeyFilter, compareTagValueFilter, resultsPage, resultsPageSize, filtersPage, filtersPageSize, includeWidget, options).then((request) => request(this.axios, this.basePath));
+    public 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) {
+        return AnalyticsApiFp(this.configuration).adminAnalyticsStoreXStoreIDQueriesQueryInsightsGet(xStoreID, query, startTime, endTime, compareMode, compareStartTime, compareEndTime, compareAnalyticsTags, compareTagsMatchMode, compareTagsExclude, compareTagKeyFilter, compareTagValueFilter, resultsPage, resultsPageSize, filtersPage, filtersPageSize, geoPage, geoPageSize, includeWidget, options).then((request) => request(this.axios, this.basePath));
     }
 
     /**
@@ -20506,6 +21130,157 @@ export const ItemAnalyticsApiAxiosParamCreator = function (configuration?: Confi
 
 
     
+            setSearchParams(localVarUrlObj, localVarQueryParameter);
+            let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
+            localVarRequestOptions.headers = {...localVarHeaderParameter, ...headersFromBaseOptions, ...options.headers};
+
+            return {
+                url: toPathString(localVarUrlObj),
+                options: localVarRequestOptions,
+            };
+        },
+        /**
+         * 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: async (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> => {
+            // verify required parameter 'xStoreID' is not null or undefined
+            assertParamExists('adminAnalyticsStoreXStoreIDItemsItemIdInsightsGet', 'xStoreID', xStoreID)
+            // verify required parameter 'itemId' is not null or undefined
+            assertParamExists('adminAnalyticsStoreXStoreIDItemsItemIdInsightsGet', 'itemId', itemId)
+            const localVarPath = `/admin/analytics/store/{xStoreID}/items/{itemId}/insights`
+                .replace(`{${"xStoreID"}}`, encodeURIComponent(String(xStoreID)))
+                .replace(`{${"itemId"}}`, encodeURIComponent(String(itemId)));
+            // use dummy base URL string because the URL constructor only accepts absolute URLs.
+            const localVarUrlObj = new URL(localVarPath, DUMMY_BASE_URL);
+            let baseOptions;
+            if (configuration) {
+                baseOptions = configuration.baseOptions;
+            }
+
+            const localVarRequestOptions = { method: 'GET', ...baseOptions, ...options};
+            const localVarHeaderParameter = {} as any;
+            const localVarQueryParameter = {} as any;
+
+            // authentication BearerAuth required
+            await setApiKeyToObject(localVarHeaderParameter, "Authorization", configuration)
+
+            if (startTime !== undefined) {
+                localVarQueryParameter['start_time'] = startTime;
+            }
+
+            if (endTime !== undefined) {
+                localVarQueryParameter['end_time'] = endTime;
+            }
+
+            if (analyticsTags !== undefined) {
+                localVarQueryParameter['analytics_tags'] = analyticsTags;
+            }
+
+            if (tagsMatchMode !== undefined) {
+                localVarQueryParameter['tags_match_mode'] = tagsMatchMode;
+            }
+
+            if (tagsExclude !== undefined) {
+                localVarQueryParameter['tags_exclude'] = tagsExclude;
+            }
+
+            if (tagKeyFilter !== undefined) {
+                localVarQueryParameter['tag_key_filter'] = tagKeyFilter;
+            }
+
+            if (tagValueFilter !== undefined) {
+                localVarQueryParameter['tag_value_filter'] = tagValueFilter;
+            }
+
+            if (compareMode !== undefined) {
+                localVarQueryParameter['compare_mode'] = compareMode;
+            }
+
+            if (compareStartTime !== undefined) {
+                localVarQueryParameter['compare_start_time'] = compareStartTime;
+            }
+
+            if (compareEndTime !== undefined) {
+                localVarQueryParameter['compare_end_time'] = compareEndTime;
+            }
+
+            if (compareAnalyticsTags !== undefined) {
+                localVarQueryParameter['compare_analytics_tags'] = compareAnalyticsTags;
+            }
+
+            if (compareTagsMatchMode !== undefined) {
+                localVarQueryParameter['compare_tags_match_mode'] = compareTagsMatchMode;
+            }
+
+            if (compareTagsExclude !== undefined) {
+                localVarQueryParameter['compare_tags_exclude'] = compareTagsExclude;
+            }
+
+            if (compareTagKeyFilter !== undefined) {
+                localVarQueryParameter['compare_tag_key_filter'] = compareTagKeyFilter;
+            }
+
+            if (compareTagValueFilter !== undefined) {
+                localVarQueryParameter['compare_tag_value_filter'] = compareTagValueFilter;
+            }
+
+            if (resultsPage !== undefined) {
+                localVarQueryParameter['results_page'] = resultsPage;
+            }
+
+            if (resultsPageSize !== undefined) {
+                localVarQueryParameter['results_page_size'] = resultsPageSize;
+            }
+
+            if (filtersPage !== undefined) {
+                localVarQueryParameter['filters_page'] = filtersPage;
+            }
+
+            if (filtersPageSize !== undefined) {
+                localVarQueryParameter['filters_page_size'] = filtersPageSize;
+            }
+
+            if (geoPage !== undefined) {
+                localVarQueryParameter['geo_page'] = geoPage;
+            }
+
+            if (geoPageSize !== undefined) {
+                localVarQueryParameter['geo_page_size'] = geoPageSize;
+            }
+
+            if (groupBy !== undefined) {
+                localVarQueryParameter['group_by'] = groupBy;
+            }
+
+
+    
             setSearchParams(localVarUrlObj, localVarQueryParameter);
             let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
             localVarRequestOptions.headers = {...localVarHeaderParameter, ...headersFromBaseOptions, ...options.headers};
@@ -20910,6 +21685,42 @@ export const ItemAnalyticsApiFp = function(configuration?: Configuration) {
             const localVarOperationServerBasePath = operationServerMap['ItemAnalyticsApi.adminAnalyticsStoreXStoreIDItemsItemIdGet']?.[localVarOperationServerIndex]?.url;
             return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
         },
+        /**
+         * 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}
+         */
+        async 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>> {
+            const localVarAxiosArgs = await localVarAxiosParamCreator.adminAnalyticsStoreXStoreIDItemsItemIdInsightsGet(xStoreID, itemId, startTime, endTime, analyticsTags, tagsMatchMode, tagsExclude, tagKeyFilter, tagValueFilter, compareMode, compareStartTime, compareEndTime, compareAnalyticsTags, compareTagsMatchMode, compareTagsExclude, compareTagKeyFilter, compareTagValueFilter, resultsPage, resultsPageSize, filtersPage, filtersPageSize, geoPage, geoPageSize, groupBy, options);
+            const localVarOperationServerIndex = configuration?.serverIndex ?? 0;
+            const localVarOperationServerBasePath = operationServerMap['ItemAnalyticsApi.adminAnalyticsStoreXStoreIDItemsItemIdInsightsGet']?.[localVarOperationServerIndex]?.url;
+            return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
+        },
         /**
          * Retrieve detailed performance metrics for items including click-through rates, conversion rates, and revenue data
          * @summary Get Item Performance Analytics
@@ -21069,6 +21880,39 @@ export const ItemAnalyticsApiFactory = function (configuration?: Configuration,
         adminAnalyticsStoreXStoreIDItemsItemIdGet(xStoreID: string, itemId: string, startTime?: string, endTime?: string, options?: RawAxiosRequestConfig): AxiosPromise<AnalyticsAnalyticsAPIResponse> {
             return localVarFp.adminAnalyticsStoreXStoreIDItemsItemIdGet(xStoreID, itemId, startTime, endTime, options).then((request) => request(axios, basePath));
         },
+        /**
+         * 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> {
+            return localVarFp.adminAnalyticsStoreXStoreIDItemsItemIdInsightsGet(xStoreID, itemId, startTime, endTime, analyticsTags, tagsMatchMode, tagsExclude, tagKeyFilter, tagValueFilter, compareMode, compareStartTime, compareEndTime, compareAnalyticsTags, compareTagsMatchMode, compareTagsExclude, compareTagKeyFilter, compareTagValueFilter, resultsPage, resultsPageSize, filtersPage, filtersPageSize, geoPage, geoPageSize, groupBy, options).then((request) => request(axios, basePath));
+        },
         /**
          * Retrieve detailed performance metrics for items including click-through rates, conversion rates, and revenue data
          * @summary Get Item Performance Analytics
@@ -21227,6 +22071,41 @@ export class ItemAnalyticsApi extends BaseAPI {
         return ItemAnalyticsApiFp(this.configuration).adminAnalyticsStoreXStoreIDItemsItemIdGet(xStoreID, itemId, startTime, endTime, options).then((request) => request(this.axios, this.basePath));
     }
 
+    /**
+     * 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
+     */
+    public 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) {
+        return ItemAnalyticsApiFp(this.configuration).adminAnalyticsStoreXStoreIDItemsItemIdInsightsGet(xStoreID, itemId, startTime, endTime, analyticsTags, tagsMatchMode, tagsExclude, tagKeyFilter, tagValueFilter, compareMode, compareStartTime, compareEndTime, compareAnalyticsTags, compareTagsMatchMode, compareTagsExclude, compareTagKeyFilter, compareTagValueFilter, resultsPage, resultsPageSize, filtersPage, filtersPageSize, geoPage, geoPageSize, groupBy, options).then((request) => request(this.axios, this.basePath));
+    }
+
     /**
      * Retrieve detailed performance metrics for items including click-through rates, conversion rates, and revenue data
      * @summary Get Item Performance Analytics
@@ -21338,6 +22217,29 @@ export const AdminAnalyticsStoreXStoreIDItemsGetSortOrderEnum = {
     Desc: 'desc'
 } as const;
 export type AdminAnalyticsStoreXStoreIDItemsGetSortOrderEnum = typeof AdminAnalyticsStoreXStoreIDItemsGetSortOrderEnum[keyof typeof AdminAnalyticsStoreXStoreIDItemsGetSortOrderEnum];
+/**
+ * @export
+ */
+export const AdminAnalyticsStoreXStoreIDItemsItemIdInsightsGetTagsMatchModeEnum = {
+    Any: 'any',
+    All: 'all'
+} as const;
+export type AdminAnalyticsStoreXStoreIDItemsItemIdInsightsGetTagsMatchModeEnum = typeof AdminAnalyticsStoreXStoreIDItemsItemIdInsightsGetTagsMatchModeEnum[keyof typeof AdminAnalyticsStoreXStoreIDItemsItemIdInsightsGetTagsMatchModeEnum];
+/**
+ * @export
+ */
+export const AdminAnalyticsStoreXStoreIDItemsItemIdInsightsGetCompareTagsMatchModeEnum = {
+    Any: 'any',
+    All: 'all'
+} as const;
+export type AdminAnalyticsStoreXStoreIDItemsItemIdInsightsGetCompareTagsMatchModeEnum = typeof AdminAnalyticsStoreXStoreIDItemsItemIdInsightsGetCompareTagsMatchModeEnum[keyof typeof AdminAnalyticsStoreXStoreIDItemsItemIdInsightsGetCompareTagsMatchModeEnum];
+/**
+ * @export
+ */
+export const AdminAnalyticsStoreXStoreIDItemsItemIdInsightsGetGroupByEnum = {
+    Date: 'date'
+} as const;
+export type AdminAnalyticsStoreXStoreIDItemsItemIdInsightsGetGroupByEnum = typeof AdminAnalyticsStoreXStoreIDItemsItemIdInsightsGetGroupByEnum[keyof typeof AdminAnalyticsStoreXStoreIDItemsItemIdInsightsGetGroupByEnum];
 /**
  * @export
  */