---
title: "Finds terms similar to the input"
method: POST
path: "/semantics/similar"
tags: ["semantics-similar"]
---

# Finds terms similar to the input

`POST /semantics/similar`

## Request

- Base URL: `https://api.rosette.com/rest/v1`
- URL: `https://api.rosette.com/rest/v1/semantics/similar`
- Auth: API key in header `X-RosetteAPI-Key`

Provides the terms similar to the input. <br><br> Returns a mapping of each requested language to a list of terms similar to the input

## Request body

- union
  - object
    - `content` string
    - `language` string: 3 letter code of language.
    - `options` object
      - `count` integer: how many to return per language
      - `embeddingsMode` 'DEFAULT' | 'GEN_1' | 'GEN_2': the generation of semantic embeddings to use for all languages; defaults to second generation unless the language only supports first generation embeddings
      - `resultLanguages` LanguageCode[]: languages to return similar terms in
        - `languageCode` string: 3 digit language code
  - object
    - `contentUri` string
    - `language` string: 3 letter code of language.
    - `options` object
      - `count` integer: how many to return per language
      - `embeddingsMode` 'DEFAULT' | 'GEN_1' | 'GEN_2': the generation of semantic embeddings to use for all languages; defaults to second generation unless the language only supports first generation embeddings
      - `resultLanguages` LanguageCode[]: languages to return similar terms in
        - `languageCode` string: 3 digit language code

## Response `200`

OK

- object
  - `relationships` SimilarTermsResponse[]
    - `similarTerms` object: similar terms per language
      - `language` string
      - `similarTerms` object[]
        - `term` string
        - `similarity` number

---

[API](https://skmtc.dev/babelstreet/apis/rosette-text-analytics.md) · [All operations](https://skmtc.dev/babelstreet/apis/rosette-text-analytics/llms.txt) · [OpenAPI document](https://skmtc.dev/babelstreet/apis/rosette-text-analytics/revisions/7c1d1497a5dd?raw)