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

>ℹ️ Migrate to [Intelligent Search API v1](https://developers.vtex.com/docs/api-reference/intelligent-search-api-v1) for HTTP caching, lower latency, and a simpler URL structure. The new endpoint is: `GET` [Get list of banners registered for query](https://developers.vtex.com/docs/api-reference/intelligent-search-api-v1#get-/banners/-facets-). See the [migration guide](https://developers.vtex.com/docs/guides/migrating-to-intelligent-search-api-v1).

## Permissions

This endpoint does not require [authentication](https://developers.vtex.com/docs/guides/authentication) or [permissions](https://help.vtex.com/en/tutorial/license-manager-resources--3q6ztrC8YynQf6rdc6euk3).

## Path parameters

- `facets` string, nullable, required

## Query parameters

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

## Response `200`

OK

- Banners — Response body object.
  - `banners` object[] — List of banners.
    - `id` string — Banner ID.
    - `name` string — Banner name.
    - `area` string — Banner area, which can be a number between 1 and 4, to be used in the store's [Banner](https://developers.vtex.com/docs/guides/vtex-search-banner) block.
    - `html` string — Banner HTML, which can be an image or text.

## Changes

- **2026-02-12** `961dac7d3929` — 2 info
  - api tag `Product list page` added
  - api tag `Product List Page` removed

[Change history](https://skmtc.dev/vtex/apis/intelligent-search-api-legacy/changes/banners/:facets/get.md)

---

[API](https://skmtc.dev/vtex/apis/intelligent-search-api-legacy.md) · [All operations](https://skmtc.dev/vtex/apis/intelligent-search-api-legacy/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/vtex/intelligent-search-api-legacy/revisions/62d8bce60c7e/schema)