SearchApi
All URIs are relative to https://business.apis.kesk.app/v1
| Method | HTTP request | Description |
|---|---|---|
| getSearchData | GET /search-data | Retrieve filter options and metadata for search functionality |
| searchAll | GET /search | Search for products, vendors, or services across the marketplace |
getSearchData
SearchDataResponse getSearchData(vendor_type_id)
Retrieve filter options and metadata for search functionality
Returns all available filter data including categories, subcategories, tags, and vendor-specific options to populate search forms and filters. This data helps users refine their search queries and discover available filtering options based on the selected vendor type.
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| vendor_type_id | Long | Optional vendor type ID to get vendor-specific filter options (e.g., restaurant categories vs pharmacy categories) | [optional] [default to null] |
Return type
Authorization
HTTP request headers
- Content-Type: Not defined
- Accept: application/json; charset=utf-8
searchAll
SearchResponse searchAll(keyword, category_id, subcategory_id, vendor_id, vendor_type_id, min_price, max_price, sort, filter, latitude, longitude, tags, type, is_open, merge)
Search for products, vendors, or services across the marketplace
Performs a unified search across all marketplace entities with support for keyword matching, category filtering, price ranges, geolocation-based sorting, and tag-based discovery. Results can be returned separately by type or merged based on the search parameters.
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| keyword | String | Search keyword to match against product names, vendor names, or service descriptions | [optional] [default to null] |
| category_id | Long | Filter results by specific category ID | [optional] [default to null] |
| subcategory_id | Long | Filter results by specific subcategory ID | [optional] [default to null] |
| vendor_id | Long | Filter results to show only items from a specific vendor | [optional] [default to null] |
| vendor_type_id | Long | Filter results by vendor type (e.g., restaurant, grocery, pharmacy) | [optional] [default to null] |
| min_price | Double | Minimum price filter for products and services | [optional] [default to null] |
| max_price | Double | Maximum price filter for products and services | [optional] [default to null] |
| sort | SortOrder | Sort order for results | [optional] [default to null] [enum: price_asc, price_desc, distance, popularity, asc, desc] |
| filter | String | Additional filter criteria as JSON string | [optional] [default to null] |
| latitude | Double | User’s latitude coordinate for distance-based sorting and availability | [optional] [default to null] |
| longitude | Double | User’s longitude coordinate for distance-based sorting and availability | [optional] [default to null] |
| tags | String | Tag IDs as JSON array or single ID for filtering by product/service tags | [optional] [default to null] |
| type | SearchType | Search type to limit results (product, vendor, or service). Omit to search all types | [optional] [default to null] [enum: product, service, vendor] |
| is_open | Boolean | Filter vendors/services by current open status (requires latitude/longitude) | [optional] [default to null] |
| merge | Boolean | When true, merges results into a single array based on search type. When false, returns separate arrays for each type | [optional] [default to null] |
Return type
Authorization
No authorization required
HTTP request headers
- Content-Type: Not defined
- Accept: application/json; charset=utf-8