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

# searchbanners

`GET /searchbanners/{instancekey}`

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