---
title: "Get list of banners registered for query"
method: GET
path: "/banners/{facets}"
tags: ["Product List Page"]
---

# Get list of banners registered for query

`GET /banners/{facets}`

Lists the banners registered for a given query. Check the [configuring banners documentation](https://help.vtex.com/en/tracks/vtex-intelligent-search--19wrbB7nEQcmwzDPl1l4Cb/4ViKEivLJtJsvpaW0aqIQ5) for a full explanation of the banner feature.

## Path parameters

- `facets` string, nullable, required

## Query parameters

- `query` string
- `locale` string, nullable

## Response `200`

OK

- Banners
  - `banners` object[]
    - `area` string — Banner area.
    - `html` string — Banner HTML.
    - `id` string — Banner id.
    - `name` string — Banner name.

---

[API](https://skmtc.net/vtex/apis/intelligent-search-api.md) · [All operations](https://skmtc.net/vtex/apis/intelligent-search-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/vtex/intelligent-search-api/versions/a61de494fbe4/schema)