---
title: "List related terms"
method: GET
path: "/terms/related"
tags: ["terms"]
---

# List related terms

`GET /terms/related`

<strong>This endpoint is currently in beta and not available to all apps. <a href='/docs/features/ads-management/'>Learn more</a>.</strong> <p/>
Get a list of terms logically related to each input term. <p/>
Example: the term 'workout' would list related terms like 'one song workout', 'yoga workout', 'workout motivation', etc.

## Query parameters

- `terms` string[], required

## Response `200`

Success

- RelatedTerms
  - `id` string — First input term. For example, if you pass "?terms=clothes,workout", then id will be "clothes"
  - `related_term_count` integer — Total number of related terms returned
  - `related_terms_list` object[] — The id of the advertiser.
    - `term` string
    - `related_terms` string[]

## Other responses

- `400` — Invalid terms related parameters.
- `default` — Unexpected error

## Changes

- **2022-07-11** (v5) `0d5998752011` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/pinterest/apis/pinterest-rest-api/changes/terms/related/get.md)

---

[API](https://skmtc.dev/pinterest/apis/pinterest-rest-api.md) · [All operations](https://skmtc.dev/pinterest/apis/pinterest-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/pinterest/apis/pinterest-rest-api/revisions/0d5998752011?raw)