---
title: "searchbanners"
method: GET
path: "/searchbanners/{instancekey}"
tags: ["Searchbanners"]
---

# searchbanners

`GET /searchbanners/{instancekey}`

## Request

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

Service that returns searchbanners based on a search term.

## Path parameters

- `instancekey` string, required

## Query parameters

- `tn_q` string, required
- `tn_cid` string
- `tn_keyboard` string

## Headers

- `TWN-Source` string

## Response `200`

Response with searchbanners

- SearchBanner[]
  - `imageurl` string: The image of the searchbanner
  - `clickurl` string: The url to go to if you click on the banner.
  - `clicktarget` string: Target to go to if banner is clicked (_blank: It opens the link in a new window. _self: It opens the linked document in the same frame.)
  - `type` string: The type where this banner will show: (Desktop | Mobile)
  - `location` string: Location of the banner: (ContainerTop | ListTop | ProductsTop)
  - `categoryid` integer: The categoryid where this banner is for

## 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)