---
title: "Get multiple recommendation widgets"
method: POST
path: "/api/recommendation/v2/getbulkwidgetitems"
tags: ["Recommendation"]
---

# Get multiple recommendation widgets

`POST /api/recommendation/v2/getbulkwidgetitems`

Gets specific recommendations - each bulk request can contain up to 10 widgets.

## Request body

- RecommendationWidgetBulkRequest
  - `visitorId` string, uuid
  - `visitId` string, uuid
  - `enablePreview` boolean
  - `clientGuid` string
  - `landingPageUrl` string
  - `indexName` string
  - `widgets` RecommendationWidgetItem[]
    - `widgetGuid` string, uuid
    - `contextProperties` object
    - `customProperties` object
    - `uniqueId` string
  - `widgetBatchSize` integer

## Response `200`

OK

- RecommendationResponse
  - `widgetItems` RecommendationItemResponse[]
    - `recommendationItems` RecommendationItem[]
      - `brand` string
      - `price` string
      - `imageUrl` string
      - `isOnSale` boolean
      - `salePrice` string
      - `bestFragment` string
      - `color` string
      - `url` string
      - `id` string
      - `imageAlt` string
      - `imageOverAltTag` string
      - `imageOverUrl` string
      - `itemName` string
      - `maxPrice` string
      - `maxSalePrice` string
      - `minPrice` string
      - `minSalePrice` string
      - `postDate` string
      - `rating` string
      - `shortDescription` string
      - `sku` string
      - `itemIndex` integer
      - `modelName` string
      - `modelType` string
      - `modelGuid` string
      - `custom` object
      - `customDict` object
    - `html` string
    - `widgetGuid` string
    - `widgetName` string
    - `widgeTitle` string
    - `widgetCssClass` string
    - `isCarousel` boolean
    - `carouselData` CarouselData
      - `showNextPrevButtons` boolean
      - `autoRotate` boolean
      - `autoRotateSpeed` integer
      - `animationSpeed` integer
      - `nofVisible` integer
      - `isCircular` boolean
      - `scrollNumber` integer
      - `showDots` boolean
      - `enableResponsive` boolean
      - `responseiveConfig` string
    - `isVertical` boolean
    - `itemsCount` integer
    - `uniqueId` string
  - `isSuccess` boolean
  - `requestId` string, uuid
  - `responseMessage` string

---

[API](https://skmtc.net/hawksearch/apis/hawksearch-elasticsearch-indexingapi.md) · [All operations](https://skmtc.net/hawksearch/apis/hawksearch-elasticsearch-indexingapi/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hawksearch/hawksearch-elasticsearch-indexingapi/revisions/24cba7bf3468/schema)