@seekora-ai/admin-api 1.0.48 → 1.0.50

package/dist/esm/api.js

@@ -1993,21 +1993,31 @@ 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, geo analytics, and performance metrics with deep comparison mode support and independent pagination for popular results and filters
          * @summary Get Query Insights
          * @param {string} xStoreID Store ID
          * @param {string} query Search query to analyze
          * @param {string} [startTime] Start time in RFC3339 format
          * @param {string} [endTime] End time in RFC3339 format
+         * @param {boolean} [compareMode] Enable comparison mode to compare with another time period/tag set
+         * @param {string} [compareStartTime] Comparison period start time in RFC3339 format
+         * @param {string} [compareEndTime] Comparison period end time in RFC3339 format
+         * @param {string} [compareAnalyticsTags] Comma-separated analytics tags for comparison period
+         * @param {AdminAnalyticsStoreXStoreIDQueriesQueryInsightsGetCompareTagsMatchModeEnum} [compareTagsMatchMode] How to match comparison analytics tags
+         * @param {string} [compareTagsExclude] Comma-separated analytics tags to exclude in comparison
+         * @param {string} [compareTagKeyFilter] Tag key filter for comparison period
+         * @param {string} [compareTagValueFilter] Tag value filter for comparison period
          * @param {number} [resultsPage] Page number for popular results pagination
          * @param {number} [resultsPageSize] Number of results per page for popular results
          * @param {number} [filtersPage] Page number for popular filters pagination
-         * @param {number} [filtersPageSize] Number of filters per page for popular filters
+         * @param {number} [filtersPageSize] Number of filters per page
+         * @param {number} [geoPage] Page number for geo analytics pagination
+         * @param {number} [geoPageSize] Number of geo locations per page
          * @param {boolean} [includeWidget] Whether to include widget display fields for popular results
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
          */
-        adminAnalyticsStoreXStoreIDQueriesQueryInsightsGet: (xStoreID_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, geoPage_1, geoPageSize_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, geoPage_1, geoPageSize_1, includeWidget_1, ...args_1], void 0, function* (xStoreID, query, startTime, endTime, compareMode, compareStartTime, compareEndTime, compareAnalyticsTags, compareTagsMatchMode, compareTagsExclude, compareTagKeyFilter, compareTagValueFilter, resultsPage, resultsPageSize, filtersPage, filtersPageSize, geoPage, geoPageSize, 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 +2042,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;
             }
@@ -2044,6 +2078,12 @@ export const AnalyticsApiAxiosParamCreator = function (configuration) {
             if (filtersPageSize !== undefined) {
                 localVarQueryParameter['filters_page_size'] = filtersPageSize;
             }
+            if (geoPage !== undefined) {
+                localVarQueryParameter['geo_page'] = geoPage;
+            }
+            if (geoPageSize !== undefined) {
+                localVarQueryParameter['geo_page_size'] = geoPageSize;
+            }
             if (includeWidget !== undefined) {
                 localVarQueryParameter['include_widget'] = includeWidget;
             }
@@ -2713,24 +2753,34 @@ 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, geo analytics, and performance metrics with deep comparison mode support and independent pagination for popular results and filters
          * @summary Get Query Insights
          * @param {string} xStoreID Store ID
          * @param {string} query Search query to analyze
          * @param {string} [startTime] Start time in RFC3339 format
          * @param {string} [endTime] End time in RFC3339 format
+         * @param {boolean} [compareMode] Enable comparison mode to compare with another time period/tag set
+         * @param {string} [compareStartTime] Comparison period start time in RFC3339 format
+         * @param {string} [compareEndTime] Comparison period end time in RFC3339 format
+         * @param {string} [compareAnalyticsTags] Comma-separated analytics tags for comparison period
+         * @param {AdminAnalyticsStoreXStoreIDQueriesQueryInsightsGetCompareTagsMatchModeEnum} [compareTagsMatchMode] How to match comparison analytics tags
+         * @param {string} [compareTagsExclude] Comma-separated analytics tags to exclude in comparison
+         * @param {string} [compareTagKeyFilter] Tag key filter for comparison period
+         * @param {string} [compareTagValueFilter] Tag value filter for comparison period
          * @param {number} [resultsPage] Page number for popular results pagination
          * @param {number} [resultsPageSize] Number of results per page for popular results
          * @param {number} [filtersPage] Page number for popular filters pagination
-         * @param {number} [filtersPageSize] Number of filters per page for popular filters
+         * @param {number} [filtersPageSize] Number of filters per page
+         * @param {number} [geoPage] Page number for geo analytics pagination
+         * @param {number} [geoPageSize] Number of geo locations per page
          * @param {boolean} [includeWidget] Whether to include widget display fields for popular results
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
          */
-        adminAnalyticsStoreXStoreIDQueriesQueryInsightsGet(xStoreID, 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, geoPage, geoPageSize, 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, geoPage, geoPageSize, 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,22 +3181,32 @@ 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, geo analytics, and performance metrics with deep comparison mode support and independent pagination for popular results and filters
          * @summary Get Query Insights
          * @param {string} xStoreID Store ID
          * @param {string} query Search query to analyze
          * @param {string} [startTime] Start time in RFC3339 format
          * @param {string} [endTime] End time in RFC3339 format
+         * @param {boolean} [compareMode] Enable comparison mode to compare with another time period/tag set
+         * @param {string} [compareStartTime] Comparison period start time in RFC3339 format
+         * @param {string} [compareEndTime] Comparison period end time in RFC3339 format
+         * @param {string} [compareAnalyticsTags] Comma-separated analytics tags for comparison period
+         * @param {AdminAnalyticsStoreXStoreIDQueriesQueryInsightsGetCompareTagsMatchModeEnum} [compareTagsMatchMode] How to match comparison analytics tags
+         * @param {string} [compareTagsExclude] Comma-separated analytics tags to exclude in comparison
+         * @param {string} [compareTagKeyFilter] Tag key filter for comparison period
+         * @param {string} [compareTagValueFilter] Tag value filter for comparison period
          * @param {number} [resultsPage] Page number for popular results pagination
          * @param {number} [resultsPageSize] Number of results per page for popular results
          * @param {number} [filtersPage] Page number for popular filters pagination
-         * @param {number} [filtersPageSize] Number of filters per page for popular filters
+         * @param {number} [filtersPageSize] Number of filters per page
+         * @param {number} [geoPage] Page number for geo analytics pagination
+         * @param {number} [geoPageSize] Number of geo locations per page
          * @param {boolean} [includeWidget] Whether to include widget display fields for popular results
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
          */
-        adminAnalyticsStoreXStoreIDQueriesQueryInsightsGet(xStoreID, 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, geoPage, geoPageSize, includeWidget, options) {
+            return localVarFp.adminAnalyticsStoreXStoreIDQueriesQueryInsightsGet(xStoreID, query, startTime, endTime, compareMode, compareStartTime, compareEndTime, compareAnalyticsTags, compareTagsMatchMode, compareTagsExclude, compareTagKeyFilter, compareTagValueFilter, resultsPage, resultsPageSize, filtersPage, filtersPageSize, geoPage, geoPageSize, includeWidget, options).then((request) => request(axios, basePath));
         },
         /**
          * Retrieve analytics for top performing search results with optional enrichment. By default returns widget display fields for UI presentation. Use include_documents=true for full document data (heavier response). Supports lightweight widget-only mode for dashboards with analytics tags filtering and comparison mode support.
@@ -3538,23 +3598,33 @@ 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, geo analytics, and performance metrics with deep comparison mode support and independent pagination for popular results and filters
      * @summary Get Query Insights
      * @param {string} xStoreID Store ID
      * @param {string} query Search query to analyze
      * @param {string} [startTime] Start time in RFC3339 format
      * @param {string} [endTime] End time in RFC3339 format
+     * @param {boolean} [compareMode] Enable comparison mode to compare with another time period/tag set
+     * @param {string} [compareStartTime] Comparison period start time in RFC3339 format
+     * @param {string} [compareEndTime] Comparison period end time in RFC3339 format
+     * @param {string} [compareAnalyticsTags] Comma-separated analytics tags for comparison period
+     * @param {AdminAnalyticsStoreXStoreIDQueriesQueryInsightsGetCompareTagsMatchModeEnum} [compareTagsMatchMode] How to match comparison analytics tags
+     * @param {string} [compareTagsExclude] Comma-separated analytics tags to exclude in comparison
+     * @param {string} [compareTagKeyFilter] Tag key filter for comparison period
+     * @param {string} [compareTagValueFilter] Tag value filter for comparison period
      * @param {number} [resultsPage] Page number for popular results pagination
      * @param {number} [resultsPageSize] Number of results per page for popular results
      * @param {number} [filtersPage] Page number for popular filters pagination
-     * @param {number} [filtersPageSize] Number of filters per page for popular filters
+     * @param {number} [filtersPageSize] Number of filters per page
+     * @param {number} [geoPage] Page number for geo analytics pagination
+     * @param {number} [geoPageSize] Number of geo locations per page
      * @param {boolean} [includeWidget] Whether to include widget display fields for popular results
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      * @memberof AnalyticsApi
      */
-    adminAnalyticsStoreXStoreIDQueriesQueryInsightsGet(xStoreID, 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, geoPage, geoPageSize, includeWidget, options) {
+        return AnalyticsApiFp(this.configuration).adminAnalyticsStoreXStoreIDQueriesQueryInsightsGet(xStoreID, query, startTime, endTime, compareMode, compareStartTime, compareEndTime, compareAnalyticsTags, compareTagsMatchMode, compareTagsExclude, compareTagKeyFilter, compareTagValueFilter, resultsPage, resultsPageSize, filtersPage, filtersPageSize, geoPage, geoPageSize, includeWidget, options).then((request) => request(this.axios, this.basePath));
     }
     /**
      * 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 +3966,13 @@ export const AdminAnalyticsStoreXStoreIDQueriesNoResultsGetSortOrderEnum = {
     Asc: 'asc',
     Desc: 'desc'
 };
+/**
+ * @export
+ */
+export const AdminAnalyticsStoreXStoreIDQueriesQueryInsightsGetCompareTagsMatchModeEnum = {
+    Any: 'any',
+    All: 'all'
+};
 /**
  * @export
  */
@@ -7335,6 +7412,129 @@ export const ItemAnalyticsApiAxiosParamCreator = function (configuration) {
                 options: localVarRequestOptions,
             };
         }),
+        /**
+         * Retrieve comprehensive analytics insights for a specific item including popular queries, filters, position distribution, geo analytics, and performance metrics with pagination support for subsections and optional comparison mode
+         * @summary Get Item Insights
+         * @param {string} xStoreID Store ID
+         * @param {string} itemId Item ID to analyze
+         * @param {string} [startTime] Start time in RFC3339 format
+         * @param {string} [endTime] End time in RFC3339 format
+         * @param {string} [analyticsTags] Comma-separated analytics tags to filter (e.g., \'campaign:summer,source:email\')
+         * @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_1, itemId_1, startTime_1, endTime_1, analyticsTags_1, tagsMatchMode_1, tagsExclude_1, tagKeyFilter_1, tagValueFilter_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, geoPage_1, geoPageSize_1, groupBy_1, ...args_1) => __awaiter(this, [xStoreID_1, itemId_1, startTime_1, endTime_1, analyticsTags_1, tagsMatchMode_1, tagsExclude_1, tagKeyFilter_1, tagValueFilter_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, geoPage_1, geoPageSize_1, groupBy_1, ...args_1], void 0, function* (xStoreID, itemId, startTime, endTime, analyticsTags, tagsMatchMode, tagsExclude, tagKeyFilter, tagValueFilter, compareMode, compareStartTime, compareEndTime, compareAnalyticsTags, compareTagsMatchMode, compareTagsExclude, compareTagKeyFilter, compareTagValueFilter, resultsPage, resultsPageSize, filtersPage, filtersPageSize, geoPage, geoPageSize, groupBy, options = {}) {
+            // verify required parameter 'xStoreID' is not null or undefined
+            assertParamExists('adminAnalyticsStoreXStoreIDItemsItemIdInsightsGet', 'xStoreID', xStoreID);
+            // verify required parameter 'itemId' is not null or undefined
+            assertParamExists('adminAnalyticsStoreXStoreIDItemsItemIdInsightsGet', 'itemId', itemId);
+            const localVarPath = `/admin/analytics/store/{xStoreID}/items/{itemId}/insights`
+                .replace(`{${"xStoreID"}}`, encodeURIComponent(String(xStoreID)))
+                .replace(`{${"itemId"}}`, encodeURIComponent(String(itemId)));
+            // use dummy base URL string because the URL constructor only accepts absolute URLs.
+            const localVarUrlObj = new URL(localVarPath, DUMMY_BASE_URL);
+            let baseOptions;
+            if (configuration) {
+                baseOptions = configuration.baseOptions;
+            }
+            const localVarRequestOptions = Object.assign(Object.assign({ method: 'GET' }, baseOptions), options);
+            const localVarHeaderParameter = {};
+            const localVarQueryParameter = {};
+            // authentication BearerAuth required
+            yield setApiKeyToObject(localVarHeaderParameter, "Authorization", configuration);
+            if (startTime !== undefined) {
+                localVarQueryParameter['start_time'] = startTime;
+            }
+            if (endTime !== undefined) {
+                localVarQueryParameter['end_time'] = endTime;
+            }
+            if (analyticsTags !== undefined) {
+                localVarQueryParameter['analytics_tags'] = analyticsTags;
+            }
+            if (tagsMatchMode !== undefined) {
+                localVarQueryParameter['tags_match_mode'] = tagsMatchMode;
+            }
+            if (tagsExclude !== undefined) {
+                localVarQueryParameter['tags_exclude'] = tagsExclude;
+            }
+            if (tagKeyFilter !== undefined) {
+                localVarQueryParameter['tag_key_filter'] = tagKeyFilter;
+            }
+            if (tagValueFilter !== undefined) {
+                localVarQueryParameter['tag_value_filter'] = tagValueFilter;
+            }
+            if (compareMode !== undefined) {
+                localVarQueryParameter['compare_mode'] = compareMode;
+            }
+            if (compareStartTime !== undefined) {
+                localVarQueryParameter['compare_start_time'] = compareStartTime;
+            }
+            if (compareEndTime !== undefined) {
+                localVarQueryParameter['compare_end_time'] = compareEndTime;
+            }
+            if (compareAnalyticsTags !== undefined) {
+                localVarQueryParameter['compare_analytics_tags'] = compareAnalyticsTags;
+            }
+            if (compareTagsMatchMode !== undefined) {
+                localVarQueryParameter['compare_tags_match_mode'] = compareTagsMatchMode;
+            }
+            if (compareTagsExclude !== undefined) {
+                localVarQueryParameter['compare_tags_exclude'] = compareTagsExclude;
+            }
+            if (compareTagKeyFilter !== undefined) {
+                localVarQueryParameter['compare_tag_key_filter'] = compareTagKeyFilter;
+            }
+            if (compareTagValueFilter !== undefined) {
+                localVarQueryParameter['compare_tag_value_filter'] = compareTagValueFilter;
+            }
+            if (resultsPage !== undefined) {
+                localVarQueryParameter['results_page'] = resultsPage;
+            }
+            if (resultsPageSize !== undefined) {
+                localVarQueryParameter['results_page_size'] = resultsPageSize;
+            }
+            if (filtersPage !== undefined) {
+                localVarQueryParameter['filters_page'] = filtersPage;
+            }
+            if (filtersPageSize !== undefined) {
+                localVarQueryParameter['filters_page_size'] = filtersPageSize;
+            }
+            if (geoPage !== undefined) {
+                localVarQueryParameter['geo_page'] = geoPage;
+            }
+            if (geoPageSize !== undefined) {
+                localVarQueryParameter['geo_page_size'] = geoPageSize;
+            }
+            if (groupBy !== undefined) {
+                localVarQueryParameter['group_by'] = groupBy;
+            }
+            setSearchParams(localVarUrlObj, localVarQueryParameter);
+            let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
+            localVarRequestOptions.headers = Object.assign(Object.assign(Object.assign({}, localVarHeaderParameter), headersFromBaseOptions), options.headers);
+            return {
+                url: toPathString(localVarUrlObj),
+                options: localVarRequestOptions,
+            };
+        }),
         /**
          * Retrieve detailed performance metrics for items including click-through rates, conversion rates, and revenue data
          * @summary Get Item Performance Analytics
@@ -7685,6 +7885,45 @@ export const ItemAnalyticsApiFp = function (configuration) {
                 return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
             });
         },
+        /**
+         * Retrieve comprehensive analytics insights for a specific item including popular queries, filters, position distribution, geo analytics, and performance metrics with pagination support for subsections and optional comparison mode
+         * @summary Get Item Insights
+         * @param {string} xStoreID Store ID
+         * @param {string} itemId Item ID to analyze
+         * @param {string} [startTime] Start time in RFC3339 format
+         * @param {string} [endTime] End time in RFC3339 format
+         * @param {string} [analyticsTags] Comma-separated analytics tags to filter (e.g., \'campaign:summer,source:email\')
+         * @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, itemId, startTime, endTime, analyticsTags, tagsMatchMode, tagsExclude, tagKeyFilter, tagValueFilter, compareMode, compareStartTime, compareEndTime, compareAnalyticsTags, compareTagsMatchMode, compareTagsExclude, compareTagKeyFilter, compareTagValueFilter, resultsPage, resultsPageSize, filtersPage, filtersPageSize, geoPage, geoPageSize, groupBy, options) {
+            return __awaiter(this, void 0, void 0, function* () {
+                var _a, _b, _c;
+                const localVarAxiosArgs = yield localVarAxiosParamCreator.adminAnalyticsStoreXStoreIDItemsItemIdInsightsGet(xStoreID, itemId, startTime, endTime, analyticsTags, tagsMatchMode, tagsExclude, tagKeyFilter, tagValueFilter, compareMode, compareStartTime, compareEndTime, compareAnalyticsTags, compareTagsMatchMode, compareTagsExclude, compareTagKeyFilter, compareTagValueFilter, resultsPage, resultsPageSize, filtersPage, filtersPageSize, geoPage, geoPageSize, groupBy, options);
+                const localVarOperationServerIndex = (_a = configuration === null || configuration === void 0 ? void 0 : configuration.serverIndex) !== null && _a !== void 0 ? _a : 0;
+                const localVarOperationServerBasePath = (_c = (_b = operationServerMap['ItemAnalyticsApi.adminAnalyticsStoreXStoreIDItemsItemIdInsightsGet']) === 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);
+            });
+        },
         /**
          * Retrieve detailed performance metrics for items including click-through rates, conversion rates, and revenue data
          * @summary Get Item Performance Analytics
@@ -7852,6 +8091,39 @@ export const ItemAnalyticsApiFactory = function (configuration, basePath, axios)
         adminAnalyticsStoreXStoreIDItemsItemIdGet(xStoreID, itemId, startTime, endTime, options) {
             return localVarFp.adminAnalyticsStoreXStoreIDItemsItemIdGet(xStoreID, itemId, startTime, endTime, options).then((request) => request(axios, basePath));
         },
+        /**
+         * Retrieve comprehensive analytics insights for a specific item including popular queries, filters, position distribution, geo analytics, and performance metrics with pagination support for subsections and optional comparison mode
+         * @summary Get Item Insights
+         * @param {string} xStoreID Store ID
+         * @param {string} itemId Item ID to analyze
+         * @param {string} [startTime] Start time in RFC3339 format
+         * @param {string} [endTime] End time in RFC3339 format
+         * @param {string} [analyticsTags] Comma-separated analytics tags to filter (e.g., \'campaign:summer,source:email\')
+         * @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, itemId, startTime, endTime, analyticsTags, tagsMatchMode, tagsExclude, tagKeyFilter, tagValueFilter, compareMode, compareStartTime, compareEndTime, compareAnalyticsTags, compareTagsMatchMode, compareTagsExclude, compareTagKeyFilter, compareTagValueFilter, resultsPage, resultsPageSize, filtersPage, filtersPageSize, geoPage, geoPageSize, groupBy, options) {
+            return localVarFp.adminAnalyticsStoreXStoreIDItemsItemIdInsightsGet(xStoreID, itemId, startTime, endTime, analyticsTags, tagsMatchMode, tagsExclude, tagKeyFilter, tagValueFilter, compareMode, compareStartTime, compareEndTime, compareAnalyticsTags, compareTagsMatchMode, compareTagsExclude, compareTagKeyFilter, compareTagValueFilter, resultsPage, resultsPageSize, filtersPage, filtersPageSize, geoPage, geoPageSize, groupBy, options).then((request) => request(axios, basePath));
+        },
         /**
          * Retrieve detailed performance metrics for items including click-through rates, conversion rates, and revenue data
          * @summary Get Item Performance Analytics
@@ -8005,6 +8277,40 @@ export class ItemAnalyticsApi extends BaseAPI {
     adminAnalyticsStoreXStoreIDItemsItemIdGet(xStoreID, itemId, startTime, endTime, options) {
         return ItemAnalyticsApiFp(this.configuration).adminAnalyticsStoreXStoreIDItemsItemIdGet(xStoreID, itemId, startTime, endTime, options).then((request) => request(this.axios, this.basePath));
     }
+    /**
+     * Retrieve comprehensive analytics insights for a specific item including popular queries, filters, position distribution, geo analytics, and performance metrics with pagination support for subsections and optional comparison mode
+     * @summary Get Item Insights
+     * @param {string} xStoreID Store ID
+     * @param {string} itemId Item ID to analyze
+     * @param {string} [startTime] Start time in RFC3339 format
+     * @param {string} [endTime] End time in RFC3339 format
+     * @param {string} [analyticsTags] Comma-separated analytics tags to filter (e.g., \'campaign:summer,source:email\')
+     * @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, itemId, startTime, endTime, analyticsTags, tagsMatchMode, tagsExclude, tagKeyFilter, tagValueFilter, compareMode, compareStartTime, compareEndTime, compareAnalyticsTags, compareTagsMatchMode, compareTagsExclude, compareTagKeyFilter, compareTagValueFilter, resultsPage, resultsPageSize, filtersPage, filtersPageSize, geoPage, geoPageSize, groupBy, options) {
+        return ItemAnalyticsApiFp(this.configuration).adminAnalyticsStoreXStoreIDItemsItemIdInsightsGet(xStoreID, itemId, startTime, endTime, analyticsTags, tagsMatchMode, tagsExclude, tagKeyFilter, tagValueFilter, compareMode, compareStartTime, compareEndTime, compareAnalyticsTags, compareTagsMatchMode, compareTagsExclude, compareTagKeyFilter, compareTagValueFilter, resultsPage, resultsPageSize, filtersPage, filtersPageSize, geoPage, geoPageSize, groupBy, options).then((request) => request(this.axios, this.basePath));
+    }
     /**
      * Retrieve detailed performance metrics for items including click-through rates, conversion rates, and revenue data
      * @summary Get Item Performance Analytics
@@ -8109,6 +8415,26 @@ export const AdminAnalyticsStoreXStoreIDItemsGetSortOrderEnum = {
     Asc: 'asc',
     Desc: 'desc'
 };
+/**
+ * @export
+ */
+export const AdminAnalyticsStoreXStoreIDItemsItemIdInsightsGetTagsMatchModeEnum = {
+    Any: 'any',
+    All: 'all'
+};
+/**
+ * @export
+ */
+export const AdminAnalyticsStoreXStoreIDItemsItemIdInsightsGetCompareTagsMatchModeEnum = {
+    Any: 'any',
+    All: 'all'
+};
+/**
+ * @export
+ */
+export const AdminAnalyticsStoreXStoreIDItemsItemIdInsightsGetGroupByEnum = {
+    Date: 'date'
+};
 /**
  * @export
  */

package/package.json

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