Nakupy|Shop items

List shop items attributes

List shop items attributes based on various filters and parameters.

get/nakupy/shop-items/

Request

  • Base URL: https://api.sklik.cz/v1
  • URL: https://api.sklik.cz/v1/nakupy/shop-items/
  • Auth: OAuth 2 (authorization code, authorization URL https://www.sklik.cz/oauth/api, token URL /user/token; client credentials, token URL /user/token)

Query parameters

premiseIdinteger required

ID of the shop on whose behalf the request is made.

pairedboolean

Filter to select only shop items (not) paired to product. If not specified both paired and unpaired shop items are shown.

Example:true
productCategoryIdinteger

Filter to select shop items with paired product in specified category.
Conflicts with productSegmentId

Example:123456
productSegmentIdinteger

Filter to select shop items with paired product in specified category segment
Conflicts with productCategoryId

Example:7890
shopItemCategoryIdinteger

Filter to select shop items in a specific category.
Conflicts with shopItemSegmentId

Example:123
shopItemSegmentIdinteger

Filter to select shop items in specified category segment.
Conflicts with shopItemCategoryId

Example:456
shopItemManufacturerIdinteger

Filter to select shop items with specified manufacturer. Manufacturer id is assigned by Seznam.

Example:2545885419621716000
productManufacturerIdinteger

Filter to select shop items with paired product with specified manufacturer.
Manufacturer id is assigned by Seznam.

Example:2545885419621716000
limitinteger

Maximum number of returned shop items.
If loadSearchInfo is true, limit must be <= 300.
If loadProductDetail is true, limit must be <= 50.

Example:100
offsetinteger

Cursor for pagination. Use the value from the response's meta.offset field to retrieve the next batch. This is an opaque value and should not be modified or calculated by the client.
Do not provide on the initial request.

itemIdstring[]

Filter to list only shop items with specified ITEM_ID.
If loadProductDetail is true, max 50 itemId values are allowed.

[
  "item1",
  "item2"
]
loadProductDetailboolean

Filter to load additional information (max cpc, position in top shop items) about paired shop item.
Request may be slow.

loadSearchInfoboolean

Flag to load additional information (max cpc for Zboží inzeráty) about shop item.
Request may be slow.

includedConditionstring[]

Filter items with specified conditions.
Conflicts with excludedCondition.

[
  "new",
  "used"
]
excludedConditionstring[]

Exclude items with specified conditions.
Conflicts with includedCondition.

[
  "refurbished"
]

Response

Successful Response

Example response

{
  "items": [
    {
      "categoryId": 624,
      "condition": "used",
      "itemId": "ITEM_953213",
      "manufacturerId": 2545885419621716000,
      "matchingId": "a76dba8b635e4102527d7efe5def58ad",
      "maxCpcSearch": 2.28,
      "minCpc": 1.28,
      "name": "Apple iPhone Xs, 512GB",
      "product": {
        "categoryId": 81,
        "manufacturerId": 2545885419621716000,
        "productDetailInfo": {
          "fromCheapestPosition": 2,
          "maxCpc": 42.38,
          "datetime": "2017-06-17T11:03:17Z",
          "topPosition": 1
        },
        "productId": 5350080
      },
      "searchDataDatetime": "2017-06-17T11:03:17Z"
    }
  ],
  "meta": {
    "offset": 16053027151923073000,
    "totalCount": 81349
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.