UpSearch API (3)
Download OpenAPI specification:Download
UpSearch FrontApi
UpSearch is the third application in your project, primarily focused on e-commerce. It provides insights into all activities related to search usage and includes features for influencing search results.Since UpSearch contains data such as your products, categories, brands, and articles, it can also serve as an endpoint for displaying catalogs, data in mobile applications, and more.
Reindex project
Dispatches feed import jobs for all active feeds of a project, triggering a full reindex.
path Parameters
| id required | integer |
Request Body schema: application/jsonoptional
| collection_id | integer Optional: only reindex feeds for this collection |
| full | boolean Force full reload |
Responses
Request samples
- Payload
{- "collection_id": 0,
- "full": false
}List users
Returns paginated list of all platform users with project counts.
query Parameters
| page | integer Default: 1 |
| limit | integer <= 100 Default: 50 |
| search | string |
| status | string Enum: "active" "inactive" "all" |
| sort | string Default: "id" Enum: "id" "name" "email" "joined" "projects_owned" |
| order | string Default: "desc" Enum: "asc" "desc" |
| trial | string Enum: "true" "false" |
| super_admin | string Enum: "true" "false" |
| date_from | string <date> Registration date from (YYYY-MM-DD) |
| date_to | string <date> Registration date to (YYYY-MM-DD) |
| has_projects | string Enum: "true" "false" Filter users who own at least one project |
Responses
List audit logs
Returns paginated audit logs with optional filtering by entity type, action, user, and date range.
Authorizations:
query Parameters
| entity_type | string Filter by entity type (synonym, fixit, relevance_tuning, etc.) |
| action | string Enum: "create" "update" "delete" "bulk_create" "bulk_update" "bulk_delete" "import" "restore" Filter by action (create, update, delete) |
| user_id | integer Filter by user ID |
| from | string <date-time> Filter from date (ISO 8601 format) |
| to | string <date-time> Filter to date (ISO 8601 format) |
| search | string Search in entity_name and diff_summary |
| page | integer Default: 1 Page number (default: 1) |
| per_page | integer Default: 50 Items per page (default: 50, max: 100) |
Responses
Response Schema: application/json
| err | integer |
| msg | string |
| data | Array of objects |
object | |
object |
Response samples
- 200
{- "err": 0,
- "msg": "",
- "data": [
- { }
], - "meta": {
- "total": 0,
- "page": 0,
- "per_page": 0,
- "total_pages": 0
}, - "filters": {
- "entity_types": [
- "string"
], - "actions": [
- "string"
], - "users": [
- { }
]
}
}Get audit log by ID
Returns detailed information about a specific audit log entry including full diff.
Authorizations:
path Parameters
| id required | integer Audit log ID |
Responses
Response Schema: application/json
| err | integer |
| msg | string |
| data | object |
Response samples
- 200
{- "err": 0,
- "msg": "",
- "data": { }
}Get entity change history
Returns chronological history of all changes made to a specific entity.
Authorizations:
path Parameters
| type required | string Entity type |
| entityId required | string Entity ID |
Responses
Response Schema: application/json
| err | integer |
| msg | string |
| data | Array of objects |
Response samples
- 200
{- "err": 0,
- "msg": "",
- "data": [
- { }
]
}Get activity summary
Returns aggregated statistics about audit log activity.
Authorizations:
query Parameters
| period | string Default: "7d" Time period (7d, 30d, 90d) |
Responses
Response Schema: application/json
| err | integer |
| msg | string |
object |
Response samples
- 200
{- "err": 0,
- "msg": "",
- "data": {
- "period": "string",
- "total_changes": 0,
- "by_action": { },
- "by_entity_type": { },
- "by_user": [ ],
- "timeline": [ ]
}
}Refreshing Access Tokens: OAuth 2.0 Code Flow Mechanism
This request is part of the OAuth 2.0 authorization code flow. It allows clients to obtain a new access token by submitting a valid refresh token. The refresh token, which is issued during the initial authorization process, can be used to request a new access token without requiring the user to log in again.
Request Body schema: application/jsonrequired
The request format to call refresh-token to get a refresh token differs between the code flow and PKCE flow.
| client_id required | string The Upsearch-issued ID of your application, which is available on the Credentials page in the Upsearch Dashboard. Max Length 200 |
| client_secret required | string The Upsearch-issued application secret for your application, which is available on Credentials page in the Upsearch Dashboard. Max Length 1024. |
Responses
Response Schema: application/json
| access_token required | string A valid OAuth access token. Provide the access token in a header with every request to Connect API endpoints. |
| refresh_token required | string A refresh token. For more information, see Refresh, and Revoke token. |
| token_type required | string This value is always bearer. |
| expires_at required | string |
| refresh_token_expires_at | string The date when the refresh_token expires, in ISO 8601 format. |
| project_id required | integer The ID of the authorizing project. |
Request samples
- Payload
{- "client_id": "525ce0cee17d25297b9baaef0bd21b90",
- "client_secret": "da09ec117af274e11518c979cfae10dd711b4645810c87ba2a2fc0d59c3053a7"
}Response samples
- 200
- 404
- 422
- 429
{- "access_token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpYXQiOjE3MTI4NjQyMTEsImp0aSI6InZPb1R4NnJQTzdaLzY0bEQwWkZieFE9PSIsImlzcyI6ImFjY2Vzc190b2tlbiIsIm5iZiI6MTcxMjg2NDIxMSwiZXhwIjoxNzEyODY2MDExLCJkYXRhIjp7ImNsaWVud",
- "refresh_token": "BkY2RkZmE4NGFkNTUyY2FhNmQzMThkOGZkYmJiZCJ9fQ.phBbLvFB3Rkh_Gj1LCNLDovYdix5YhGfmBsm8vqOsyE.phBbLvFB3Rkh_Gj1LCNLDovYdix5YhGfmBsm8vqOsyE",
- "token_type": "bearer",
- "expires_at": "2024-06-03T22:19:44Z",
- "refresh_token_expires_at": "2024-08-03T22:19:44Z",
- "project_id": 200
}OAuth Token Generation: Issuing Access and Refresh Tokens
This endpoint generates and returns an OAuth access token and a refresh token. The access token is used to authenticate subsequent requests and is valid for 30 days, after which it expires. To avoid interrupting the user session, a refresh token is also provided. The refresh token allows the client to request a new access token without requiring re-authentication.
Request Body schema: application/jsonrequired
Tokens for verification can be found in the admin under the credentials option.
| client_id required | string The Upsearch-issued ID of your application, which is available on the Credentials page in the Upsearch Dashboard. Max Length 200 |
| client_secret required | string The Upsearch-issued application secret for your application, which is available on Credentials page in the Upsearch Dashboard. Max Length 1024. |
Responses
Response Schema: application/json
| access_token required | string A valid OAuth access token. Provide the access token in a header with every request to Connect API endpoints. |
| refresh_token required | string A refresh token. For more information, see Refresh, and Revoke token. |
| token_type required | string This value is always bearer. |
| expires_at required | string |
| refresh_token_expires_at | string The date when the refresh_token expires, in ISO 8601 format. |
| project_id required | integer The ID of the authorizing project. |
Request samples
- Payload
{- "client_id": "525ce0cee17d25297b9baaef0bd21b90",
- "client_secret": "da09ec117af274e11518c979cfae10dd711b4645810c87ba2a2fc0d59c3053a7"
}Response samples
- 200
- 404
- 422
- 429
{- "access_token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpYXQiOjE3MTI4NjQyMTEsImp0aSI6InZPb1R4NnJQTzdaLzY0bEQwWkZieFE9PSIsImlzcyI6ImFjY2Vzc190b2tlbiIsIm5iZiI6MTcxMjg2NDIxMSwiZXhwIjoxNzEyODY2MDExLCJkYXRhIjp7ImNsaWVud",
- "refresh_token": "BkY2RkZmE4NGFkNTUyY2FhNmQzMThkOGZkYmJiZCJ9fQ.phBbLvFB3Rkh_Gj1LCNLDovYdix5YhGfmBsm8vqOsyE.phBbLvFB3Rkh_Gj1LCNLDovYdix5YhGfmBsm8vqOsyE",
- "token_type": "bearer",
- "expires_at": "2024-06-03T22:19:44Z",
- "refresh_token_expires_at": "2024-08-03T22:19:44Z",
- "project_id": 200
}List all character filters
Returns all character filters configured for the current sales channel.
Authorizations:
Responses
Response Schema: application/json
| err | integer |
| msg | string |
Array of objects |
Response samples
- 200
{- "err": 0,
- "msg": "",
- "data": [
- {
- "id": 0,
- "term": "&",
- "sales_channel_id": 0
}
]
}Create a character filter
Adds a new character to be filtered during search. Common filters include punctuation marks and special characters.
Authorizations:
Request Body schema: application/jsonrequired
| term required | string The character to filter |
Responses
Response Schema: application/json
| err | integer |
| msg | string |
object |
Request samples
- Payload
{- "term": "&"
}Response samples
- 200
{- "err": 0,
- "msg": "",
- "data": {
- "id": 1,
- "term": "&",
- "sales_channel_id": 0
}
}Delete character filter
Removes a character filter by its ID.
Authorizations:
path Parameters
| id required | integer Character filter ID |
Responses
Response Schema: application/json
| err | integer |
| msg | string |
| data | null |
Response samples
- 200
{- "err": 0,
- "msg": "",
- "data": null
}Reset to default character filters
Removes all existing character filters and adds a predefined set of common special characters and punctuation marks.
Authorizations:
Responses
Response Schema: application/json
| err | integer |
| msg | string |
| data | Array of objects |
Response samples
- 200
{- "err": 0,
- "msg": "",
- "data": [
- { }
]
}List of all collections
Collections serve as indexes for various objects, commonly including products, brands, or categories. Access to a specific collection is facilitated through its unique code. Each collection contains objects that must have unique IDs. Additionally, data from these collections can be utilized for displaying information on the frontend, such as in catalogs, autocomplete features, search engine results pages (SERPs), or even mobile applications
header Parameters
| client-id required | string Example: 525ce0cee17d25297b9baaef0bd21b90 |
Responses
Response Schema: application/json
Array of objects (MasterShopFrontAPI.Collections.CollectionResponse DTO) $collections | |||||
Array
| |||||
Response samples
- 200
- 404
- 422
- 429
{- "collections": [
- {
- "name": "Produkty",
- "code": "products"
}
]
}Create new curation set with promoted and hidden products
Creates a new curation and links it to a specific collection. Allows setting promoted and hidden product IDs and associating search queries.
Authorizations:
Request Body schema: application/jsonrequired
| name required | string Name of the curation |
| collection_id required | integer ID of the linked collection |
| queries required | Array of strings Search queries triggering the curation |
| promoted required | Array of strings Product IDs to promote for this curation |
| hidden required | Array of strings Product IDs to hide for this curation |
| active | integer Whether the curation is active (1=active, 0=inactive) |
| valid_from | string or null <date-time> Start date/time when curation becomes active (ISO 8601 or Y-m-d H:i:s format) |
| valid_to | string or null <date-time> End date/time when curation becomes inactive (ISO 8601 or Y-m-d H:i:s format) |
Responses
Response Schema: application/json
required | object (UpSearch Curation ) Single curation configuration | ||||||||||||||||||
| |||||||||||||||||||
Request samples
- Payload
{- "name": "Letní kampaň 2025",
- "collection_id": 123,
- "queries": [
- "plavky",
- "dovolená"
], - "promoted": [
- "prod-001",
- "prod-002"
], - "hidden": [
- "prod-999"
], - "active": 1,
- "valid_from": "2026-01-15T00:00:00",
- "valid_to": "2026-02-28T23:59:59"
}Response samples
- 200
{- "curation": {
- "id": 1234,
- "name": "Letní kampaň 2025",
- "active": 1,
- "valid_from": "2026-01-15T00:00:00",
- "valid_to": "2026-02-28T23:59:59",
- "status": "active",
- "queries": [
- "plavky",
- "dovolená"
], - "promoted": [
- {
- "id": "prod-001",
- "name": "Modré plavky",
- "price": 699
}, - {
- "id": "prod-002",
- "name": "Letní klobouk",
- "price": 399
}
], - "hidden": [
- {
- "id": "prod-999",
- "name": "Zimní bunda",
- "price": 1999
}
]
}
}Query curated organic search results
Authorizations:
query Parameters
| curation_id required | integer |
| q required | string |
| excluded | Array of strings |
Responses
Response Schema: application/json
Array of objects (Simple Curation Item) | |||||||||||||||
Array
| |||||||||||||||
Response samples
- 200
{- "items": [
- {
- "_id": "1179798",
- "id": "5566",
- "code": "220600278",
- "name": "Cyklistické rukavice Castelli Mortirolo - černá",
- "title": "Pánské rukavice Castelli Mortirolo - s nimi budou vaše ruce vždy v teple.",
- "image_link": "data/images/products/72297/165226906201-4520533-085.jpg",
- "price_view": "{\"value\": 1299, \"currency\": \"CZK\"}"
}
]
}Get all curations in a collection
Authorizations:
path Parameters
| id required | integer |
Responses
Response Schema: application/json
required | Array of objects (UpSearch Curation ) List of curations | ||||||||||||||||||
Array
| |||||||||||||||||||
Response samples
- 200
{- "curations": [
- {
- "id": 1234,
- "name": "Letní kampaň 2025",
- "active": 1,
- "valid_from": "2026-01-15T00:00:00",
- "valid_to": "2026-02-28T23:59:59",
- "status": "active",
- "queries": [
- "plavky",
- "dovolená"
], - "promoted": [
- {
- "id": "prod-001",
- "name": "Modré plavky",
- "price": 699
}, - {
- "id": "prod-002",
- "name": "Letní klobouk",
- "price": 399
}
], - "hidden": [
- {
- "id": "prod-999",
- "name": "Zimní bunda",
- "price": 1999
}
]
}
]
}Get single curation by ID
Authorizations:
path Parameters
| id required | integer |
Responses
Response Schema: application/json
required | object (UpSearch Curation ) Single curation configuration | ||||||||||||||||||
| |||||||||||||||||||
Response samples
- 200
{- "curation": {
- "id": 1234,
- "name": "Letní kampaň 2025",
- "active": 1,
- "valid_from": "2026-01-15T00:00:00",
- "valid_to": "2026-02-28T23:59:59",
- "status": "active",
- "queries": [
- "plavky",
- "dovolená"
], - "promoted": [
- {
- "id": "prod-001",
- "name": "Modré plavky",
- "price": 699
}, - {
- "id": "prod-002",
- "name": "Letní klobouk",
- "price": 399
}
], - "hidden": [
- {
- "id": "prod-999",
- "name": "Zimní bunda",
- "price": 1999
}
]
}
}Update curation by ID
Authorizations:
path Parameters
| id required | integer |
Request Body schema: application/jsonrequired
| id required | integer Unique ID of the curation |
| name required | string Name of the curation |
| active | integer Whether the curation is active |
| valid_from | string or null <date-time> Start date/time when curation becomes active (ISO 8601 format) |
| valid_to | string or null <date-time> End date/time when curation becomes inactive (ISO 8601 format) |
| status | string Enum: "active" "inactive" "scheduled" "expired" Current status of the curation (active, inactive, scheduled, expired) |
| queries required | Array of strings List of search queries that trigger this curation |
| promoted required | Array of objects List of promoted items with full data |
| hidden required | Array of objects List of hidden items with full data |
Responses
Response Schema: application/json
required | object (UpSearch Curation ) Single curation configuration | ||||||||||||||||||
| |||||||||||||||||||
Request samples
- Payload
{- "id": 1234,
- "name": "Letní kampaň 2025",
- "active": 1,
- "valid_from": "2026-01-15T00:00:00",
- "valid_to": "2026-02-28T23:59:59",
- "status": "active",
- "queries": [
- "plavky",
- "dovolená"
], - "promoted": [
- {
- "id": "prod-001",
- "name": "Modré plavky",
- "price": 699
}, - {
- "id": "prod-002",
- "name": "Letní klobouk",
- "price": 399
}
], - "hidden": [
- {
- "id": "prod-999",
- "name": "Zimní bunda",
- "price": 1999
}
]
}Response samples
- 200
{- "curation": {
- "id": 1234,
- "name": "Letní kampaň 2025",
- "active": 1,
- "valid_from": "2026-01-15T00:00:00",
- "valid_to": "2026-02-28T23:59:59",
- "status": "active",
- "queries": [
- "plavky",
- "dovolená"
], - "promoted": [
- {
- "id": "prod-001",
- "name": "Modré plavky",
- "price": 699
}, - {
- "id": "prod-002",
- "name": "Letní klobouk",
- "price": 399
}
], - "hidden": [
- {
- "id": "prod-999",
- "name": "Zimní bunda",
- "price": 1999
}
]
}
}Delete curation by ID
Authorizations:
path Parameters
| id required | integer |
Responses
Response Schema: application/json
required | Array of objects (UpSearch Curation ) List of curations | ||||||||||||||||||
Array
| |||||||||||||||||||
Response samples
- 200
{- "curations": [
- {
- "id": 1234,
- "name": "Letní kampaň 2025",
- "active": 1,
- "valid_from": "2026-01-15T00:00:00",
- "valid_to": "2026-02-28T23:59:59",
- "status": "active",
- "queries": [
- "plavky",
- "dovolená"
], - "promoted": [
- {
- "id": "prod-001",
- "name": "Modré plavky",
- "price": 699
}, - {
- "id": "prod-002",
- "name": "Letní klobouk",
- "price": 399
}
], - "hidden": [
- {
- "id": "prod-999",
- "name": "Zimní bunda",
- "price": 1999
}
]
}
]
}Bulk update curations (activate/deactivate)
Authorizations:
Request Body schema: application/jsonrequired
| ids | Array of integers |
| active | integer 1 to activate, 0 to deactivate |
Responses
Response Schema: application/json
| updated | integer |
Request samples
- Payload
{- "ids": [
- 1,
- 2,
- 3
], - "active": 1
}Response samples
- 200
{- "updated": 3
}Duplicate a curation
Authorizations:
path Parameters
| id required | integer |
Responses
Response Schema: application/json
required | object (UpSearch Curation ) Single curation configuration | ||||||||||||||||||
| |||||||||||||||||||
Response samples
- 200
{- "curation": {
- "id": 1234,
- "name": "Letní kampaň 2025",
- "active": 1,
- "valid_from": "2026-01-15T00:00:00",
- "valid_to": "2026-02-28T23:59:59",
- "status": "active",
- "queries": [
- "plavky",
- "dovolená"
], - "promoted": [
- {
- "id": "prod-001",
- "name": "Modré plavky",
- "price": 699
}, - {
- "id": "prod-002",
- "name": "Letní klobouk",
- "price": 399
}
], - "hidden": [
- {
- "id": "prod-999",
- "name": "Zimní bunda",
- "price": 1999
}
]
}
}Bulk delete curations
Authorizations:
Request Body schema: application/jsonrequired
| ids | Array of integers |
Responses
Response Schema: application/json
| deleted | integer |
Request samples
- Payload
{- "ids": [
- 1,
- 2,
- 3
]
}Response samples
- 200
{- "deleted": 3
}Uložit konfiguraci designeru pro autocomplete a SERP
Ukládá kompletní designer konfigurační objekt včetně stylů, logiky a vizuálních komponent autocomplete i výsledkové stránky. Ukládá se pro konkrétní prodejní kanál.
Authorizations:
path Parameters
| status required | string Enum: "draft" "published" draft | published |
Request Body schema: application/jsonrequired
object (Styling Proměnné) CSS proměnné pro úpravu vzhledu autocomplete a SERP widgetu. | |
object (Společné vlastnosti pro autocomplete i SERP) Konfigurační volby společné pro oba widgety – vzhled, chování tlačítek, ikon, překladů a dalších prvků. | |
object (Konfigurace našeptávače) Nastavení vzhledu, struktury a chování našeptávače (autocomplete). | |
object (Konfigurace výsledků vyhledávání) Nastavení struktury, navigace a vzhledu výsledkové stránky (SERP). | |
object (Chování vkládání do košíku) Vlastní JavaScriptová funkce pro vložení produktu do košíku. |
Responses
Response Schema: application/json
object (Styling Proměnné) CSS proměnné pro úpravu vzhledu autocomplete a SERP widgetu. | |
object (Společné vlastnosti pro autocomplete i SERP) Konfigurační volby společné pro oba widgety – vzhled, chování tlačítek, ikon, překladů a dalších prvků. | |
object (Konfigurace našeptávače) Nastavení vzhledu, struktury a chování našeptávače (autocomplete). | |
object (Konfigurace výsledků vyhledávání) Nastavení struktury, navigace a vzhledu výsledkové stránky (SERP). | |
object (Chování vkládání do košíku) Vlastní JavaScriptová funkce pro vložení produktu do košíku. |
Request samples
- Payload
{- "style_variables": {
- "color_primary": "#26237f",
- "color_secondary": "#deebfb",
- "color_text": "#0b093b",
- "color_black": "#0b093b",
- "color_white": "#ffffff",
- "color_red": "#ff0000",
- "color_green": "#008800",
- "color_orange": "#ffaa00",
- "color_gray": "#999999",
- "color_bd": "#dddddd",
- "color_bg": "#eeeeee",
- "color_link": "#26237f",
- "color_hover": "#0b093b",
- "color_shadow": "#0B093B40",
- "color_overlay": "#0B093BCC",
- "font_primary": "-apple-system, blinkmacsystemfont, 'Segoe UI', roboto, helvetica, arial, sans-serif",
- "font_secondary": "",
- "font_size": "14px",
- "font_size_sm": "12px",
- "font_size_md": "16px",
- "font_size_h1": "16px",
- "font_size_h2": "20px",
- "font_size_h3": "18px",
- "font_size_h4": "16px",
- "font_size_h5": "14px",
- "font_size_h6": "12px",
- "z_index": "100",
- "font_weight_thin": "100",
- "font_weight_extra_light": "200",
- "font_weight_light": "300",
- "font_weight_normal": "400",
- "font_weight_medium": "500",
- "font_weight_semi_bold": "600",
- "font_weight_bold": "700",
- "font_weight_extra_bold": "800",
- "font_weight_black": "900",
- "line_height": "calc(20 / 14)",
- "spacing_none": "0",
- "spacing_sm": "10px",
- "spacing_md": "20px",
- "spacing_lg": "40px",
- "typo_space_vertical": "1.25em",
- "border_radius_none": "0",
- "border_radius_xs": "2px",
- "border_radius_sm": "4px",
- "border_radius_md": "8px",
- "border_radius_lg": "12px",
- "border_size_none": "0",
- "border_size_sm": "1px",
- "border_size_md": "2px",
- "articles_count_xs": "1",
- "articles_count_sm": "1",
- "articles_count_md": "2",
- "articles_count_lg": "3",
- "articles_count_xl": "4",
- "articles_min_width_xxl": "300px",
- "articles_max_width_xxl": "350px",
- "articles_gap_xs": "10px",
- "articles_gap_sm": "10px",
- "articles_gap_md": "10px",
- "articles_gap_lg": "20px",
- "articles_gap_xl": "20px",
- "articles_gap_xxl": "20px",
- "suggest_products_count_xs": "1",
- "suggest_products_count_sm": "2",
- "suggest_products_count_md": "3",
- "suggest_products_count_lg": "3",
- "suggest_products_count_xl": "4",
- "suggest_products_count_xxl": "5",
- "suggest_products_gap_xs": "10px",
- "suggest_products_gap_sm": "10px",
- "suggest_products_gap_md": "10px",
- "suggest_products_gap_lg": "20px",
- "suggest_products_gap_xl": "20px",
- "suggest_products_gap_xxl": "20px",
- "products_count_xs": "1",
- "products_count_sm": "2",
- "products_count_md": "3",
- "products_count_lg": "3",
- "products_count_xl": "4",
- "products_count_xxl": "5",
- "products_gap_xs": "10px",
- "products_gap_sm": "10px",
- "products_gap_md": "10px",
- "products_gap_lg": "20px",
- "products_gap_xl": "20px",
- "products_gap_xxl": "20px",
- "suggest_products_inline_count_xs": "1",
- "suggest_products_inline_count_sm": "2",
- "suggest_products_inline_count_md": "2",
- "suggest_products_inline_count_lg": "2",
- "suggest_products_inline_count_xl": "3",
- "suggest_products_inline_count_xxl": "4",
- "suggest_products_inline_gap_xs": "40px",
- "suggest_products_inline_gap_sm": "40px",
- "suggest_products_inline_gap_md": "40px",
- "suggest_products_inline_gap_lg": "40px",
- "suggest_products_inline_gap_xl": "40px",
- "suggest_products_inline_gap_xxl": "40px",
- "suggest_max_height": "200px",
- "transitions_length": "0.3s",
- "price_with_code_bg": "#fff3cd",
- "price_with_code_color": "#856404",
- "price_with_code_padding": "4px 8px",
- "price_with_code_font_size": "12px",
- "price_with_code_urgent_bg": "#f8d7da",
- "price_with_code_urgent_color": "#721c24"
}, - "shared_config": {
- "cssUrl": "string",
- "highlightSearchPhrase": true,
- "addToCart": "string",
- "showBadges": true,
- "showOldPrice": true,
- "showDiscountInPercent": true,
- "showPriceWithCode": true,
- "priceWithCodeTemplate": "string",
- "showStockInfo": true,
- "showAddToCart": true,
- "searchButtonIcon": "string",
- "searchButtonVariant": "primary",
- "searchButtonSize": "sm",
- "showSearchButtonText": true,
- "searchButtonInsideInput": true,
- "addToCartButtonIcon": "string",
- "ratingStarEmptyIcon": "string",
- "ratingStarFullIcon": "string",
- "showInlineFeatures": true,
- "customCss": "string",
- "customJs": "string"
}, - "autocomplete_config": {
- "resultsPageUrlPath": "string",
- "injectAs": "input",
- "suggestAltTargetElement": "string",
- "layout": "row",
- "productBoxLayout": "inline",
- "phraseBoxLayout": "inline",
- "showInputPlaceholder": true,
- "showSimpleBlockIcon": true,
- "showSimpleBlockCount": true,
- "simpleBlockJustifyItems": "left",
- "showTotalCount": true,
- "showTopProduct": true,
- "resetSuggestInputIcon": "string",
- "closeSuggestIcon": "string",
- "completeResultsButtonIcon": "string",
- "completeResultsButtonVariant": "primary",
- "completeResultsButtonSize": "sm",
- "phraseListItemIcon": "string",
- "brandListItemIcon": "string",
- "categoryListItemIcon": "string",
- "articleListItemIcon": "string",
- "pageListItemIcon": "string",
- "suggestAltButtonIcon": "string",
- "suggestAltButtonVariant": "primary",
- "suggestAltButtonSize": "sm",
- "showSuggestAltButtonText": true,
- "showPoweredByInSidebar": true,
- "showTypewriterEffect": true
}, - "results_config": {
- "showTextSearchInFilters": true,
- "showItemsCountInTabs": true,
- "showPaging": true,
- "showLoadMore": true,
- "showSearchInput": true,
- "infiniteScrolling": true,
- "collapsibleFilters": true,
- "filterJustifyItems": "left",
- "loadMoreButtonIcon": "string",
- "pagingNextIcon": "string",
- "pagingPrevIcon": "string",
- "filterButtonIcon": "string",
- "showArticleImage": true,
- "minFilterItemsToSearch": 0,
- "showSorting": true,
- "showLinkedItems": true,
- "maxLinkedItemsCount": 0
}, - "cart_behavior": {
- "js": "window.shopAddToCart = (code) => { console.log('Přidávám produkt', code); };"
}
}Response samples
- 200
{- "style_variables": {
- "color_primary": "#26237f",
- "color_secondary": "#deebfb",
- "color_text": "#0b093b",
- "color_black": "#0b093b",
- "color_white": "#ffffff",
- "color_red": "#ff0000",
- "color_green": "#008800",
- "color_orange": "#ffaa00",
- "color_gray": "#999999",
- "color_bd": "#dddddd",
- "color_bg": "#eeeeee",
- "color_link": "#26237f",
- "color_hover": "#0b093b",
- "color_shadow": "#0B093B40",
- "color_overlay": "#0B093BCC",
- "font_primary": "-apple-system, blinkmacsystemfont, 'Segoe UI', roboto, helvetica, arial, sans-serif",
- "font_secondary": "",
- "font_size": "14px",
- "font_size_sm": "12px",
- "font_size_md": "16px",
- "font_size_h1": "16px",
- "font_size_h2": "20px",
- "font_size_h3": "18px",
- "font_size_h4": "16px",
- "font_size_h5": "14px",
- "font_size_h6": "12px",
- "z_index": "100",
- "font_weight_thin": "100",
- "font_weight_extra_light": "200",
- "font_weight_light": "300",
- "font_weight_normal": "400",
- "font_weight_medium": "500",
- "font_weight_semi_bold": "600",
- "font_weight_bold": "700",
- "font_weight_extra_bold": "800",
- "font_weight_black": "900",
- "line_height": "calc(20 / 14)",
- "spacing_none": "0",
- "spacing_sm": "10px",
- "spacing_md": "20px",
- "spacing_lg": "40px",
- "typo_space_vertical": "1.25em",
- "border_radius_none": "0",
- "border_radius_xs": "2px",
- "border_radius_sm": "4px",
- "border_radius_md": "8px",
- "border_radius_lg": "12px",
- "border_size_none": "0",
- "border_size_sm": "1px",
- "border_size_md": "2px",
- "articles_count_xs": "1",
- "articles_count_sm": "1",
- "articles_count_md": "2",
- "articles_count_lg": "3",
- "articles_count_xl": "4",
- "articles_min_width_xxl": "300px",
- "articles_max_width_xxl": "350px",
- "articles_gap_xs": "10px",
- "articles_gap_sm": "10px",
- "articles_gap_md": "10px",
- "articles_gap_lg": "20px",
- "articles_gap_xl": "20px",
- "articles_gap_xxl": "20px",
- "suggest_products_count_xs": "1",
- "suggest_products_count_sm": "2",
- "suggest_products_count_md": "3",
- "suggest_products_count_lg": "3",
- "suggest_products_count_xl": "4",
- "suggest_products_count_xxl": "5",
- "suggest_products_gap_xs": "10px",
- "suggest_products_gap_sm": "10px",
- "suggest_products_gap_md": "10px",
- "suggest_products_gap_lg": "20px",
- "suggest_products_gap_xl": "20px",
- "suggest_products_gap_xxl": "20px",
- "products_count_xs": "1",
- "products_count_sm": "2",
- "products_count_md": "3",
- "products_count_lg": "3",
- "products_count_xl": "4",
- "products_count_xxl": "5",
- "products_gap_xs": "10px",
- "products_gap_sm": "10px",
- "products_gap_md": "10px",
- "products_gap_lg": "20px",
- "products_gap_xl": "20px",
- "products_gap_xxl": "20px",
- "suggest_products_inline_count_xs": "1",
- "suggest_products_inline_count_sm": "2",
- "suggest_products_inline_count_md": "2",
- "suggest_products_inline_count_lg": "2",
- "suggest_products_inline_count_xl": "3",
- "suggest_products_inline_count_xxl": "4",
- "suggest_products_inline_gap_xs": "40px",
- "suggest_products_inline_gap_sm": "40px",
- "suggest_products_inline_gap_md": "40px",
- "suggest_products_inline_gap_lg": "40px",
- "suggest_products_inline_gap_xl": "40px",
- "suggest_products_inline_gap_xxl": "40px",
- "suggest_max_height": "200px",
- "transitions_length": "0.3s",
- "price_with_code_bg": "#fff3cd",
- "price_with_code_color": "#856404",
- "price_with_code_padding": "4px 8px",
- "price_with_code_font_size": "12px",
- "price_with_code_urgent_bg": "#f8d7da",
- "price_with_code_urgent_color": "#721c24"
}, - "shared_config": {
- "cssUrl": "string",
- "highlightSearchPhrase": true,
- "addToCart": "string",
- "showBadges": true,
- "showOldPrice": true,
- "showDiscountInPercent": true,
- "showPriceWithCode": true,
- "priceWithCodeTemplate": "string",
- "showStockInfo": true,
- "showAddToCart": true,
- "searchButtonIcon": "string",
- "searchButtonVariant": "primary",
- "searchButtonSize": "sm",
- "showSearchButtonText": true,
- "searchButtonInsideInput": true,
- "addToCartButtonIcon": "string",
- "ratingStarEmptyIcon": "string",
- "ratingStarFullIcon": "string",
- "showInlineFeatures": true,
- "customCss": "string",
- "customJs": "string"
}, - "autocomplete_config": {
- "resultsPageUrlPath": "string",
- "injectAs": "input",
- "suggestAltTargetElement": "string",
- "layout": "row",
- "productBoxLayout": "inline",
- "phraseBoxLayout": "inline",
- "showInputPlaceholder": true,
- "showSimpleBlockIcon": true,
- "showSimpleBlockCount": true,
- "simpleBlockJustifyItems": "left",
- "showTotalCount": true,
- "showTopProduct": true,
- "resetSuggestInputIcon": "string",
- "closeSuggestIcon": "string",
- "completeResultsButtonIcon": "string",
- "completeResultsButtonVariant": "primary",
- "completeResultsButtonSize": "sm",
- "phraseListItemIcon": "string",
- "brandListItemIcon": "string",
- "categoryListItemIcon": "string",
- "articleListItemIcon": "string",
- "pageListItemIcon": "string",
- "suggestAltButtonIcon": "string",
- "suggestAltButtonVariant": "primary",
- "suggestAltButtonSize": "sm",
- "showSuggestAltButtonText": true,
- "showPoweredByInSidebar": true,
- "showTypewriterEffect": true
}, - "results_config": {
- "showTextSearchInFilters": true,
- "showItemsCountInTabs": true,
- "showPaging": true,
- "showLoadMore": true,
- "showSearchInput": true,
- "infiniteScrolling": true,
- "collapsibleFilters": true,
- "filterJustifyItems": "left",
- "loadMoreButtonIcon": "string",
- "pagingNextIcon": "string",
- "pagingPrevIcon": "string",
- "filterButtonIcon": "string",
- "showArticleImage": true,
- "minFilterItemsToSearch": 0,
- "showSorting": true,
- "showLinkedItems": true,
- "maxLinkedItemsCount": 0
}, - "cart_behavior": {
- "js": "window.shopAddToCart = (code) => { console.log('Přidávám produkt', code); };"
}
}Načíst konfiguraci designeru
Vrací kompletní designer konfiguraci pro aktuální projekt a prodejní kanál.
Authorizations:
Responses
Response Schema: application/json
object (Styling Proměnné) CSS proměnné pro úpravu vzhledu autocomplete a SERP widgetu. | |
object (Společné vlastnosti pro autocomplete i SERP) Konfigurační volby společné pro oba widgety – vzhled, chování tlačítek, ikon, překladů a dalších prvků. | |
object (Konfigurace našeptávače) Nastavení vzhledu, struktury a chování našeptávače (autocomplete). | |
object (Konfigurace výsledků vyhledávání) Nastavení struktury, navigace a vzhledu výsledkové stránky (SERP). | |
object (Chování vkládání do košíku) Vlastní JavaScriptová funkce pro vložení produktu do košíku. |
Response samples
- 200
{- "style_variables": {
- "color_primary": "#26237f",
- "color_secondary": "#deebfb",
- "color_text": "#0b093b",
- "color_black": "#0b093b",
- "color_white": "#ffffff",
- "color_red": "#ff0000",
- "color_green": "#008800",
- "color_orange": "#ffaa00",
- "color_gray": "#999999",
- "color_bd": "#dddddd",
- "color_bg": "#eeeeee",
- "color_link": "#26237f",
- "color_hover": "#0b093b",
- "color_shadow": "#0B093B40",
- "color_overlay": "#0B093BCC",
- "font_primary": "-apple-system, blinkmacsystemfont, 'Segoe UI', roboto, helvetica, arial, sans-serif",
- "font_secondary": "",
- "font_size": "14px",
- "font_size_sm": "12px",
- "font_size_md": "16px",
- "font_size_h1": "16px",
- "font_size_h2": "20px",
- "font_size_h3": "18px",
- "font_size_h4": "16px",
- "font_size_h5": "14px",
- "font_size_h6": "12px",
- "z_index": "100",
- "font_weight_thin": "100",
- "font_weight_extra_light": "200",
- "font_weight_light": "300",
- "font_weight_normal": "400",
- "font_weight_medium": "500",
- "font_weight_semi_bold": "600",
- "font_weight_bold": "700",
- "font_weight_extra_bold": "800",
- "font_weight_black": "900",
- "line_height": "calc(20 / 14)",
- "spacing_none": "0",
- "spacing_sm": "10px",
- "spacing_md": "20px",
- "spacing_lg": "40px",
- "typo_space_vertical": "1.25em",
- "border_radius_none": "0",
- "border_radius_xs": "2px",
- "border_radius_sm": "4px",
- "border_radius_md": "8px",
- "border_radius_lg": "12px",
- "border_size_none": "0",
- "border_size_sm": "1px",
- "border_size_md": "2px",
- "articles_count_xs": "1",
- "articles_count_sm": "1",
- "articles_count_md": "2",
- "articles_count_lg": "3",
- "articles_count_xl": "4",
- "articles_min_width_xxl": "300px",
- "articles_max_width_xxl": "350px",
- "articles_gap_xs": "10px",
- "articles_gap_sm": "10px",
- "articles_gap_md": "10px",
- "articles_gap_lg": "20px",
- "articles_gap_xl": "20px",
- "articles_gap_xxl": "20px",
- "suggest_products_count_xs": "1",
- "suggest_products_count_sm": "2",
- "suggest_products_count_md": "3",
- "suggest_products_count_lg": "3",
- "suggest_products_count_xl": "4",
- "suggest_products_count_xxl": "5",
- "suggest_products_gap_xs": "10px",
- "suggest_products_gap_sm": "10px",
- "suggest_products_gap_md": "10px",
- "suggest_products_gap_lg": "20px",
- "suggest_products_gap_xl": "20px",
- "suggest_products_gap_xxl": "20px",
- "products_count_xs": "1",
- "products_count_sm": "2",
- "products_count_md": "3",
- "products_count_lg": "3",
- "products_count_xl": "4",
- "products_count_xxl": "5",
- "products_gap_xs": "10px",
- "products_gap_sm": "10px",
- "products_gap_md": "10px",
- "products_gap_lg": "20px",
- "products_gap_xl": "20px",
- "products_gap_xxl": "20px",
- "suggest_products_inline_count_xs": "1",
- "suggest_products_inline_count_sm": "2",
- "suggest_products_inline_count_md": "2",
- "suggest_products_inline_count_lg": "2",
- "suggest_products_inline_count_xl": "3",
- "suggest_products_inline_count_xxl": "4",
- "suggest_products_inline_gap_xs": "40px",
- "suggest_products_inline_gap_sm": "40px",
- "suggest_products_inline_gap_md": "40px",
- "suggest_products_inline_gap_lg": "40px",
- "suggest_products_inline_gap_xl": "40px",
- "suggest_products_inline_gap_xxl": "40px",
- "suggest_max_height": "200px",
- "transitions_length": "0.3s",
- "price_with_code_bg": "#fff3cd",
- "price_with_code_color": "#856404",
- "price_with_code_padding": "4px 8px",
- "price_with_code_font_size": "12px",
- "price_with_code_urgent_bg": "#f8d7da",
- "price_with_code_urgent_color": "#721c24"
}, - "shared_config": {
- "cssUrl": "string",
- "highlightSearchPhrase": true,
- "addToCart": "string",
- "showBadges": true,
- "showOldPrice": true,
- "showDiscountInPercent": true,
- "showPriceWithCode": true,
- "priceWithCodeTemplate": "string",
- "showStockInfo": true,
- "showAddToCart": true,
- "searchButtonIcon": "string",
- "searchButtonVariant": "primary",
- "searchButtonSize": "sm",
- "showSearchButtonText": true,
- "searchButtonInsideInput": true,
- "addToCartButtonIcon": "string",
- "ratingStarEmptyIcon": "string",
- "ratingStarFullIcon": "string",
- "showInlineFeatures": true,
- "customCss": "string",
- "customJs": "string"
}, - "autocomplete_config": {
- "resultsPageUrlPath": "string",
- "injectAs": "input",
- "suggestAltTargetElement": "string",
- "layout": "row",
- "productBoxLayout": "inline",
- "phraseBoxLayout": "inline",
- "showInputPlaceholder": true,
- "showSimpleBlockIcon": true,
- "showSimpleBlockCount": true,
- "simpleBlockJustifyItems": "left",
- "showTotalCount": true,
- "showTopProduct": true,
- "resetSuggestInputIcon": "string",
- "closeSuggestIcon": "string",
- "completeResultsButtonIcon": "string",
- "completeResultsButtonVariant": "primary",
- "completeResultsButtonSize": "sm",
- "phraseListItemIcon": "string",
- "brandListItemIcon": "string",
- "categoryListItemIcon": "string",
- "articleListItemIcon": "string",
- "pageListItemIcon": "string",
- "suggestAltButtonIcon": "string",
- "suggestAltButtonVariant": "primary",
- "suggestAltButtonSize": "sm",
- "showSuggestAltButtonText": true,
- "showPoweredByInSidebar": true,
- "showTypewriterEffect": true
}, - "results_config": {
- "showTextSearchInFilters": true,
- "showItemsCountInTabs": true,
- "showPaging": true,
- "showLoadMore": true,
- "showSearchInput": true,
- "infiniteScrolling": true,
- "collapsibleFilters": true,
- "filterJustifyItems": "left",
- "loadMoreButtonIcon": "string",
- "pagingNextIcon": "string",
- "pagingPrevIcon": "string",
- "filterButtonIcon": "string",
- "showArticleImage": true,
- "minFilterItemsToSearch": 0,
- "showSorting": true,
- "showLinkedItems": true,
- "maxLinkedItemsCount": 0
}, - "cart_behavior": {
- "js": "window.shopAddToCart = (code) => { console.log('Přidávám produkt', code); };"
}
}Načíst konfigurační JSON pro upSearch
Vrací konfiguraci pro UpSearch autocomplete, výsledky a styly.
Authorizations:
path Parameters
| status required | string Enum: "published" "draft" published | draft |
Responses
Response Schema: application/json
object | |||||||
| |||||||