---
title: "Search pharmaceutical compounds"
method: POST
path: "/api/v1/pharma/search"
tags: ["Pharma"]
---

# Search pharmaceutical compounds

`POST /api/v1/pharma/search`

Find pharmaceutical compounds either by target characteristics (the −4…+4 scale) or by example drugs you already know. Provide exactly one of `examples` or `preferences`. Results are ranked by similarity to the request.

## Request body

- CompoundSearchRequest — Provide exactly one of `examples` or `preferences`.
  - `examples` string[] — Known drug names to find similar compounds for (fuzzy-matched). 1–50 entries.
  - `preferences` object — Map of characteristic name to desired value on the −4…+4 scale. Omit a characteristic to ignore it. Use GET /api/v1/pharma/characteristics for the available names.
  - `limit` integer — Max results (1–100, default 20).
  - `include_characteristics` boolean — Include each result's characteristic scores in the response.

## Response `200`

Ranked compound recommendations (pass-through from Moore Metrics).

- object
  - `data` object

## Other responses

- `401` — Missing, invalid, or revoked API key.
- `422` — Missing or invalid request body fields.
- `429` — Rate limit exceeded (100 requests/hour per key). Includes a Retry-After header.

---

[API](https://skmtc.net/curecancerwithai/apis/cure-cancer-with-ai-public-api.md) · [All operations](https://skmtc.net/curecancerwithai/apis/cure-cancer-with-ai-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/curecancerwithai/cure-cancer-with-ai-public-api/revisions/fd99aa2f2fd5/schema)