@seekora-ai/admin-api 1.1.79 → 1.1.81

package/dist/api.d.ts

@@ -12868,6 +12868,12 @@ export interface DataTypesCombinedSearchResponse {
      * @memberof DataTypesCombinedSearchResponse
      */
     'search_id'?: string;
+    /**
+     * Available sort options based on schema
+     * @type {Array<DataTypesSortOption>}
+     * @memberof DataTypesCombinedSearchResponse
+     */
+    'sort_options'?: Array<DataTypesSortOption>;
     /**
      *
      * @type {Array<DataTypesAutocompleteSuggestion>}
@@ -15981,6 +15987,12 @@ export interface DataTypesEventPayload {
      * @memberof DataTypesEventPayload
      */
     'connection_type'?: string;
+    /**
+     * add_to_cart, wishlist, purchase, etc.
+     * @type {string}
+     * @memberof DataTypesEventPayload
+     */
+    'conversion_type'?: string;
     /**
      *
      * @type {string}
@@ -16059,6 +16071,12 @@ export interface DataTypesEventPayload {
      * @memberof DataTypesEventPayload
      */
     'impression_duration_ms'?: number;
+    /**
+     * Deduplication (industry standard: Segment, Amplitude, Mixpanel pattern) Format: {user_key}_{event_type}_{item_id}_{timestamp_window} Backend can deduplicate by this key within configurable window
+     * @type {string}
+     * @memberof DataTypesEventPayload
+     */
+    'insert_id'?: string;
     /**
      * ============================================================================ Device Context (V3) ============================================================================
      * @type {string}
@@ -16175,6 +16193,12 @@ export interface DataTypesEventPayload {
      * @memberof DataTypesEventPayload
      */
     'products_count'?: number;
+    /**
+     *
+     * @type {number}
+     * @memberof DataTypesEventPayload
+     */
+    'quantity'?: number;
     /**
      * ============================================================================ Search Event Fields ============================================================================
      * @type {string}
@@ -22770,6 +22794,12 @@ export interface DataTypesOfficialSearchResponse {
      * @memberof DataTypesOfficialSearchResponse
      */
     'search_id'?: string;
+    /**
+     * Available sort options based on schema
+     * @type {Array<DataTypesSortOption>}
+     * @memberof DataTypesOfficialSearchResponse
+     */
+    'sort_options'?: Array<DataTypesSortOption>;
     /**
      *
      * @type {Array<DataTypesAutocompleteSuggestion>}
@@ -23520,6 +23550,12 @@ export interface DataTypesOrgMemberWithUser {
      * @memberof DataTypesOrgMemberWithUser
      */
     'is_active'?: boolean;
+    /**
+     * True if user is the organization owner (non-deletable)
+     * @type {boolean}
+     * @memberof DataTypesOrgMemberWithUser
+     */
+    'is_owner'?: boolean;
     /**
      * True if user has custom/user-specific role
      * @type {boolean}
@@ -26397,6 +26433,12 @@ export interface DataTypesRole {
      * @memberof DataTypesRole
      */
     'isDeleted'?: boolean;
+    /**
+     * BOOLEAN, DEFAULT FALSE - TRUE for system-created roles (non-editable)
+     * @type {boolean}
+     * @memberof DataTypesRole
+     */
+    'isSystemCreated'?: boolean;
     /**
      * BOOLEAN, DEFAULT FALSE - TRUE for user-specific custom roles
      * @type {boolean}
@@ -27836,6 +27878,37 @@ export interface DataTypesSortField {
      */
     'field'?: string;
 }
+/**
+ *
+ * @export
+ * @interface DataTypesSortOption
+ */
+export interface DataTypesSortOption {
+    /**
+     * \"asc\" or \"desc\"
+     * @type {string}
+     * @memberof DataTypesSortOption
+     */
+    'direction'?: string;
+    /**
+     * Field name (e.g., \"price\", \"created_at\")
+     * @type {string}
+     * @memberof DataTypesSortOption
+     */
+    'field'?: string;
+    /**
+     * Human-readable label (e.g., \"Price: Low to High\")
+     * @type {string}
+     * @memberof DataTypesSortOption
+     */
+    'label'?: string;
+    /**
+     * Combined value for API (e.g., \"price:asc\")
+     * @type {string}
+     * @memberof DataTypesSortOption
+     */
+    'value'?: string;
+}
 /**
  *
  * @export
@@ -35227,6 +35300,12 @@ export interface QuerySuggestionsServiceQuerySuggestionsRequest {
      * @memberof QuerySuggestionsServiceQuerySuggestionsRequest
      */
     'include_categories'?: boolean;
+    /**
+     * Optional: disable parts of dropdown when include_dropdown_recommendations=true (default true = include)
+     * @type {boolean}
+     * @memberof QuerySuggestionsServiceQuerySuggestionsRequest
+     */
+    'include_dropdown_product_list'?: boolean;
     /**
      * Rich dropdown recommendations (optional, data-agnostic)
      * @type {boolean}
@@ -35245,6 +35324,12 @@ export interface QuerySuggestionsServiceQuerySuggestionsRequest {
      * @memberof QuerySuggestionsServiceQuerySuggestionsRequest
      */
     'include_facets'?: boolean;
+    /**
+     * When false, omit filtered_tabs from dropdown extensions (default true)
+     * @type {boolean}
+     * @memberof QuerySuggestionsServiceQuerySuggestionsRequest
+     */
+    'include_filtered_tabs'?: boolean;
     /**
      * Max categories per suggestion (default: 3)
      * @type {number}
@@ -55287,38 +55372,47 @@ export declare const QuerySuggestionsApiAxiosParamCreator: (configuration?: Conf
      */
     v1SuggestionsConfigGet: (xStoreid: string, xStoresecret: string, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
     /**
-     * Retrieve query suggestions based on search analytics data with popularity ranking and optional category/facet enrichment. Supports partial query matching, analytics tags filtering, and configurable time ranges. Supports personalization via x-user-id, x-anon-id, x-session-id headers.
+     * Retrieve query suggestions based on search analytics data with popularity ranking and optional category/facet enrichment. Supports partial query matching, analytics tags filtering, configurable time ranges, and dropdown recommendations with filtered tabs. Supports personalization via x-user-id, x-anon-id, x-session-id headers. Full feature parity with POST endpoint.
      * @summary Get Query Suggestions
      * @param {string} xStoreid Store ID
      * @param {string} xStoresecret Store Secret
      * @param {string} [xUserId] User ID for personalization (logged-in user)
      * @param {string} [xAnonId] Anonymous ID for personalization (cookie/device ID)
      * @param {string} [xSessionId] Session ID for personalization
-     * @param {string} [query] Partial query to get suggestions for
+     * @param {string} [query] Partial query to get suggestions for (supports both \&#39;query\&#39; and \&#39;q\&#39;)
+     * @param {string} [q] Alias for \&#39;query\&#39; parameter
      * @param {number} [hitsPerPage] Number of suggestions to return
      * @param {number} [page] Page number for pagination
      * @param {string} [analyticsTags] Comma-separated analytics tags to filter suggestions
      * @param {V1SuggestionsQueriesGetTagsMatchModeEnum} [tagsMatchMode] How to match analytics tags
      * @param {boolean} [includeCategories] Include category information in suggestions
      * @param {boolean} [includeFacets] Include popular facets/filters information
+     * @param {boolean} [includeDropdownRecommendations] Include rich dropdown recommendations (trending products, filtered tabs)
+     * @param {boolean} [includeDropdownProductList] Include product list in dropdown recommendations
+     * @param {boolean} [includeFilteredTabs] Include filtered tabs in dropdown recommendations
+     * @param {boolean} [includeEmptyQueryRecommendations] Return popular suggestions when query is empty
      * @param {number} [maxCategories] Maximum categories per suggestion
      * @param {number} [maxFacets] Maximum facets per suggestion
      * @param {number} [minPopularity] Minimum popularity threshold
      * @param {V1SuggestionsQueriesGetTimeRangeEnum} [timeRange] Time range for analytics data
      * @param {boolean} [disableTypoTolerance] Disable fuzzy/typo-tolerant matching
+     * @param {string} [filteredTabs] URL-encoded JSON array of filtered tab configurations (e.g., [{\\
+     * @param {string} [userId] User ID for personalization (query param fallback, header takes precedence)
+     * @param {string} [anonId] Anonymous ID for personalization (query param fallback, header takes precedence)
+     * @param {string} [sessionId] Session ID for personalization (query param fallback, header takes precedence)
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
-    v1SuggestionsQueriesGet: (xStoreid: string, xStoresecret: string, xUserId?: string, xAnonId?: string, xSessionId?: string, query?: string, hitsPerPage?: number, page?: number, analyticsTags?: string, tagsMatchMode?: V1SuggestionsQueriesGetTagsMatchModeEnum, includeCategories?: boolean, includeFacets?: boolean, maxCategories?: number, maxFacets?: number, minPopularity?: number, timeRange?: V1SuggestionsQueriesGetTimeRangeEnum, disableTypoTolerance?: boolean, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
+    v1SuggestionsQueriesGet: (xStoreid: string, xStoresecret: string, xUserId?: string, xAnonId?: string, xSessionId?: string, query?: string, q?: string, hitsPerPage?: number, page?: number, analyticsTags?: string, tagsMatchMode?: V1SuggestionsQueriesGetTagsMatchModeEnum, includeCategories?: boolean, includeFacets?: boolean, includeDropdownRecommendations?: boolean, includeDropdownProductList?: boolean, includeFilteredTabs?: boolean, includeEmptyQueryRecommendations?: boolean, maxCategories?: number, maxFacets?: number, minPopularity?: number, timeRange?: V1SuggestionsQueriesGetTimeRangeEnum, disableTypoTolerance?: boolean, filteredTabs?: string, userId?: string, anonId?: string, sessionId?: string, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
     /**
-     * Same as GET: retrieve query suggestions with optional body (query, hitsPerPage, analytics_tags, filtered_tabs, etc.). Use POST when sending filtered_tabs or larger payloads. Supports personalization via x-user-id, x-anon-id, x-session-id headers.
+     * Same as GET endpoint with full feature parity. Retrieve query suggestions with optional JSON body (query, hitsPerPage, analytics_tags, filtered_tabs, dropdown recommendations, etc.). Use POST when sending complex filtered_tabs as JSON is more convenient than URL-encoded query params. Supports personalization via x-user-id, x-anon-id, x-session-id headers. Both GET and POST return identical responses.
      * @summary Post Query Suggestions
      * @param {string} xStoreid Store ID
      * @param {string} xStoresecret Store Secret
      * @param {string} [xUserId] User ID for personalization (logged-in user)
      * @param {string} [xAnonId] Anonymous ID for personalization (cookie/device ID)
      * @param {string} [xSessionId] Session ID for personalization
-     * @param {QuerySuggestionsServiceQuerySuggestionsRequest} [querySuggestionsServiceQuerySuggestionsRequest] Query suggestions request (query, hitsPerPage, page, analytics_tags, include_categories, include_facets, filtered_tabs, etc.)
+     * @param {QuerySuggestionsServiceQuerySuggestionsRequest} [querySuggestionsServiceQuerySuggestionsRequest] Query suggestions request (query, hitsPerPage, page, analytics_tags, include_categories, include_facets, include_dropdown_recommendations, filtered_tabs, etc.)
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
@@ -55339,38 +55433,47 @@ export declare const QuerySuggestionsApiFp: (configuration?: Configuration) => {
      */
     v1SuggestionsConfigGet(xStoreid: string, xStoresecret: string, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<V1SuggestionsConfigGet200Response>>;
     /**
-     * Retrieve query suggestions based on search analytics data with popularity ranking and optional category/facet enrichment. Supports partial query matching, analytics tags filtering, and configurable time ranges. Supports personalization via x-user-id, x-anon-id, x-session-id headers.
+     * Retrieve query suggestions based on search analytics data with popularity ranking and optional category/facet enrichment. Supports partial query matching, analytics tags filtering, configurable time ranges, and dropdown recommendations with filtered tabs. Supports personalization via x-user-id, x-anon-id, x-session-id headers. Full feature parity with POST endpoint.
      * @summary Get Query Suggestions
      * @param {string} xStoreid Store ID
      * @param {string} xStoresecret Store Secret
      * @param {string} [xUserId] User ID for personalization (logged-in user)
      * @param {string} [xAnonId] Anonymous ID for personalization (cookie/device ID)
      * @param {string} [xSessionId] Session ID for personalization
-     * @param {string} [query] Partial query to get suggestions for
+     * @param {string} [query] Partial query to get suggestions for (supports both \&#39;query\&#39; and \&#39;q\&#39;)
+     * @param {string} [q] Alias for \&#39;query\&#39; parameter
      * @param {number} [hitsPerPage] Number of suggestions to return
      * @param {number} [page] Page number for pagination
      * @param {string} [analyticsTags] Comma-separated analytics tags to filter suggestions
      * @param {V1SuggestionsQueriesGetTagsMatchModeEnum} [tagsMatchMode] How to match analytics tags
      * @param {boolean} [includeCategories] Include category information in suggestions
      * @param {boolean} [includeFacets] Include popular facets/filters information
+     * @param {boolean} [includeDropdownRecommendations] Include rich dropdown recommendations (trending products, filtered tabs)
+     * @param {boolean} [includeDropdownProductList] Include product list in dropdown recommendations
+     * @param {boolean} [includeFilteredTabs] Include filtered tabs in dropdown recommendations
+     * @param {boolean} [includeEmptyQueryRecommendations] Return popular suggestions when query is empty
      * @param {number} [maxCategories] Maximum categories per suggestion
      * @param {number} [maxFacets] Maximum facets per suggestion
      * @param {number} [minPopularity] Minimum popularity threshold
      * @param {V1SuggestionsQueriesGetTimeRangeEnum} [timeRange] Time range for analytics data
      * @param {boolean} [disableTypoTolerance] Disable fuzzy/typo-tolerant matching
+     * @param {string} [filteredTabs] URL-encoded JSON array of filtered tab configurations (e.g., [{\\
+     * @param {string} [userId] User ID for personalization (query param fallback, header takes precedence)
+     * @param {string} [anonId] Anonymous ID for personalization (query param fallback, header takes precedence)
+     * @param {string} [sessionId] Session ID for personalization (query param fallback, header takes precedence)
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
-    v1SuggestionsQueriesGet(xStoreid: string, xStoresecret: string, xUserId?: string, xAnonId?: string, xSessionId?: string, query?: string, hitsPerPage?: number, page?: number, analyticsTags?: string, tagsMatchMode?: V1SuggestionsQueriesGetTagsMatchModeEnum, includeCategories?: boolean, includeFacets?: boolean, maxCategories?: number, maxFacets?: number, minPopularity?: number, timeRange?: V1SuggestionsQueriesGetTimeRangeEnum, disableTypoTolerance?: boolean, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<QuerySuggestionsServiceQuerySuggestionsAPIResponse>>;
+    v1SuggestionsQueriesGet(xStoreid: string, xStoresecret: string, xUserId?: string, xAnonId?: string, xSessionId?: string, query?: string, q?: string, hitsPerPage?: number, page?: number, analyticsTags?: string, tagsMatchMode?: V1SuggestionsQueriesGetTagsMatchModeEnum, includeCategories?: boolean, includeFacets?: boolean, includeDropdownRecommendations?: boolean, includeDropdownProductList?: boolean, includeFilteredTabs?: boolean, includeEmptyQueryRecommendations?: boolean, maxCategories?: number, maxFacets?: number, minPopularity?: number, timeRange?: V1SuggestionsQueriesGetTimeRangeEnum, disableTypoTolerance?: boolean, filteredTabs?: string, userId?: string, anonId?: string, sessionId?: string, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<QuerySuggestionsServiceQuerySuggestionsAPIResponse>>;
     /**
-     * Same as GET: retrieve query suggestions with optional body (query, hitsPerPage, analytics_tags, filtered_tabs, etc.). Use POST when sending filtered_tabs or larger payloads. Supports personalization via x-user-id, x-anon-id, x-session-id headers.
+     * Same as GET endpoint with full feature parity. Retrieve query suggestions with optional JSON body (query, hitsPerPage, analytics_tags, filtered_tabs, dropdown recommendations, etc.). Use POST when sending complex filtered_tabs as JSON is more convenient than URL-encoded query params. Supports personalization via x-user-id, x-anon-id, x-session-id headers. Both GET and POST return identical responses.
      * @summary Post Query Suggestions
      * @param {string} xStoreid Store ID
      * @param {string} xStoresecret Store Secret
      * @param {string} [xUserId] User ID for personalization (logged-in user)
      * @param {string} [xAnonId] Anonymous ID for personalization (cookie/device ID)
      * @param {string} [xSessionId] Session ID for personalization
-     * @param {QuerySuggestionsServiceQuerySuggestionsRequest} [querySuggestionsServiceQuerySuggestionsRequest] Query suggestions request (query, hitsPerPage, page, analytics_tags, include_categories, include_facets, filtered_tabs, etc.)
+     * @param {QuerySuggestionsServiceQuerySuggestionsRequest} [querySuggestionsServiceQuerySuggestionsRequest] Query suggestions request (query, hitsPerPage, page, analytics_tags, include_categories, include_facets, include_dropdown_recommendations, filtered_tabs, etc.)
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
@@ -55391,38 +55494,47 @@ export declare const QuerySuggestionsApiFactory: (configuration?: Configuration,
      */
     v1SuggestionsConfigGet(xStoreid: string, xStoresecret: string, options?: RawAxiosRequestConfig): AxiosPromise<V1SuggestionsConfigGet200Response>;
     /**
-     * Retrieve query suggestions based on search analytics data with popularity ranking and optional category/facet enrichment. Supports partial query matching, analytics tags filtering, and configurable time ranges. Supports personalization via x-user-id, x-anon-id, x-session-id headers.
+     * Retrieve query suggestions based on search analytics data with popularity ranking and optional category/facet enrichment. Supports partial query matching, analytics tags filtering, configurable time ranges, and dropdown recommendations with filtered tabs. Supports personalization via x-user-id, x-anon-id, x-session-id headers. Full feature parity with POST endpoint.
      * @summary Get Query Suggestions
      * @param {string} xStoreid Store ID
      * @param {string} xStoresecret Store Secret
      * @param {string} [xUserId] User ID for personalization (logged-in user)
      * @param {string} [xAnonId] Anonymous ID for personalization (cookie/device ID)
      * @param {string} [xSessionId] Session ID for personalization
-     * @param {string} [query] Partial query to get suggestions for
+     * @param {string} [query] Partial query to get suggestions for (supports both \&#39;query\&#39; and \&#39;q\&#39;)
+     * @param {string} [q] Alias for \&#39;query\&#39; parameter
      * @param {number} [hitsPerPage] Number of suggestions to return
      * @param {number} [page] Page number for pagination
      * @param {string} [analyticsTags] Comma-separated analytics tags to filter suggestions
      * @param {V1SuggestionsQueriesGetTagsMatchModeEnum} [tagsMatchMode] How to match analytics tags
      * @param {boolean} [includeCategories] Include category information in suggestions
      * @param {boolean} [includeFacets] Include popular facets/filters information
+     * @param {boolean} [includeDropdownRecommendations] Include rich dropdown recommendations (trending products, filtered tabs)
+     * @param {boolean} [includeDropdownProductList] Include product list in dropdown recommendations
+     * @param {boolean} [includeFilteredTabs] Include filtered tabs in dropdown recommendations
+     * @param {boolean} [includeEmptyQueryRecommendations] Return popular suggestions when query is empty
      * @param {number} [maxCategories] Maximum categories per suggestion
      * @param {number} [maxFacets] Maximum facets per suggestion
      * @param {number} [minPopularity] Minimum popularity threshold
      * @param {V1SuggestionsQueriesGetTimeRangeEnum} [timeRange] Time range for analytics data
      * @param {boolean} [disableTypoTolerance] Disable fuzzy/typo-tolerant matching
+     * @param {string} [filteredTabs] URL-encoded JSON array of filtered tab configurations (e.g., [{\\
+     * @param {string} [userId] User ID for personalization (query param fallback, header takes precedence)
+     * @param {string} [anonId] Anonymous ID for personalization (query param fallback, header takes precedence)
+     * @param {string} [sessionId] Session ID for personalization (query param fallback, header takes precedence)
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
-    v1SuggestionsQueriesGet(xStoreid: string, xStoresecret: string, xUserId?: string, xAnonId?: string, xSessionId?: string, query?: string, hitsPerPage?: number, page?: number, analyticsTags?: string, tagsMatchMode?: V1SuggestionsQueriesGetTagsMatchModeEnum, includeCategories?: boolean, includeFacets?: boolean, maxCategories?: number, maxFacets?: number, minPopularity?: number, timeRange?: V1SuggestionsQueriesGetTimeRangeEnum, disableTypoTolerance?: boolean, options?: RawAxiosRequestConfig): AxiosPromise<QuerySuggestionsServiceQuerySuggestionsAPIResponse>;
+    v1SuggestionsQueriesGet(xStoreid: string, xStoresecret: string, xUserId?: string, xAnonId?: string, xSessionId?: string, query?: string, q?: string, hitsPerPage?: number, page?: number, analyticsTags?: string, tagsMatchMode?: V1SuggestionsQueriesGetTagsMatchModeEnum, includeCategories?: boolean, includeFacets?: boolean, includeDropdownRecommendations?: boolean, includeDropdownProductList?: boolean, includeFilteredTabs?: boolean, includeEmptyQueryRecommendations?: boolean, maxCategories?: number, maxFacets?: number, minPopularity?: number, timeRange?: V1SuggestionsQueriesGetTimeRangeEnum, disableTypoTolerance?: boolean, filteredTabs?: string, userId?: string, anonId?: string, sessionId?: string, options?: RawAxiosRequestConfig): AxiosPromise<QuerySuggestionsServiceQuerySuggestionsAPIResponse>;
     /**
-     * Same as GET: retrieve query suggestions with optional body (query, hitsPerPage, analytics_tags, filtered_tabs, etc.). Use POST when sending filtered_tabs or larger payloads. Supports personalization via x-user-id, x-anon-id, x-session-id headers.
+     * Same as GET endpoint with full feature parity. Retrieve query suggestions with optional JSON body (query, hitsPerPage, analytics_tags, filtered_tabs, dropdown recommendations, etc.). Use POST when sending complex filtered_tabs as JSON is more convenient than URL-encoded query params. Supports personalization via x-user-id, x-anon-id, x-session-id headers. Both GET and POST return identical responses.
      * @summary Post Query Suggestions
      * @param {string} xStoreid Store ID
      * @param {string} xStoresecret Store Secret
      * @param {string} [xUserId] User ID for personalization (logged-in user)
      * @param {string} [xAnonId] Anonymous ID for personalization (cookie/device ID)
      * @param {string} [xSessionId] Session ID for personalization
-     * @param {QuerySuggestionsServiceQuerySuggestionsRequest} [querySuggestionsServiceQuerySuggestionsRequest] Query suggestions request (query, hitsPerPage, page, analytics_tags, include_categories, include_facets, filtered_tabs, etc.)
+     * @param {QuerySuggestionsServiceQuerySuggestionsRequest} [querySuggestionsServiceQuerySuggestionsRequest] Query suggestions request (query, hitsPerPage, page, analytics_tags, include_categories, include_facets, include_dropdown_recommendations, filtered_tabs, etc.)
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
@@ -55446,39 +55558,48 @@ export declare class QuerySuggestionsApi extends BaseAPI {
      */
     v1SuggestionsConfigGet(xStoreid: string, xStoresecret: string, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<V1SuggestionsConfigGet200Response, any, {}>>;
     /**
-     * Retrieve query suggestions based on search analytics data with popularity ranking and optional category/facet enrichment. Supports partial query matching, analytics tags filtering, and configurable time ranges. Supports personalization via x-user-id, x-anon-id, x-session-id headers.
+     * Retrieve query suggestions based on search analytics data with popularity ranking and optional category/facet enrichment. Supports partial query matching, analytics tags filtering, configurable time ranges, and dropdown recommendations with filtered tabs. Supports personalization via x-user-id, x-anon-id, x-session-id headers. Full feature parity with POST endpoint.
      * @summary Get Query Suggestions
      * @param {string} xStoreid Store ID
      * @param {string} xStoresecret Store Secret
      * @param {string} [xUserId] User ID for personalization (logged-in user)
      * @param {string} [xAnonId] Anonymous ID for personalization (cookie/device ID)
      * @param {string} [xSessionId] Session ID for personalization
-     * @param {string} [query] Partial query to get suggestions for
+     * @param {string} [query] Partial query to get suggestions for (supports both \&#39;query\&#39; and \&#39;q\&#39;)
+     * @param {string} [q] Alias for \&#39;query\&#39; parameter
      * @param {number} [hitsPerPage] Number of suggestions to return
      * @param {number} [page] Page number for pagination
      * @param {string} [analyticsTags] Comma-separated analytics tags to filter suggestions
      * @param {V1SuggestionsQueriesGetTagsMatchModeEnum} [tagsMatchMode] How to match analytics tags
      * @param {boolean} [includeCategories] Include category information in suggestions
      * @param {boolean} [includeFacets] Include popular facets/filters information
+     * @param {boolean} [includeDropdownRecommendations] Include rich dropdown recommendations (trending products, filtered tabs)
+     * @param {boolean} [includeDropdownProductList] Include product list in dropdown recommendations
+     * @param {boolean} [includeFilteredTabs] Include filtered tabs in dropdown recommendations
+     * @param {boolean} [includeEmptyQueryRecommendations] Return popular suggestions when query is empty
      * @param {number} [maxCategories] Maximum categories per suggestion
      * @param {number} [maxFacets] Maximum facets per suggestion
      * @param {number} [minPopularity] Minimum popularity threshold
      * @param {V1SuggestionsQueriesGetTimeRangeEnum} [timeRange] Time range for analytics data
      * @param {boolean} [disableTypoTolerance] Disable fuzzy/typo-tolerant matching
+     * @param {string} [filteredTabs] URL-encoded JSON array of filtered tab configurations (e.g., [{\\
+     * @param {string} [userId] User ID for personalization (query param fallback, header takes precedence)
+     * @param {string} [anonId] Anonymous ID for personalization (query param fallback, header takes precedence)
+     * @param {string} [sessionId] Session ID for personalization (query param fallback, header takes precedence)
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      * @memberof QuerySuggestionsApi
      */
-    v1SuggestionsQueriesGet(xStoreid: string, xStoresecret: string, xUserId?: string, xAnonId?: string, xSessionId?: string, query?: string, hitsPerPage?: number, page?: number, analyticsTags?: string, tagsMatchMode?: V1SuggestionsQueriesGetTagsMatchModeEnum, includeCategories?: boolean, includeFacets?: boolean, maxCategories?: number, maxFacets?: number, minPopularity?: number, timeRange?: V1SuggestionsQueriesGetTimeRangeEnum, disableTypoTolerance?: boolean, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<QuerySuggestionsServiceQuerySuggestionsAPIResponse, any, {}>>;
+    v1SuggestionsQueriesGet(xStoreid: string, xStoresecret: string, xUserId?: string, xAnonId?: string, xSessionId?: string, query?: string, q?: string, hitsPerPage?: number, page?: number, analyticsTags?: string, tagsMatchMode?: V1SuggestionsQueriesGetTagsMatchModeEnum, includeCategories?: boolean, includeFacets?: boolean, includeDropdownRecommendations?: boolean, includeDropdownProductList?: boolean, includeFilteredTabs?: boolean, includeEmptyQueryRecommendations?: boolean, maxCategories?: number, maxFacets?: number, minPopularity?: number, timeRange?: V1SuggestionsQueriesGetTimeRangeEnum, disableTypoTolerance?: boolean, filteredTabs?: string, userId?: string, anonId?: string, sessionId?: string, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<QuerySuggestionsServiceQuerySuggestionsAPIResponse, any, {}>>;
     /**
-     * Same as GET: retrieve query suggestions with optional body (query, hitsPerPage, analytics_tags, filtered_tabs, etc.). Use POST when sending filtered_tabs or larger payloads. Supports personalization via x-user-id, x-anon-id, x-session-id headers.
+     * Same as GET endpoint with full feature parity. Retrieve query suggestions with optional JSON body (query, hitsPerPage, analytics_tags, filtered_tabs, dropdown recommendations, etc.). Use POST when sending complex filtered_tabs as JSON is more convenient than URL-encoded query params. Supports personalization via x-user-id, x-anon-id, x-session-id headers. Both GET and POST return identical responses.
      * @summary Post Query Suggestions
      * @param {string} xStoreid Store ID
      * @param {string} xStoresecret Store Secret
      * @param {string} [xUserId] User ID for personalization (logged-in user)
      * @param {string} [xAnonId] Anonymous ID for personalization (cookie/device ID)
      * @param {string} [xSessionId] Session ID for personalization
-     * @param {QuerySuggestionsServiceQuerySuggestionsRequest} [querySuggestionsServiceQuerySuggestionsRequest] Query suggestions request (query, hitsPerPage, page, analytics_tags, include_categories, include_facets, filtered_tabs, etc.)
+     * @param {QuerySuggestionsServiceQuerySuggestionsRequest} [querySuggestionsServiceQuerySuggestionsRequest] Query suggestions request (query, hitsPerPage, page, analytics_tags, include_categories, include_facets, include_dropdown_recommendations, filtered_tabs, etc.)
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      * @memberof QuerySuggestionsApi
@@ -58777,6 +58898,56 @@ export declare const SearchApiAxiosParamCreator: (configuration?: Configuration)
      * @throws {RequiredError}
      */
     v1IndexIndexnameDefaultsGet: (indexname: string, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
+    /**
+     * Search documents using query parameters. Supports all features of POST endpoint.
+     * @summary Public Search API (GET)
+     * @param {string} xStoreid Store ID
+     * @param {string} xStoresecret Store Secret
+     * @param {string} q Search query
+     * @param {string} [xUserId] User ID for personalization
+     * @param {string} [xAnonId] Anonymous ID for personalization
+     * @param {string} [xSessionId] Session ID for personalization
+     * @param {number} [page] Page number (default: 1)
+     * @param {number} [perPage] Items per page (default: 10)
+     * @param {string} [sortBy] Sort option (e.g., price:asc, created_at:desc)
+     * @param {string} [filterBy] Filter string (e.g., category:shirts)
+     * @param {string} [facetBy] Facet fields (comma-separated)
+     * @param {number} [maxFacetValues] Maximum facet values to return
+     * @param {boolean} [widgetMode] Return widget-formatted results
+     * @param {boolean} [includeSuggestions] Include autocomplete suggestions
+     * @param {number} [suggestionsLimit] Number of suggestions to return
+     * @param {string} [analyticsTags] Analytics tags (comma-separated)
+     * @param {string} [stopwordSets] Stopword set IDs (comma-separated)
+     * @param {string} [synonymSets] Synonym set IDs (comma-separated)
+     * @param {string} [searchFields] Fields to search in (comma-separated)
+     * @param {string} [returnFields] Fields to return (comma-separated)
+     * @param {string} [omitFields] Fields to omit (comma-separated)
+     * @param {string} [snippetFields] Fields to generate snippets for (comma-separated)
+     * @param {string} [fullSnippetFields] Fields to include full snippet (comma-separated)
+     * @param {string} [fieldWeights] Field weights as comma-separated integers (e.g., 3,2,1)
+     * @param {string} [groupField] Field to group results by
+     * @param {number} [groupSize] Number of results per group
+     * @param {string} [snippetPrefix] Prefix for highlighted snippets
+     * @param {string} [snippetSuffix] Suffix for highlighted snippets
+     * @param {number} [snippetTokenLimit] Maximum tokens in snippet
+     * @param {number} [snippetMinLen] Minimum snippet length
+     * @param {boolean} [includeSnippets] Include snippets in results
+     * @param {string} [prefixMode] Prefix matching mode (e.g., always, fallback, off)
+     * @param {string} [infixMode] Infix matching mode (e.g., always, fallback, off)
+     * @param {number} [typoMax] Maximum typo tolerance
+     * @param {number} [typoMinLen1] Min word length for 1 typo
+     * @param {number} [typoMinLen2] Min word length for 2 typos
+     * @param {number} [searchTimeoutMs] Search timeout in milliseconds
+     * @param {boolean} [requireAllTerms] Require all search terms to match
+     * @param {boolean} [exactMatchBoost] Boost exact matches
+     * @param {boolean} [cacheResults] Cache search results
+     * @param {boolean} [applyRules] Apply search rules
+     * @param {string} [presetName] Search preset name to use
+     * @param {string} [facetSearchText] Text to filter facet values
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    v1SearchGet: (xStoreid: string, xStoresecret: string, q: string, xUserId?: string, xAnonId?: string, xSessionId?: string, page?: number, perPage?: number, sortBy?: string, filterBy?: string, facetBy?: string, maxFacetValues?: number, widgetMode?: boolean, includeSuggestions?: boolean, suggestionsLimit?: number, analyticsTags?: string, stopwordSets?: string, synonymSets?: string, searchFields?: string, returnFields?: string, omitFields?: string, snippetFields?: string, fullSnippetFields?: string, fieldWeights?: string, groupField?: string, groupSize?: number, snippetPrefix?: string, snippetSuffix?: string, snippetTokenLimit?: number, snippetMinLen?: number, includeSnippets?: boolean, prefixMode?: string, infixMode?: string, typoMax?: number, typoMinLen1?: number, typoMinLen2?: number, searchTimeoutMs?: number, requireAllTerms?: boolean, exactMatchBoost?: boolean, cacheResults?: boolean, applyRules?: boolean, presetName?: string, facetSearchText?: string, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
     /**
      * Search documents using store credentials with optional autocomplete suggestions and configurable stopwords/synonyms. Supports personalization via x-user-id, x-anon-id, x-session-id headers.
      * @summary Public Search API
@@ -58848,6 +59019,56 @@ export declare const SearchApiFp: (configuration?: Configuration) => {
      * @throws {RequiredError}
      */
     v1IndexIndexnameDefaultsGet(indexname: string, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<DataTypesSchemaBasedDefaultsResponseWrapper>>;
+    /**
+     * Search documents using query parameters. Supports all features of POST endpoint.
+     * @summary Public Search API (GET)
+     * @param {string} xStoreid Store ID
+     * @param {string} xStoresecret Store Secret
+     * @param {string} q Search query
+     * @param {string} [xUserId] User ID for personalization
+     * @param {string} [xAnonId] Anonymous ID for personalization
+     * @param {string} [xSessionId] Session ID for personalization
+     * @param {number} [page] Page number (default: 1)
+     * @param {number} [perPage] Items per page (default: 10)
+     * @param {string} [sortBy] Sort option (e.g., price:asc, created_at:desc)
+     * @param {string} [filterBy] Filter string (e.g., category:shirts)
+     * @param {string} [facetBy] Facet fields (comma-separated)
+     * @param {number} [maxFacetValues] Maximum facet values to return
+     * @param {boolean} [widgetMode] Return widget-formatted results
+     * @param {boolean} [includeSuggestions] Include autocomplete suggestions
+     * @param {number} [suggestionsLimit] Number of suggestions to return
+     * @param {string} [analyticsTags] Analytics tags (comma-separated)
+     * @param {string} [stopwordSets] Stopword set IDs (comma-separated)
+     * @param {string} [synonymSets] Synonym set IDs (comma-separated)
+     * @param {string} [searchFields] Fields to search in (comma-separated)
+     * @param {string} [returnFields] Fields to return (comma-separated)
+     * @param {string} [omitFields] Fields to omit (comma-separated)
+     * @param {string} [snippetFields] Fields to generate snippets for (comma-separated)
+     * @param {string} [fullSnippetFields] Fields to include full snippet (comma-separated)
+     * @param {string} [fieldWeights] Field weights as comma-separated integers (e.g., 3,2,1)
+     * @param {string} [groupField] Field to group results by
+     * @param {number} [groupSize] Number of results per group
+     * @param {string} [snippetPrefix] Prefix for highlighted snippets
+     * @param {string} [snippetSuffix] Suffix for highlighted snippets
+     * @param {number} [snippetTokenLimit] Maximum tokens in snippet
+     * @param {number} [snippetMinLen] Minimum snippet length
+     * @param {boolean} [includeSnippets] Include snippets in results
+     * @param {string} [prefixMode] Prefix matching mode (e.g., always, fallback, off)
+     * @param {string} [infixMode] Infix matching mode (e.g., always, fallback, off)
+     * @param {number} [typoMax] Maximum typo tolerance
+     * @param {number} [typoMinLen1] Min word length for 1 typo
+     * @param {number} [typoMinLen2] Min word length for 2 typos
+     * @param {number} [searchTimeoutMs] Search timeout in milliseconds
+     * @param {boolean} [requireAllTerms] Require all search terms to match
+     * @param {boolean} [exactMatchBoost] Boost exact matches
+     * @param {boolean} [cacheResults] Cache search results
+     * @param {boolean} [applyRules] Apply search rules
+     * @param {string} [presetName] Search preset name to use
+     * @param {string} [facetSearchText] Text to filter facet values
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    v1SearchGet(xStoreid: string, xStoresecret: string, q: string, xUserId?: string, xAnonId?: string, xSessionId?: string, page?: number, perPage?: number, sortBy?: string, filterBy?: string, facetBy?: string, maxFacetValues?: number, widgetMode?: boolean, includeSuggestions?: boolean, suggestionsLimit?: number, analyticsTags?: string, stopwordSets?: string, synonymSets?: string, searchFields?: string, returnFields?: string, omitFields?: string, snippetFields?: string, fullSnippetFields?: string, fieldWeights?: string, groupField?: string, groupSize?: number, snippetPrefix?: string, snippetSuffix?: string, snippetTokenLimit?: number, snippetMinLen?: number, includeSnippets?: boolean, prefixMode?: string, infixMode?: string, typoMax?: number, typoMinLen1?: number, typoMinLen2?: number, searchTimeoutMs?: number, requireAllTerms?: boolean, exactMatchBoost?: boolean, cacheResults?: boolean, applyRules?: boolean, presetName?: string, facetSearchText?: string, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<DataTypesOfficialSearchResponseWrapper>>;
     /**
      * Search documents using store credentials with optional autocomplete suggestions and configurable stopwords/synonyms. Supports personalization via x-user-id, x-anon-id, x-session-id headers.
      * @summary Public Search API
@@ -58919,6 +59140,56 @@ export declare const SearchApiFactory: (configuration?: Configuration, basePath?
      * @throws {RequiredError}
      */
     v1IndexIndexnameDefaultsGet(indexname: string, options?: RawAxiosRequestConfig): AxiosPromise<DataTypesSchemaBasedDefaultsResponseWrapper>;
+    /**
+     * Search documents using query parameters. Supports all features of POST endpoint.
+     * @summary Public Search API (GET)
+     * @param {string} xStoreid Store ID
+     * @param {string} xStoresecret Store Secret
+     * @param {string} q Search query
+     * @param {string} [xUserId] User ID for personalization
+     * @param {string} [xAnonId] Anonymous ID for personalization
+     * @param {string} [xSessionId] Session ID for personalization
+     * @param {number} [page] Page number (default: 1)
+     * @param {number} [perPage] Items per page (default: 10)
+     * @param {string} [sortBy] Sort option (e.g., price:asc, created_at:desc)
+     * @param {string} [filterBy] Filter string (e.g., category:shirts)
+     * @param {string} [facetBy] Facet fields (comma-separated)
+     * @param {number} [maxFacetValues] Maximum facet values to return
+     * @param {boolean} [widgetMode] Return widget-formatted results
+     * @param {boolean} [includeSuggestions] Include autocomplete suggestions
+     * @param {number} [suggestionsLimit] Number of suggestions to return
+     * @param {string} [analyticsTags] Analytics tags (comma-separated)
+     * @param {string} [stopwordSets] Stopword set IDs (comma-separated)
+     * @param {string} [synonymSets] Synonym set IDs (comma-separated)
+     * @param {string} [searchFields] Fields to search in (comma-separated)
+     * @param {string} [returnFields] Fields to return (comma-separated)
+     * @param {string} [omitFields] Fields to omit (comma-separated)
+     * @param {string} [snippetFields] Fields to generate snippets for (comma-separated)
+     * @param {string} [fullSnippetFields] Fields to include full snippet (comma-separated)
+     * @param {string} [fieldWeights] Field weights as comma-separated integers (e.g., 3,2,1)
+     * @param {string} [groupField] Field to group results by
+     * @param {number} [groupSize] Number of results per group
+     * @param {string} [snippetPrefix] Prefix for highlighted snippets
+     * @param {string} [snippetSuffix] Suffix for highlighted snippets
+     * @param {number} [snippetTokenLimit] Maximum tokens in snippet
+     * @param {number} [snippetMinLen] Minimum snippet length
+     * @param {boolean} [includeSnippets] Include snippets in results
+     * @param {string} [prefixMode] Prefix matching mode (e.g., always, fallback, off)
+     * @param {string} [infixMode] Infix matching mode (e.g., always, fallback, off)
+     * @param {number} [typoMax] Maximum typo tolerance
+     * @param {number} [typoMinLen1] Min word length for 1 typo
+     * @param {number} [typoMinLen2] Min word length for 2 typos
+     * @param {number} [searchTimeoutMs] Search timeout in milliseconds
+     * @param {boolean} [requireAllTerms] Require all search terms to match
+     * @param {boolean} [exactMatchBoost] Boost exact matches
+     * @param {boolean} [cacheResults] Cache search results
+     * @param {boolean} [applyRules] Apply search rules
+     * @param {string} [presetName] Search preset name to use
+     * @param {string} [facetSearchText] Text to filter facet values
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    v1SearchGet(xStoreid: string, xStoresecret: string, q: string, xUserId?: string, xAnonId?: string, xSessionId?: string, page?: number, perPage?: number, sortBy?: string, filterBy?: string, facetBy?: string, maxFacetValues?: number, widgetMode?: boolean, includeSuggestions?: boolean, suggestionsLimit?: number, analyticsTags?: string, stopwordSets?: string, synonymSets?: string, searchFields?: string, returnFields?: string, omitFields?: string, snippetFields?: string, fullSnippetFields?: string, fieldWeights?: string, groupField?: string, groupSize?: number, snippetPrefix?: string, snippetSuffix?: string, snippetTokenLimit?: number, snippetMinLen?: number, includeSnippets?: boolean, prefixMode?: string, infixMode?: string, typoMax?: number, typoMinLen1?: number, typoMinLen2?: number, searchTimeoutMs?: number, requireAllTerms?: boolean, exactMatchBoost?: boolean, cacheResults?: boolean, applyRules?: boolean, presetName?: string, facetSearchText?: string, options?: RawAxiosRequestConfig): AxiosPromise<DataTypesOfficialSearchResponseWrapper>;
     /**
      * Search documents using store credentials with optional autocomplete suggestions and configurable stopwords/synonyms. Supports personalization via x-user-id, x-anon-id, x-session-id headers.
      * @summary Public Search API
@@ -58998,6 +59269,57 @@ export declare class SearchApi extends BaseAPI {
      * @memberof SearchApi
      */
     v1IndexIndexnameDefaultsGet(indexname: string, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<DataTypesSchemaBasedDefaultsResponseWrapper, any, {}>>;
+    /**
+     * Search documents using query parameters. Supports all features of POST endpoint.
+     * @summary Public Search API (GET)
+     * @param {string} xStoreid Store ID
+     * @param {string} xStoresecret Store Secret
+     * @param {string} q Search query
+     * @param {string} [xUserId] User ID for personalization
+     * @param {string} [xAnonId] Anonymous ID for personalization
+     * @param {string} [xSessionId] Session ID for personalization
+     * @param {number} [page] Page number (default: 1)
+     * @param {number} [perPage] Items per page (default: 10)
+     * @param {string} [sortBy] Sort option (e.g., price:asc, created_at:desc)
+     * @param {string} [filterBy] Filter string (e.g., category:shirts)
+     * @param {string} [facetBy] Facet fields (comma-separated)
+     * @param {number} [maxFacetValues] Maximum facet values to return
+     * @param {boolean} [widgetMode] Return widget-formatted results
+     * @param {boolean} [includeSuggestions] Include autocomplete suggestions
+     * @param {number} [suggestionsLimit] Number of suggestions to return
+     * @param {string} [analyticsTags] Analytics tags (comma-separated)
+     * @param {string} [stopwordSets] Stopword set IDs (comma-separated)
+     * @param {string} [synonymSets] Synonym set IDs (comma-separated)
+     * @param {string} [searchFields] Fields to search in (comma-separated)
+     * @param {string} [returnFields] Fields to return (comma-separated)
+     * @param {string} [omitFields] Fields to omit (comma-separated)
+     * @param {string} [snippetFields] Fields to generate snippets for (comma-separated)
+     * @param {string} [fullSnippetFields] Fields to include full snippet (comma-separated)
+     * @param {string} [fieldWeights] Field weights as comma-separated integers (e.g., 3,2,1)
+     * @param {string} [groupField] Field to group results by
+     * @param {number} [groupSize] Number of results per group
+     * @param {string} [snippetPrefix] Prefix for highlighted snippets
+     * @param {string} [snippetSuffix] Suffix for highlighted snippets
+     * @param {number} [snippetTokenLimit] Maximum tokens in snippet
+     * @param {number} [snippetMinLen] Minimum snippet length
+     * @param {boolean} [includeSnippets] Include snippets in results
+     * @param {string} [prefixMode] Prefix matching mode (e.g., always, fallback, off)
+     * @param {string} [infixMode] Infix matching mode (e.g., always, fallback, off)
+     * @param {number} [typoMax] Maximum typo tolerance
+     * @param {number} [typoMinLen1] Min word length for 1 typo
+     * @param {number} [typoMinLen2] Min word length for 2 typos
+     * @param {number} [searchTimeoutMs] Search timeout in milliseconds
+     * @param {boolean} [requireAllTerms] Require all search terms to match
+     * @param {boolean} [exactMatchBoost] Boost exact matches
+     * @param {boolean} [cacheResults] Cache search results
+     * @param {boolean} [applyRules] Apply search rules
+     * @param {string} [presetName] Search preset name to use
+     * @param {string} [facetSearchText] Text to filter facet values
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof SearchApi
+     */
+    v1SearchGet(xStoreid: string, xStoresecret: string, q: string, xUserId?: string, xAnonId?: string, xSessionId?: string, page?: number, perPage?: number, sortBy?: string, filterBy?: string, facetBy?: string, maxFacetValues?: number, widgetMode?: boolean, includeSuggestions?: boolean, suggestionsLimit?: number, analyticsTags?: string, stopwordSets?: string, synonymSets?: string, searchFields?: string, returnFields?: string, omitFields?: string, snippetFields?: string, fullSnippetFields?: string, fieldWeights?: string, groupField?: string, groupSize?: number, snippetPrefix?: string, snippetSuffix?: string, snippetTokenLimit?: number, snippetMinLen?: number, includeSnippets?: boolean, prefixMode?: string, infixMode?: string, typoMax?: number, typoMinLen1?: number, typoMinLen2?: number, searchTimeoutMs?: number, requireAllTerms?: boolean, exactMatchBoost?: boolean, cacheResults?: boolean, applyRules?: boolean, presetName?: string, facetSearchText?: string, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<DataTypesOfficialSearchResponseWrapper, any, {}>>;
     /**
      * Search documents using store credentials with optional autocomplete suggestions and configurable stopwords/synonyms. Supports personalization via x-user-id, x-anon-id, x-session-id headers.
      * @summary Public Search API