---
title: "List Related Terms"
method: GET
path: "/v1/pinterest/terms/related"
tags: ["Pinterest"]
---

# List Related Terms

`GET /v1/pinterest/terms/related`

## Request

- Base URL: `https://api.pinbridge.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.pinbridge.io/v1/pinterest/terms/related`
- Auth: one of:
  - API key in header `X-API-Key`
  - HTTP bearer

List Pinterest related terms for a connected account.

## Query parameters

- `account_id` string, uuid, required: Pinterest account ID
- `terms` string[], required: Requested term(s). Supports repeated query params or a comma-separated value.
- `exact_match` boolean: When true, keep only related-term groups whose `term` exactly matches one of the requested `terms` values after trim/casefold normalization.

## Headers

- `x-api-key` string, nullable
- `authorization` string, nullable

## Response `200`

Successful Response

- RelatedTermsResponse: Normalized response for Pinterest related-term lookups.
  - `id` string, required: First requested term
  - `related_term_count` integer, required: Total number of related terms after PinBridge normalization/filtering
  - `related_terms_list` RelatedTermsItemResponse[]: Related-term groups keyed by the matched term
    - `term` string, required: Input term represented by this related-term group
    - `related_terms` string[]: Terms Pinterest considers logically related to `term`
  - `exact_match` boolean: Whether PinBridge filtered the response to groups whose `term` exactly matches one of the requested `terms` values after trim/casefold normalization

## Other responses

- `422`: Validation Error

---

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