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

# Suggestion items

`GET /suggestions/items/{instancekey}`

Service that returns product results 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

- SuggestionItemBlocks
  - `blocks` SuggestionItemBlock[]
    - `name` string — Block title
    - `items` SuggestionItem[]
      - `visualproperties` Visualproperties
        - `colspan` integer — The number of columns the item takes up.
        - `rowspan` integer — The number of rows the item takes up.
      - `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
    - `nrofitems` integer

## Other responses

- `401` — Invalid instancekey supplied

---

[API](https://skmtc.net/tweakwise/apis/frontend-api.md) · [All operations](https://skmtc.net/tweakwise/apis/frontend-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tweakwise/frontend-api/revisions/9bd1e2b3633f/schema)