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

# Post Search

`POST /v3/api/semsim/search`

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

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

---

[API](https://skmtc.dev/monarchinitiative/apis/fastapi.md) · [All operations](https://skmtc.dev/monarchinitiative/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/monarchinitiative/fastapi/revisions/2ceb106a8c03/schema)