---
title: "Get Suggestions"
method: GET
path: "/v2/search/suggestions"
tags: ["Search", "V2"]
---

# Get Suggestions

`GET /v2/search/suggestions`

## Query parameters

- `tenant` string, required
- `market` string, required
- `locale` string, nullable
- `query` string, nullable
- `user_id` string, nullable
- `session_id` string, nullable
- `dsid` string, nullable
- `metadata` unknown

## Response `200`

Successful Response

- SearchSuggestionsResponse
  - `suggestions_request_id` string, required
  - `suggestions` union[], required — List of suggestions for search queries that should be shown to the user while they are typing.
    - union
      - QuerySuggestion
        - `type` 'query'
        - `suggestions_result_id` string, required
        - `title` string, required — Title for suggestion.
      - LegacyCategorySuggestion
        - `category_id` string, required — Unique identifier of the category.
        - `title` string, required — The title of the category
        - `page_url` string, nullable — The full URL to the category page
        - `query_id` string, nullable — Optionally a unique query ID for the category
        - `uri` string, nullable — Optionally a unique URI for the category, for example men/shoes
        - `category_type` 'TAG' | 'CATEGORY' | 'TENANT_CATEGORY' | 'TENANT_SECONDARY_CATEGORY' | 'CAMPAIGN' | 'BRAND'
        - `type` 'category' — type
        - `suggestions_result_id` string, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/depict/apis/depict-api.md) · [All operations](https://skmtc.net/depict/apis/depict-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/depict/depict-api/revisions/aad86b1030c7/schema)