---
title: "Suggestion items grouped"
method: GET
path: "/suggestions/items/grouped/{instancekey}"
tags: ["Suggestions"]
---

# Suggestion items grouped

`GET /suggestions/items/grouped/{instancekey}`

## Request

- Base URL: `https://gateway.tweakwisenavigator.com`
- URL: `https://gateway.tweakwisenavigator.com/suggestions/items/grouped/{instancekey}`
- Auth: none declared

Service that returns product suggestions (grouped) based on a search term. This service can be called as soon as the user begins to type a search term.

## Path parameters

- `instancekey` string, required

## Query parameters

- `tn_q` string, required
- `tn_cid` string, required
- `tn_lang` string
- `tn_parameters` string
- `tn_parameters_except` string
- `tn_profilekey` string
- `tn_edc_parameters` string
- `tn_keyboard` string
- `tn_options` string[]

## Headers

- `TWN-Source` string

## Response `200`

Response with suggested items

- SuggestionItemBlocksGrouped
  - `blocks` SuggestionItemBlockGrouped[]
    - `name` string: Block title
    - `groups` SuggestionsGroup[]
      - `code` string: Group key
      - `items` SuggestionGroupedItem[]
        - `type` string: Type of item
        - `itemno` string: Product number
        - `title` string: Product title
        - `price` string: Product price
        - `brand` string: Brand
        - `image` string: Image
        - `url` string: Url
        - `attributes` SuggestionItemAttribute[]
          - `name` string: Attribute url key
          - `values` string[]
        - `origin` SuggestionItemOrigin
          - `type` string: Type of origin
          - `name` string: Display name of the origin
          - `itemreference` string: Item reference for the origin
      - `visualproperties` Visualproperties
        - `colspan` integer: The number of columns the item takes up.
        - `rowspan` integer: The number of rows the item takes up.
    - `nrofitems` integer

## Other responses

- `401`: Invalid instancekey supplied

---

[API](https://skmtc.dev/tweakwise/apis/delivery-api.md) - [All operations](https://skmtc.dev/tweakwise/apis/delivery-api/llms.txt) - [OpenAPI document](https://skmtc.dev/tweakwise/apis/delivery-api/revisions/8b9edcf45234?raw)