---
title: "Get list of suggested terms and attributes similar to the search term"
method: GET
path: "/autocomplete_suggestions"
tags: ["Autocomplete"]
---

# Get list of suggested terms and attributes similar to the search term

`GET /autocomplete_suggestions`

Lists the suggested terms and attributes similar to the search term.

For more information, check the Intelligent Search [Autocomplete](https://help.vtex.com/en/tracks/vtex-intelligent-search--19wrbB7nEQcmwzDPl1l4Cb/4gXFsEWjF7QF7UtI2GAvhL) guide.

>ℹ️ 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 suggested terms and attributes similar to the search term](https://developers.vtex.com/docs/api-reference/intelligent-search-api-v1#get-/autocomplete-suggestions). 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).

## Query parameters

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

## Response `200`

OK

- AutocompleteSearchSuggestions — Response body object.
  - `searches` object[] — List of suggested facets and terms.
    - `term` string — Search term.
    - `count` number — Number of times the term was searched.
    - `attributes` object[], nullable — List of facets in which the term can be searched.
      - `key` string — Facet key.
      - `value` string — Facet value.
      - `labelKey` string — Human-readable format of the facet key.
      - `labelValue` string — Human-readable format of the facet value.

---

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