---
title: "Search"
method: GET
path: "/v3/api/semsim/search/{termset}/{group}"
tags: ["semsim"]
---

# Search

`GET /v3/api/semsim/search/{termset}/{group}`

## Request

- Base URL: `https://monarchinitiative.org` (the document declares no server; this is the origin it was published from)
- URL: `https://monarchinitiative.org/v3/api/semsim/search/{termset}/{group}`
- Auth: none declared

Search for terms in a termset

<b>Args:</b> <br>
    termset (str): Comma separated list of term IDs to find matches for. <br>
    group (str): Group of entities to search within (e.g. Human Genes) <br>
    metric: (str, optional): Similarity metric to use. Defaults to "ancestor_information_content". <br>
    limit (int, optional): Limit the number of results. Defaults to 10.

<b>Returns:</b> <br>
    List[str]: List of matching terms

## Path parameters

- `termset` string, required
- `group` 'Human Genes' | 'Mouse Genes' | 'Rat Genes' | 'Zebrafish Genes' | 'C. Elegans Genes' | 'Human Diseases', required

## Query parameters

- `metric` 'ancestor_information_content' | 'jaccard_similarity' | 'phenodigm_score'
- `directionality` 'bidirectional' | 'subject_to_object' | 'object_to_subject'
- `limit` integer

## Response `200`

Successful Response

- unknown

## Other responses

- `404`: Not Found
- `422`: Validation Error

---

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