---
title: "Faceted hybrid + semantic search over the knowledge base (diseases, breeds, discoveries)"
method: GET
path: "/v1/semantic"
tags: ["discovery"]
---

# Faceted hybrid + semantic search over the knowledge base (diseases, breeds, discoveries)

`GET /v1/semantic`

## Request

- Base URL: `https://api.sniff.world`
- URL: `https://api.sniff.world/v1/semantic`
- Auth: none declared

## Query parameters

- `q` string, required: natural-language query, e.g. "drug sensitivity in herding dogs"
- `top_k` integer
- `entity_type` string, nullable
- `filters` string, nullable: OData facet filter, e.g. "breed_group eq 'herding' and cohort_n ge 30". Facets: type, breed, breed_group, gene, evidence_tier, confidence_tier, diversity_tier, cohort_n.

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

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