---
title: "Get Related Recommendations"
method: POST
path: "/v2/search/related"
tags: ["Search", "V2"]
---

# Get Related Recommendations

`POST /v2/search/related`

## Query parameters

- `port` integer, nullable

## Request body

- BaseSearchRequestV2
  - `market` string, required
  - `filters` SearchFilter[], nullable — List of filters to apply to the results.
    - `field` string, required
    - `op` 'eq' | 'neq' | 'in' | 'nin' | 'leq' | 'geq' | 'inrange', required
    - `data` union
      - 'true' | 'false'
      - number
      - integer
      - string
      - union[]
        - union
          - 'true' | 'false'
          - number
          - integer
          - string
      - array[]
        - string[]
    - `meta` union
      - RangeFilterMeta
        - `group_title` string, nullable
        - `group_expanded` boolean, nullable
        - `type` 'range'
        - `min` number, required
        - `max` number, required
        - `unit` string, nullable
        - `currency` string, nullable
      - ValuesFilterMeta
        - `group_title` string, nullable
        - `group_expanded` boolean, nullable
        - `type` 'radio' | 'checkbox' | 'checkbox-grid' | 'checkbox-color', required
        - `values` union[], required
          - union
            - 'true' | 'false'
            - number
            - integer
            - string
        - `counts` integer[], required
        - `names` string[], nullable, required
        - `swatches` string[], nullable
      - HierarchicalValuesFilterMeta
        - `group_title` string, nullable
        - `group_expanded` boolean, nullable
        - `type` 'checkbox-hierarchical'
        - `values` array[], required
          - string[]
        - `counts` integer[], required
        - `names` string[], nullable
    - `id` string, nullable
  - `sort` SortModelInput
    - `field` string, required
    - `order` 'asc' | 'desc', required
    - `meta` SortMeta
      - `title` string, required
      - `values` SortingOrder[]
      - `names` string[], nullable
  - `session_id` string, nullable — Session identifier
  - `metadata` object, nullable — Metadata that can be used to modify the behaviour of the search.
  - `tenant` string, required
  - `locale` string, nullable — The locale to use for the search. If not set, the default locale will be used.
  - `user_id` string, nullable — User identifier
  - `dsid` string, nullable — Populated for integrations performed by Depict.ai only. Depict.ai Session Id
  - `query` string, nullable — The search query.

## Response `200`

Successful Response

- RecommendResponse
  - `displays` object[], required
  - `error` string, nullable
  - `variant` integer, nullable
  - `experiment_id` string, nullable

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