@seekora-ai/admin-api 1.0.48 → 1.0.49

package/dist/esm/api.d.ts

@@ -1066,11 +1066,11 @@ export interface AnalyticsExtendedKPIResponse {
      */
     'compare_summary'?: AnalyticsKPIMetrics;
     /**
-     *
-     * @type {Array<AnalyticsKPIPointExtended>}
+     * Can be []KPIPointExtended or []ComparisonMetrics
+     * @type {object}
      * @memberof AnalyticsExtendedKPIResponse
      */
-    'data'?: Array<AnalyticsKPIPointExtended>;
+    'data'?: object;
     /**
      *
      * @type {string}
@@ -1138,12 +1138,24 @@ export interface AnalyticsFilterAnalyticsResponse {
      * @memberof AnalyticsFilterAnalyticsResponse
      */
     'filter_key'?: string;
+    /**
+     *
+     * @type {number}
+     * @memberof AnalyticsFilterAnalyticsResponse
+     */
+    'limit'?: number;
     /**
      *
      * @type {string}
      * @memberof AnalyticsFilterAnalyticsResponse
      */
     'org_id'?: string;
+    /**
+     *
+     * @type {number}
+     * @memberof AnalyticsFilterAnalyticsResponse
+     */
+    'page'?: number;
     /**
      *
      * @type {string}
@@ -1174,6 +1186,12 @@ export interface AnalyticsFilterAnalyticsResponse {
      * @memberof AnalyticsFilterAnalyticsResponse
      */
     'store_id'?: string;
+    /**
+     *
+     * @type {number}
+     * @memberof AnalyticsFilterAnalyticsResponse
+     */
+    'total'?: number;
 }
 /**
  *
@@ -1409,12 +1427,24 @@ export interface AnalyticsFilterTrendsResponse {
      * @memberof AnalyticsFilterTrendsResponse
      */
     'granularity'?: string;
+    /**
+     *
+     * @type {number}
+     * @memberof AnalyticsFilterTrendsResponse
+     */
+    'limit'?: number;
     /**
      *
      * @type {string}
      * @memberof AnalyticsFilterTrendsResponse
      */
     'org_id'?: string;
+    /**
+     *
+     * @type {number}
+     * @memberof AnalyticsFilterTrendsResponse
+     */
+    'page'?: number;
     /**
      *
      * @type {string}
@@ -1445,6 +1475,12 @@ export interface AnalyticsFilterTrendsResponse {
      * @memberof AnalyticsFilterTrendsResponse
      */
     'top_filters'?: number;
+    /**
+     *
+     * @type {number}
+     * @memberof AnalyticsFilterTrendsResponse
+     */
+    'total'?: number;
     /**
      *
      * @type {{ [key: string]: Array<AnalyticsTimeSeriesPoint>; }}
@@ -6015,11 +6051,17 @@ export interface DataTypesErrorMetaResponse {
  */
 export interface DataTypesEventPayload {
     /**
-     *
+     * Journey Tracking & Analytics
      * @type {Array<string>}
      * @memberof DataTypesEventPayload
      */
     'analytics_tags'?: Array<string>;
+    /**
+     * Anonymous user identifier
+     * @type {string}
+     * @memberof DataTypesEventPayload
+     */
+    'anon_id'?: string;
     /**
      *
      * @type {string}
@@ -6027,13 +6069,13 @@ export interface DataTypesEventPayload {
      */
     'city'?: string;
     /**
-     *
+     * Click/Interaction Event Fields
      * @type {string}
      * @memberof DataTypesEventPayload
      */
     'clicked_product_id'?: string;
     /**
-     * Geo data fields for direct submission
+     * Enhanced Geo data fields for direct submission
      * @type {string}
      * @memberof DataTypesEventPayload
      */
@@ -6044,6 +6086,12 @@ export interface DataTypesEventPayload {
      * @memberof DataTypesEventPayload
      */
     'country_code'?: string;
+    /**
+     * Currency for value
+     * @type {string}
+     * @memberof DataTypesEventPayload
+     */
+    'currency'?: string;
     /**
      *
      * @type {string}
@@ -6051,7 +6099,7 @@ export interface DataTypesEventPayload {
      */
     'device_type'?: string;
     /**
-     *
+     * Core Event Information
      * @type {string}
      * @memberof DataTypesEventPayload
      */
@@ -6063,25 +6111,25 @@ export interface DataTypesEventPayload {
      */
     'event_name'?: string;
     /**
-     *
+     * Device & Location Context
      * @type {string}
      * @memberof DataTypesEventPayload
      */
     'ip'?: string;
     /**
-     *
+     * Performance
      * @type {number}
      * @memberof DataTypesEventPayload
      */
     'latency_ms'?: number;
     /**
-     *
+     * Legacy field
      * @type {string}
      * @memberof DataTypesEventPayload
      */
     'location'?: string;
     /**
-     *
+     * Flexible metadata including search_id, position, etc.
      * @type {{ [key: string]: any; }}
      * @memberof DataTypesEventPayload
      */
@@ -6095,7 +6143,13 @@ export interface DataTypesEventPayload {
      */
     'org_id'?: string;
     /**
-     *
+     * web, ios, android
+     * @type {string}
+     * @memberof DataTypesEventPayload
+     */
+    'platform'?: string;
+    /**
+     * Search Event Fields
      * @type {string}
      * @memberof DataTypesEventPayload
      */
@@ -6113,7 +6167,13 @@ export interface DataTypesEventPayload {
      */
     'results_count'?: number;
     /**
-     *
+     * Session identifier for journey tracking
+     * @type {string}
+     * @memberof DataTypesEventPayload
+     */
+    'session_id'?: string;
+    /**
+     * Organization Context
      * @type {string}
      * @memberof DataTypesEventPayload
      */
@@ -6125,11 +6185,17 @@ export interface DataTypesEventPayload {
      */
     'timestamp'?: string;
     /**
-     *
+     * User Context
      * @type {string}
      * @memberof DataTypesEventPayload
      */
     'user_id'?: string;
+    /**
+     * Business Context
+     * @type {number}
+     * @memberof DataTypesEventPayload
+     */
+    'value'?: number;
 }
 /**
  *
@@ -13191,12 +13257,20 @@ export declare const AnalyticsApiAxiosParamCreator: (configuration?: Configurati
      */
     adminAnalyticsStoreXStoreIDQueriesNoResultsGet: (xStoreID: string, startTime?: string, endTime?: string, search?: string, analyticsTags?: string, tagsMatchMode?: AdminAnalyticsStoreXStoreIDQueriesNoResultsGetTagsMatchModeEnum, tagsExclude?: string, tagKeyFilter?: string, tagValueFilter?: string, compareMode?: boolean, compareStartTime?: string, compareEndTime?: string, compareAnalyticsTags?: string, compareTagsMatchMode?: AdminAnalyticsStoreXStoreIDQueriesNoResultsGetCompareTagsMatchModeEnum, compareTagsExclude?: string, compareTagKeyFilter?: string, compareTagValueFilter?: string, limit?: number, offset?: number, page?: number, pageSize?: number, sortBy?: AdminAnalyticsStoreXStoreIDQueriesNoResultsGetSortByEnum, sortOrder?: AdminAnalyticsStoreXStoreIDQueriesNoResultsGetSortOrderEnum, sort?: string, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
     /**
-     * Retrieve comprehensive analytics for a specific search query including popular results, filters, click position histogram, and performance metrics with independent pagination for popular results and filters
+     * Retrieve comprehensive analytics for a specific search query including popular results, filters, click position histogram, and performance metrics with deep comparison mode support and independent pagination for popular results and filters
      * @summary Get Query Insights
      * @param {string} xStoreID Store ID
      * @param {string} query Search query to analyze
      * @param {string} [startTime] Start time in RFC3339 format
      * @param {string} [endTime] End time in RFC3339 format
+     * @param {boolean} [compareMode] Enable comparison mode to compare with another time period/tag set
+     * @param {string} [compareStartTime] Comparison period start time in RFC3339 format
+     * @param {string} [compareEndTime] Comparison period end time in RFC3339 format
+     * @param {string} [compareAnalyticsTags] Comma-separated analytics tags for comparison period
+     * @param {AdminAnalyticsStoreXStoreIDQueriesQueryInsightsGetCompareTagsMatchModeEnum} [compareTagsMatchMode] How to match comparison analytics tags
+     * @param {string} [compareTagsExclude] Comma-separated analytics tags to exclude in comparison
+     * @param {string} [compareTagKeyFilter] Tag key filter for comparison period
+     * @param {string} [compareTagValueFilter] Tag value filter for comparison period
      * @param {number} [resultsPage] Page number for popular results pagination
      * @param {number} [resultsPageSize] Number of results per page for popular results
      * @param {number} [filtersPage] Page number for popular filters pagination
@@ -13205,7 +13279,7 @@ export declare const AnalyticsApiAxiosParamCreator: (configuration?: Configurati
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
-    adminAnalyticsStoreXStoreIDQueriesQueryInsightsGet: (xStoreID: string, query: string, startTime?: string, endTime?: string, resultsPage?: number, resultsPageSize?: number, filtersPage?: number, filtersPageSize?: number, includeWidget?: boolean, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
+    adminAnalyticsStoreXStoreIDQueriesQueryInsightsGet: (xStoreID: string, query: string, startTime?: string, endTime?: string, compareMode?: boolean, compareStartTime?: string, compareEndTime?: string, compareAnalyticsTags?: string, compareTagsMatchMode?: AdminAnalyticsStoreXStoreIDQueriesQueryInsightsGetCompareTagsMatchModeEnum, compareTagsExclude?: string, compareTagKeyFilter?: string, compareTagValueFilter?: string, resultsPage?: number, resultsPageSize?: number, filtersPage?: number, filtersPageSize?: number, includeWidget?: boolean, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
     /**
      * Retrieve analytics for top performing search results with optional enrichment. By default returns widget display fields for UI presentation. Use include_documents=true for full document data (heavier response). Supports lightweight widget-only mode for dashboards with analytics tags filtering and comparison mode support.
      * @summary Get Top Results Analytics
@@ -13548,12 +13622,20 @@ export declare const AnalyticsApiFp: (configuration?: Configuration) => {
      */
     adminAnalyticsStoreXStoreIDQueriesNoResultsGet(xStoreID: string, startTime?: string, endTime?: string, search?: string, analyticsTags?: string, tagsMatchMode?: AdminAnalyticsStoreXStoreIDQueriesNoResultsGetTagsMatchModeEnum, tagsExclude?: string, tagKeyFilter?: string, tagValueFilter?: string, compareMode?: boolean, compareStartTime?: string, compareEndTime?: string, compareAnalyticsTags?: string, compareTagsMatchMode?: AdminAnalyticsStoreXStoreIDQueriesNoResultsGetCompareTagsMatchModeEnum, compareTagsExclude?: string, compareTagKeyFilter?: string, compareTagValueFilter?: string, limit?: number, offset?: number, page?: number, pageSize?: number, sortBy?: AdminAnalyticsStoreXStoreIDQueriesNoResultsGetSortByEnum, sortOrder?: AdminAnalyticsStoreXStoreIDQueriesNoResultsGetSortOrderEnum, sort?: string, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<AdminAnalyticsStoreXStoreIDQueriesNoClicksGet200Response>>;
     /**
-     * Retrieve comprehensive analytics for a specific search query including popular results, filters, click position histogram, and performance metrics with independent pagination for popular results and filters
+     * Retrieve comprehensive analytics for a specific search query including popular results, filters, click position histogram, and performance metrics with deep comparison mode support and independent pagination for popular results and filters
      * @summary Get Query Insights
      * @param {string} xStoreID Store ID
      * @param {string} query Search query to analyze
      * @param {string} [startTime] Start time in RFC3339 format
      * @param {string} [endTime] End time in RFC3339 format
+     * @param {boolean} [compareMode] Enable comparison mode to compare with another time period/tag set
+     * @param {string} [compareStartTime] Comparison period start time in RFC3339 format
+     * @param {string} [compareEndTime] Comparison period end time in RFC3339 format
+     * @param {string} [compareAnalyticsTags] Comma-separated analytics tags for comparison period
+     * @param {AdminAnalyticsStoreXStoreIDQueriesQueryInsightsGetCompareTagsMatchModeEnum} [compareTagsMatchMode] How to match comparison analytics tags
+     * @param {string} [compareTagsExclude] Comma-separated analytics tags to exclude in comparison
+     * @param {string} [compareTagKeyFilter] Tag key filter for comparison period
+     * @param {string} [compareTagValueFilter] Tag value filter for comparison period
      * @param {number} [resultsPage] Page number for popular results pagination
      * @param {number} [resultsPageSize] Number of results per page for popular results
      * @param {number} [filtersPage] Page number for popular filters pagination
@@ -13562,7 +13644,7 @@ export declare const AnalyticsApiFp: (configuration?: Configuration) => {
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
-    adminAnalyticsStoreXStoreIDQueriesQueryInsightsGet(xStoreID: string, query: string, startTime?: string, endTime?: string, resultsPage?: number, resultsPageSize?: number, filtersPage?: number, filtersPageSize?: number, includeWidget?: boolean, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<AdminAnalyticsStoreXStoreIDQueriesQueryInsightsGet200Response>>;
+    adminAnalyticsStoreXStoreIDQueriesQueryInsightsGet(xStoreID: string, query: string, startTime?: string, endTime?: string, compareMode?: boolean, compareStartTime?: string, compareEndTime?: string, compareAnalyticsTags?: string, compareTagsMatchMode?: AdminAnalyticsStoreXStoreIDQueriesQueryInsightsGetCompareTagsMatchModeEnum, compareTagsExclude?: string, compareTagKeyFilter?: string, compareTagValueFilter?: string, resultsPage?: number, resultsPageSize?: number, filtersPage?: number, filtersPageSize?: number, includeWidget?: boolean, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<AdminAnalyticsStoreXStoreIDQueriesQueryInsightsGet200Response>>;
     /**
      * Retrieve analytics for top performing search results with optional enrichment. By default returns widget display fields for UI presentation. Use include_documents=true for full document data (heavier response). Supports lightweight widget-only mode for dashboards with analytics tags filtering and comparison mode support.
      * @summary Get Top Results Analytics
@@ -13905,12 +13987,20 @@ export declare const AnalyticsApiFactory: (configuration?: Configuration, basePa
      */
     adminAnalyticsStoreXStoreIDQueriesNoResultsGet(xStoreID: string, startTime?: string, endTime?: string, search?: string, analyticsTags?: string, tagsMatchMode?: AdminAnalyticsStoreXStoreIDQueriesNoResultsGetTagsMatchModeEnum, tagsExclude?: string, tagKeyFilter?: string, tagValueFilter?: string, compareMode?: boolean, compareStartTime?: string, compareEndTime?: string, compareAnalyticsTags?: string, compareTagsMatchMode?: AdminAnalyticsStoreXStoreIDQueriesNoResultsGetCompareTagsMatchModeEnum, compareTagsExclude?: string, compareTagKeyFilter?: string, compareTagValueFilter?: string, limit?: number, offset?: number, page?: number, pageSize?: number, sortBy?: AdminAnalyticsStoreXStoreIDQueriesNoResultsGetSortByEnum, sortOrder?: AdminAnalyticsStoreXStoreIDQueriesNoResultsGetSortOrderEnum, sort?: string, options?: RawAxiosRequestConfig): AxiosPromise<AdminAnalyticsStoreXStoreIDQueriesNoClicksGet200Response>;
     /**
-     * Retrieve comprehensive analytics for a specific search query including popular results, filters, click position histogram, and performance metrics with independent pagination for popular results and filters
+     * Retrieve comprehensive analytics for a specific search query including popular results, filters, click position histogram, and performance metrics with deep comparison mode support and independent pagination for popular results and filters
      * @summary Get Query Insights
      * @param {string} xStoreID Store ID
      * @param {string} query Search query to analyze
      * @param {string} [startTime] Start time in RFC3339 format
      * @param {string} [endTime] End time in RFC3339 format
+     * @param {boolean} [compareMode] Enable comparison mode to compare with another time period/tag set
+     * @param {string} [compareStartTime] Comparison period start time in RFC3339 format
+     * @param {string} [compareEndTime] Comparison period end time in RFC3339 format
+     * @param {string} [compareAnalyticsTags] Comma-separated analytics tags for comparison period
+     * @param {AdminAnalyticsStoreXStoreIDQueriesQueryInsightsGetCompareTagsMatchModeEnum} [compareTagsMatchMode] How to match comparison analytics tags
+     * @param {string} [compareTagsExclude] Comma-separated analytics tags to exclude in comparison
+     * @param {string} [compareTagKeyFilter] Tag key filter for comparison period
+     * @param {string} [compareTagValueFilter] Tag value filter for comparison period
      * @param {number} [resultsPage] Page number for popular results pagination
      * @param {number} [resultsPageSize] Number of results per page for popular results
      * @param {number} [filtersPage] Page number for popular filters pagination
@@ -13919,7 +14009,7 @@ export declare const AnalyticsApiFactory: (configuration?: Configuration, basePa
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
-    adminAnalyticsStoreXStoreIDQueriesQueryInsightsGet(xStoreID: string, query: string, startTime?: string, endTime?: string, resultsPage?: number, resultsPageSize?: number, filtersPage?: number, filtersPageSize?: number, includeWidget?: boolean, options?: RawAxiosRequestConfig): AxiosPromise<AdminAnalyticsStoreXStoreIDQueriesQueryInsightsGet200Response>;
+    adminAnalyticsStoreXStoreIDQueriesQueryInsightsGet(xStoreID: string, query: string, startTime?: string, endTime?: string, compareMode?: boolean, compareStartTime?: string, compareEndTime?: string, compareAnalyticsTags?: string, compareTagsMatchMode?: AdminAnalyticsStoreXStoreIDQueriesQueryInsightsGetCompareTagsMatchModeEnum, compareTagsExclude?: string, compareTagKeyFilter?: string, compareTagValueFilter?: string, resultsPage?: number, resultsPageSize?: number, filtersPage?: number, filtersPageSize?: number, includeWidget?: boolean, options?: RawAxiosRequestConfig): AxiosPromise<AdminAnalyticsStoreXStoreIDQueriesQueryInsightsGet200Response>;
     /**
      * Retrieve analytics for top performing search results with optional enrichment. By default returns widget display fields for UI presentation. Use include_documents=true for full document data (heavier response). Supports lightweight widget-only mode for dashboards with analytics tags filtering and comparison mode support.
      * @summary Get Top Results Analytics
@@ -14277,12 +14367,20 @@ export declare class AnalyticsApi extends BaseAPI {
      */
     adminAnalyticsStoreXStoreIDQueriesNoResultsGet(xStoreID: string, startTime?: string, endTime?: string, search?: string, analyticsTags?: string, tagsMatchMode?: AdminAnalyticsStoreXStoreIDQueriesNoResultsGetTagsMatchModeEnum, tagsExclude?: string, tagKeyFilter?: string, tagValueFilter?: string, compareMode?: boolean, compareStartTime?: string, compareEndTime?: string, compareAnalyticsTags?: string, compareTagsMatchMode?: AdminAnalyticsStoreXStoreIDQueriesNoResultsGetCompareTagsMatchModeEnum, compareTagsExclude?: string, compareTagKeyFilter?: string, compareTagValueFilter?: string, limit?: number, offset?: number, page?: number, pageSize?: number, sortBy?: AdminAnalyticsStoreXStoreIDQueriesNoResultsGetSortByEnum, sortOrder?: AdminAnalyticsStoreXStoreIDQueriesNoResultsGetSortOrderEnum, sort?: string, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<AdminAnalyticsStoreXStoreIDQueriesNoClicksGet200Response, any, {}>>;
     /**
-     * Retrieve comprehensive analytics for a specific search query including popular results, filters, click position histogram, and performance metrics with independent pagination for popular results and filters
+     * Retrieve comprehensive analytics for a specific search query including popular results, filters, click position histogram, and performance metrics with deep comparison mode support and independent pagination for popular results and filters
      * @summary Get Query Insights
      * @param {string} xStoreID Store ID
      * @param {string} query Search query to analyze
      * @param {string} [startTime] Start time in RFC3339 format
      * @param {string} [endTime] End time in RFC3339 format
+     * @param {boolean} [compareMode] Enable comparison mode to compare with another time period/tag set
+     * @param {string} [compareStartTime] Comparison period start time in RFC3339 format
+     * @param {string} [compareEndTime] Comparison period end time in RFC3339 format
+     * @param {string} [compareAnalyticsTags] Comma-separated analytics tags for comparison period
+     * @param {AdminAnalyticsStoreXStoreIDQueriesQueryInsightsGetCompareTagsMatchModeEnum} [compareTagsMatchMode] How to match comparison analytics tags
+     * @param {string} [compareTagsExclude] Comma-separated analytics tags to exclude in comparison
+     * @param {string} [compareTagKeyFilter] Tag key filter for comparison period
+     * @param {string} [compareTagValueFilter] Tag value filter for comparison period
      * @param {number} [resultsPage] Page number for popular results pagination
      * @param {number} [resultsPageSize] Number of results per page for popular results
      * @param {number} [filtersPage] Page number for popular filters pagination
@@ -14292,7 +14390,7 @@ export declare class AnalyticsApi extends BaseAPI {
      * @throws {RequiredError}
      * @memberof AnalyticsApi
      */
-    adminAnalyticsStoreXStoreIDQueriesQueryInsightsGet(xStoreID: string, query: string, startTime?: string, endTime?: string, resultsPage?: number, resultsPageSize?: number, filtersPage?: number, filtersPageSize?: number, includeWidget?: boolean, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<AdminAnalyticsStoreXStoreIDQueriesQueryInsightsGet200Response, any, {}>>;
+    adminAnalyticsStoreXStoreIDQueriesQueryInsightsGet(xStoreID: string, query: string, startTime?: string, endTime?: string, compareMode?: boolean, compareStartTime?: string, compareEndTime?: string, compareAnalyticsTags?: string, compareTagsMatchMode?: AdminAnalyticsStoreXStoreIDQueriesQueryInsightsGetCompareTagsMatchModeEnum, compareTagsExclude?: string, compareTagKeyFilter?: string, compareTagValueFilter?: string, resultsPage?: number, resultsPageSize?: number, filtersPage?: number, filtersPageSize?: number, includeWidget?: boolean, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<AdminAnalyticsStoreXStoreIDQueriesQueryInsightsGet200Response, any, {}>>;
     /**
      * Retrieve analytics for top performing search results with optional enrichment. By default returns widget display fields for UI presentation. Use include_documents=true for full document data (heavier response). Supports lightweight widget-only mode for dashboards with analytics tags filtering and comparison mode support.
      * @summary Get Top Results Analytics
@@ -14658,6 +14756,14 @@ export declare const AdminAnalyticsStoreXStoreIDQueriesNoResultsGetSortOrderEnum
     readonly Desc: "desc";
 };
 export type AdminAnalyticsStoreXStoreIDQueriesNoResultsGetSortOrderEnum = typeof AdminAnalyticsStoreXStoreIDQueriesNoResultsGetSortOrderEnum[keyof typeof AdminAnalyticsStoreXStoreIDQueriesNoResultsGetSortOrderEnum];
+/**
+ * @export
+ */
+export declare const AdminAnalyticsStoreXStoreIDQueriesQueryInsightsGetCompareTagsMatchModeEnum: {
+    readonly Any: "any";
+    readonly All: "all";
+};
+export type AdminAnalyticsStoreXStoreIDQueriesQueryInsightsGetCompareTagsMatchModeEnum = typeof AdminAnalyticsStoreXStoreIDQueriesQueryInsightsGetCompareTagsMatchModeEnum[keyof typeof AdminAnalyticsStoreXStoreIDQueriesQueryInsightsGetCompareTagsMatchModeEnum];
 /**
  * @export
  */

package/dist/esm/api.js

@@ -1993,12 +1993,20 @@ export const AnalyticsApiAxiosParamCreator = function (configuration) {
             };
         }),
         /**
-         * Retrieve comprehensive analytics for a specific search query including popular results, filters, click position histogram, and performance metrics with independent pagination for popular results and filters
+         * Retrieve comprehensive analytics for a specific search query including popular results, filters, click position histogram, and performance metrics with deep comparison mode support and independent pagination for popular results and filters
          * @summary Get Query Insights
          * @param {string} xStoreID Store ID
          * @param {string} query Search query to analyze
          * @param {string} [startTime] Start time in RFC3339 format
          * @param {string} [endTime] End time in RFC3339 format
+         * @param {boolean} [compareMode] Enable comparison mode to compare with another time period/tag set
+         * @param {string} [compareStartTime] Comparison period start time in RFC3339 format
+         * @param {string} [compareEndTime] Comparison period end time in RFC3339 format
+         * @param {string} [compareAnalyticsTags] Comma-separated analytics tags for comparison period
+         * @param {AdminAnalyticsStoreXStoreIDQueriesQueryInsightsGetCompareTagsMatchModeEnum} [compareTagsMatchMode] How to match comparison analytics tags
+         * @param {string} [compareTagsExclude] Comma-separated analytics tags to exclude in comparison
+         * @param {string} [compareTagKeyFilter] Tag key filter for comparison period
+         * @param {string} [compareTagValueFilter] Tag value filter for comparison period
          * @param {number} [resultsPage] Page number for popular results pagination
          * @param {number} [resultsPageSize] Number of results per page for popular results
          * @param {number} [filtersPage] Page number for popular filters pagination
@@ -2007,7 +2015,7 @@ export const AnalyticsApiAxiosParamCreator = function (configuration) {
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
          */
-        adminAnalyticsStoreXStoreIDQueriesQueryInsightsGet: (xStoreID_1, query_1, startTime_1, endTime_1, resultsPage_1, resultsPageSize_1, filtersPage_1, filtersPageSize_1, includeWidget_1, ...args_1) => __awaiter(this, [xStoreID_1, query_1, startTime_1, endTime_1, resultsPage_1, resultsPageSize_1, filtersPage_1, filtersPageSize_1, includeWidget_1, ...args_1], void 0, function* (xStoreID, query, startTime, endTime, resultsPage, resultsPageSize, filtersPage, filtersPageSize, includeWidget, options = {}) {
+        adminAnalyticsStoreXStoreIDQueriesQueryInsightsGet: (xStoreID_1, query_1, startTime_1, endTime_1, compareMode_1, compareStartTime_1, compareEndTime_1, compareAnalyticsTags_1, compareTagsMatchMode_1, compareTagsExclude_1, compareTagKeyFilter_1, compareTagValueFilter_1, resultsPage_1, resultsPageSize_1, filtersPage_1, filtersPageSize_1, includeWidget_1, ...args_1) => __awaiter(this, [xStoreID_1, query_1, startTime_1, endTime_1, compareMode_1, compareStartTime_1, compareEndTime_1, compareAnalyticsTags_1, compareTagsMatchMode_1, compareTagsExclude_1, compareTagKeyFilter_1, compareTagValueFilter_1, resultsPage_1, resultsPageSize_1, filtersPage_1, filtersPageSize_1, includeWidget_1, ...args_1], void 0, function* (xStoreID, query, startTime, endTime, compareMode, compareStartTime, compareEndTime, compareAnalyticsTags, compareTagsMatchMode, compareTagsExclude, compareTagKeyFilter, compareTagValueFilter, resultsPage, resultsPageSize, filtersPage, filtersPageSize, includeWidget, options = {}) {
             // verify required parameter 'xStoreID' is not null or undefined
             assertParamExists('adminAnalyticsStoreXStoreIDQueriesQueryInsightsGet', 'xStoreID', xStoreID);
             // verify required parameter 'query' is not null or undefined
@@ -2032,6 +2040,30 @@ export const AnalyticsApiAxiosParamCreator = function (configuration) {
             if (endTime !== undefined) {
                 localVarQueryParameter['end_time'] = endTime;
             }
+            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;
             }
@@ -2713,12 +2745,20 @@ export const AnalyticsApiFp = function (configuration) {
             });
         },
         /**
-         * Retrieve comprehensive analytics for a specific search query including popular results, filters, click position histogram, and performance metrics with independent pagination for popular results and filters
+         * Retrieve comprehensive analytics for a specific search query including popular results, filters, click position histogram, and performance metrics with deep comparison mode support and independent pagination for popular results and filters
          * @summary Get Query Insights
          * @param {string} xStoreID Store ID
          * @param {string} query Search query to analyze
          * @param {string} [startTime] Start time in RFC3339 format
          * @param {string} [endTime] End time in RFC3339 format
+         * @param {boolean} [compareMode] Enable comparison mode to compare with another time period/tag set
+         * @param {string} [compareStartTime] Comparison period start time in RFC3339 format
+         * @param {string} [compareEndTime] Comparison period end time in RFC3339 format
+         * @param {string} [compareAnalyticsTags] Comma-separated analytics tags for comparison period
+         * @param {AdminAnalyticsStoreXStoreIDQueriesQueryInsightsGetCompareTagsMatchModeEnum} [compareTagsMatchMode] How to match comparison analytics tags
+         * @param {string} [compareTagsExclude] Comma-separated analytics tags to exclude in comparison
+         * @param {string} [compareTagKeyFilter] Tag key filter for comparison period
+         * @param {string} [compareTagValueFilter] Tag value filter for comparison period
          * @param {number} [resultsPage] Page number for popular results pagination
          * @param {number} [resultsPageSize] Number of results per page for popular results
          * @param {number} [filtersPage] Page number for popular filters pagination
@@ -2727,10 +2767,10 @@ export const AnalyticsApiFp = function (configuration) {
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
          */
-        adminAnalyticsStoreXStoreIDQueriesQueryInsightsGet(xStoreID, query, startTime, endTime, resultsPage, resultsPageSize, filtersPage, filtersPageSize, includeWidget, options) {
+        adminAnalyticsStoreXStoreIDQueriesQueryInsightsGet(xStoreID, query, startTime, endTime, compareMode, compareStartTime, compareEndTime, compareAnalyticsTags, compareTagsMatchMode, compareTagsExclude, compareTagKeyFilter, compareTagValueFilter, resultsPage, resultsPageSize, filtersPage, filtersPageSize, includeWidget, options) {
             return __awaiter(this, void 0, void 0, function* () {
                 var _a, _b, _c;
-                const localVarAxiosArgs = yield localVarAxiosParamCreator.adminAnalyticsStoreXStoreIDQueriesQueryInsightsGet(xStoreID, query, startTime, endTime, resultsPage, resultsPageSize, filtersPage, filtersPageSize, includeWidget, options);
+                const localVarAxiosArgs = yield localVarAxiosParamCreator.adminAnalyticsStoreXStoreIDQueriesQueryInsightsGet(xStoreID, query, startTime, endTime, compareMode, compareStartTime, compareEndTime, compareAnalyticsTags, compareTagsMatchMode, compareTagsExclude, compareTagKeyFilter, compareTagValueFilter, resultsPage, resultsPageSize, filtersPage, filtersPageSize, includeWidget, options);
                 const localVarOperationServerIndex = (_a = configuration === null || configuration === void 0 ? void 0 : configuration.serverIndex) !== null && _a !== void 0 ? _a : 0;
                 const localVarOperationServerBasePath = (_c = (_b = operationServerMap['AnalyticsApi.adminAnalyticsStoreXStoreIDQueriesQueryInsightsGet']) === null || _b === void 0 ? void 0 : _b[localVarOperationServerIndex]) === null || _c === void 0 ? void 0 : _c.url;
                 return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
@@ -3131,12 +3171,20 @@ export const AnalyticsApiFactory = function (configuration, basePath, axios) {
             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 independent pagination for popular results and filters
+         * 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
          * @summary Get Query Insights
          * @param {string} xStoreID Store ID
          * @param {string} query Search query to analyze
          * @param {string} [startTime] Start time in RFC3339 format
          * @param {string} [endTime] End time in RFC3339 format
+         * @param {boolean} [compareMode] Enable comparison mode to compare with another time period/tag set
+         * @param {string} [compareStartTime] Comparison period start time in RFC3339 format
+         * @param {string} [compareEndTime] Comparison period end time in RFC3339 format
+         * @param {string} [compareAnalyticsTags] Comma-separated analytics tags for comparison period
+         * @param {AdminAnalyticsStoreXStoreIDQueriesQueryInsightsGetCompareTagsMatchModeEnum} [compareTagsMatchMode] How to match comparison analytics tags
+         * @param {string} [compareTagsExclude] Comma-separated analytics tags to exclude in comparison
+         * @param {string} [compareTagKeyFilter] Tag key filter for comparison period
+         * @param {string} [compareTagValueFilter] Tag value filter for comparison period
          * @param {number} [resultsPage] Page number for popular results pagination
          * @param {number} [resultsPageSize] Number of results per page for popular results
          * @param {number} [filtersPage] Page number for popular filters pagination
@@ -3145,8 +3193,8 @@ export const AnalyticsApiFactory = function (configuration, basePath, axios) {
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
          */
-        adminAnalyticsStoreXStoreIDQueriesQueryInsightsGet(xStoreID, query, startTime, endTime, resultsPage, resultsPageSize, filtersPage, filtersPageSize, includeWidget, options) {
-            return localVarFp.adminAnalyticsStoreXStoreIDQueriesQueryInsightsGet(xStoreID, query, startTime, endTime, resultsPage, resultsPageSize, filtersPage, filtersPageSize, includeWidget, options).then((request) => request(axios, basePath));
+        adminAnalyticsStoreXStoreIDQueriesQueryInsightsGet(xStoreID, query, startTime, endTime, compareMode, compareStartTime, compareEndTime, compareAnalyticsTags, compareTagsMatchMode, compareTagsExclude, compareTagKeyFilter, compareTagValueFilter, resultsPage, resultsPageSize, filtersPage, filtersPageSize, includeWidget, options) {
+            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));
         },
         /**
          * 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.
@@ -3538,12 +3586,20 @@ export class AnalyticsApi extends BaseAPI {
         return AnalyticsApiFp(this.configuration).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(this.axios, this.basePath));
     }
     /**
-     * Retrieve comprehensive analytics for a specific search query including popular results, filters, click position histogram, and performance metrics with independent pagination for popular results and filters
+     * Retrieve comprehensive analytics for a specific search query including popular results, filters, click position histogram, and performance metrics with deep comparison mode support and independent pagination for popular results and filters
      * @summary Get Query Insights
      * @param {string} xStoreID Store ID
      * @param {string} query Search query to analyze
      * @param {string} [startTime] Start time in RFC3339 format
      * @param {string} [endTime] End time in RFC3339 format
+     * @param {boolean} [compareMode] Enable comparison mode to compare with another time period/tag set
+     * @param {string} [compareStartTime] Comparison period start time in RFC3339 format
+     * @param {string} [compareEndTime] Comparison period end time in RFC3339 format
+     * @param {string} [compareAnalyticsTags] Comma-separated analytics tags for comparison period
+     * @param {AdminAnalyticsStoreXStoreIDQueriesQueryInsightsGetCompareTagsMatchModeEnum} [compareTagsMatchMode] How to match comparison analytics tags
+     * @param {string} [compareTagsExclude] Comma-separated analytics tags to exclude in comparison
+     * @param {string} [compareTagKeyFilter] Tag key filter for comparison period
+     * @param {string} [compareTagValueFilter] Tag value filter for comparison period
      * @param {number} [resultsPage] Page number for popular results pagination
      * @param {number} [resultsPageSize] Number of results per page for popular results
      * @param {number} [filtersPage] Page number for popular filters pagination
@@ -3553,8 +3609,8 @@ export class AnalyticsApi extends BaseAPI {
      * @throws {RequiredError}
      * @memberof AnalyticsApi
      */
-    adminAnalyticsStoreXStoreIDQueriesQueryInsightsGet(xStoreID, query, startTime, endTime, resultsPage, resultsPageSize, filtersPage, filtersPageSize, includeWidget, options) {
-        return AnalyticsApiFp(this.configuration).adminAnalyticsStoreXStoreIDQueriesQueryInsightsGet(xStoreID, query, startTime, endTime, resultsPage, resultsPageSize, filtersPage, filtersPageSize, includeWidget, options).then((request) => request(this.axios, this.basePath));
+    adminAnalyticsStoreXStoreIDQueriesQueryInsightsGet(xStoreID, query, startTime, endTime, compareMode, compareStartTime, compareEndTime, compareAnalyticsTags, compareTagsMatchMode, compareTagsExclude, compareTagKeyFilter, compareTagValueFilter, resultsPage, resultsPageSize, filtersPage, filtersPageSize, includeWidget, options) {
+        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));
     }
     /**
      * 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.
@@ -3896,6 +3952,13 @@ export const AdminAnalyticsStoreXStoreIDQueriesNoResultsGetSortOrderEnum = {
     Asc: 'asc',
     Desc: 'desc'
 };
+/**
+ * @export
+ */
+export const AdminAnalyticsStoreXStoreIDQueriesQueryInsightsGetCompareTagsMatchModeEnum = {
+    Any: 'any',
+    All: 'all'
+};
 /**
  * @export
  */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@seekora-ai/admin-api",
-  "version": "1.0.48",
+  "version": "1.0.49",
   "description": "OpenAPI client for @seekora-ai/admin-api",
   "author": "OpenAPI-Generator Contributors",
   "repository": {