@seekora-ai/admin-api 1.0.49 → 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
@@ -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
@@ -2193,82 +2517,237 @@ export interface AnalyticsItemPerformanceWithWidget {
     'impressions'?: number;
     /**
      *
-     * @type {string}
-     * @memberof AnalyticsItemPerformanceWithWidget
+     * @type {string}
+     * @memberof AnalyticsItemPerformanceWithWidget
+     */
+    'item_id'?: string;
+    /**
+     *
+     * @type {string}
+     * @memberof AnalyticsItemPerformanceWithWidget
+     */
+    'item_name'?: string;
+    /**
+     *
+     * @type {number}
+     * @memberof AnalyticsItemPerformanceWithWidget
+     */
+    'revenue'?: number;
+    /**
+     *
+     * @type {number}
+     * @memberof AnalyticsItemPerformanceWithWidget
+     */
+    'revenue_per_item'?: number;
+    /**
+     *
+     * @type {number}
+     * @memberof AnalyticsItemPerformanceWithWidget
+     */
+    'top_10_impressions'?: number;
+    /**
+     *
+     * @type {number}
+     * @memberof AnalyticsItemPerformanceWithWidget
+     */
+    'top_3_impression_rate'?: number;
+    /**
+     *
+     * @type {number}
+     * @memberof AnalyticsItemPerformanceWithWidget
+     */
+    'top_3_impressions'?: number;
+    /**
+     *
+     * @type {number}
+     * @memberof AnalyticsItemPerformanceWithWidget
+     */
+    'unique_filters'?: number;
+    /**
+     *
+     * @type {number}
+     * @memberof AnalyticsItemPerformanceWithWidget
+     */
+    'unique_queries'?: number;
+    /**
+     *
+     * @type {number}
+     * @memberof AnalyticsItemPerformanceWithWidget
+     */
+    'unique_searches'?: number;
+    /**
+     *
+     * @type {number}
+     * @memberof AnalyticsItemPerformanceWithWidget
+     */
+    'unique_sorts'?: number;
+    /**
+     *
+     * @type {number}
+     * @memberof AnalyticsItemPerformanceWithWidget
+     */
+    'unique_users'?: number;
+    /**
+     * Widget display data for UI presentation
+     * @type {AnalyticsWidgetData}
+     * @memberof 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
      */
-    'item_id'?: string;
+    'items'?: Array<AnalyticsItemPopularQuery>;
     /**
      *
-     * @type {string}
-     * @memberof AnalyticsItemPerformanceWithWidget
+     * @type {AnalyticsPaginationMeta}
+     * @memberof AnalyticsItemPopularQueriesSection
      */
-    'item_name'?: string;
+    'meta'?: AnalyticsPaginationMeta;
+}
+/**
+ *
+ * @export
+ * @interface AnalyticsItemPopularQuery
+ */
+export interface AnalyticsItemPopularQuery {
     /**
      *
      * @type {number}
-     * @memberof AnalyticsItemPerformanceWithWidget
+     * @memberof AnalyticsItemPopularQuery
      */
-    'revenue'?: number;
+    'avg_position'?: number;
     /**
      *
      * @type {number}
-     * @memberof AnalyticsItemPerformanceWithWidget
+     * @memberof AnalyticsItemPopularQuery
      */
-    'revenue_per_item'?: number;
+    'click_through_rate'?: number;
     /**
      *
      * @type {number}
-     * @memberof AnalyticsItemPerformanceWithWidget
+     * @memberof AnalyticsItemPopularQuery
      */
-    'top_10_impressions'?: number;
+    'clicks'?: number;
     /**
      *
      * @type {number}
-     * @memberof AnalyticsItemPerformanceWithWidget
+     * @memberof AnalyticsItemPopularQuery
      */
-    'top_3_impression_rate'?: number;
+    'impressions'?: number;
     /**
      *
-     * @type {number}
-     * @memberof AnalyticsItemPerformanceWithWidget
+     * @type {string}
+     * @memberof AnalyticsItemPopularQuery
      */
-    'top_3_impressions'?: number;
+    'query'?: string;
     /**
-     *
+     * percentage of total impressions for this item
      * @type {number}
-     * @memberof AnalyticsItemPerformanceWithWidget
+     * @memberof AnalyticsItemPopularQuery
      */
-    'unique_filters'?: number;
+    'share'?: number;
+}
+/**
+ *
+ * @export
+ * @interface AnalyticsItemPositionBucket
+ */
+export interface AnalyticsItemPositionBucket {
     /**
      *
      * @type {number}
-     * @memberof AnalyticsItemPerformanceWithWidget
+     * @memberof AnalyticsItemPositionBucket
      */
-    'unique_queries'?: number;
+    'click_rate'?: number;
     /**
      *
      * @type {number}
-     * @memberof AnalyticsItemPerformanceWithWidget
+     * @memberof AnalyticsItemPositionBucket
      */
-    'unique_searches'?: number;
+    'clicks'?: number;
     /**
      *
      * @type {number}
-     * @memberof AnalyticsItemPerformanceWithWidget
+     * @memberof AnalyticsItemPositionBucket
      */
-    'unique_sorts'?: number;
+    'impressions'?: number;
     /**
-     *
-     * @type {number}
-     * @memberof AnalyticsItemPerformanceWithWidget
+     * \"1\", \"2\", \"3\", \"4-5\", \"6-10\", \"11-20\", \"21+\"
+     * @type {string}
+     * @memberof AnalyticsItemPositionBucket
      */
-    'unique_users'?: number;
+    'position_range'?: string;
     /**
-     * Widget display data for UI presentation
-     * @type {AnalyticsWidgetData}
-     * @memberof AnalyticsItemPerformanceWithWidget
+     * percentage of total impressions for this item
+     * @type {number}
+     * @memberof AnalyticsItemPositionBucket
      */
-    'widget'?: AnalyticsWidgetData;
+    'share'?: number;
 }
 /**
  *
@@ -2834,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
@@ -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
@@ -13257,7 +13865,7 @@ 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 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
@@ -13274,12 +13882,14 @@ export declare const AnalyticsApiAxiosParamCreator: (configuration?: Configurati
      * @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) => 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
@@ -13622,7 +14232,7 @@ 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 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
@@ -13639,12 +14249,14 @@ export declare const AnalyticsApiFp: (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}
      */
-    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>>;
+    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
@@ -13987,7 +14599,7 @@ 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 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
@@ -14004,12 +14616,14 @@ export declare const AnalyticsApiFactory: (configuration?: Configuration, basePa
      * @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>;
+    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
@@ -14367,7 +14981,7 @@ 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 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
@@ -14384,13 +14998,15 @@ export declare 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
      */
-    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<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
@@ -16510,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
@@ -16642,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
@@ -16774,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
@@ -16912,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
@@ -17014,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
  */