---
title: "Post Search"
method: POST
path: "/v3/api/semsim/search"
tags: ["semsim"]
---

# Post Search

`POST /v3/api/semsim/search`

## 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`
- Auth: none declared

Search for terms in a termset <br>
    <br>
    Example: <br>
<pre>
{
  "termset": ["HP:0002104", "HP:0012378", "HP:0012378", "HP:0012378"],
  "group": "Human Diseases",
  "metric": "ancestor_information_content",
  "limit": 5
}
</pre>

## Request body

- SemsimSearchRequest
  - `termset` string[], required
  - `group` 'Human Genes' | 'Mouse Genes' | 'Rat Genes' | 'Zebrafish Genes' | 'C. Elegans Genes' | 'Human Diseases', required
  - `metric` 'ancestor_information_content' | 'jaccard_similarity' | 'phenodigm_score'
  - `directionality` 'bidirectional' | 'subject_to_object' | 'object_to_subject'
  - `limit` integer, nullable

## Response `200`

Successful Response

- unknown

## Other responses

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

## Changes

- **2026-07-26** `1dd6862950fc`: 1 info
  - the `directionality` request property default value `bidirectional` was added

[Operation history](https://skmtc.dev/monarchinitiative/apis/monarchinitiative-api/changes/v3/api/semsim/search/post.md)

---

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