# Openmd — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Look up medical terms, abbreviations, and word parts to understand healthcare terminology, browse health resources by category, and access research guides on various medical topics. Find dangerous drug abbreviations and prescription shorthand to stay informed about medication safety.

**Category:** Healthcare | **Website:** [openmd.com/](https://openmd.com/) | **Docs:** [parse.bot/marketplace/0280bd3d-25b7-46b9-9366-368f3236f60c/openmd-com-api](https://parse.bot/marketplace/0280bd3d-25b7-46b9-9366-368f3236f60c/openmd-com-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-openmd-com-api-0280bd3d/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### browse_dictionary_by_letter

List medical dictionary terms alphabetically by letter. Returns all terms starting with the specified letter with links to their definition pages.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `letter` | string | No | Single letter A-Z to browse terms. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-openmd-com-api-0280bd3d/browse_dictionary_by_letter \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"letter":"<string>"}'
```

### get_abbreviations_by_letter

Retrieve medical abbreviations starting with a specific letter. Returns abbreviation-meaning pairs.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `letter` | string | No | Single letter A-Z to filter abbreviations. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-openmd-com-api-0280bd3d/get_abbreviations_by_letter \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"letter":"<string>"}'
```

### get_dangerous_abbreviations

Retrieve the specialized guide for dangerous medical abbreviations that are prone to causing prescription errors. Returns structured content with tables identifying risky abbreviations.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-openmd-com-api-0280bd3d/get_dangerous_abbreviations \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_dictionary_term

Retrieve full definitions and metadata for a specific medical term. Returns definitions from multiple medical sources, pronunciation, category, etymology, images, and related videos when available. Coverage is strongest for anatomy terms; some disease terms may return fewer definitions.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `term` | string | Yes | Medical term to look up (e.g. 'heart', 'lung', 'diabetes'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-openmd-com-api-0280bd3d/get_dictionary_term \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"term":"<string>"}'
```

### get_directory_categories

List all categories in the health site directory. Returns category names, URLs, and slugs that can be used with get_directory_category.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-openmd-com-api-0280bd3d/get_directory_categories \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_directory_category

Retrieve sites listed under a specific directory category. Use a slug from get_directory_categories results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category_slug` | string | Yes | Category slug from get_directory_categories (e.g. 'cardiology', 'neurology', 'dermatology'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-openmd-com-api-0280bd3d/get_directory_category \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category_slug":"<string>"}'
```

### get_prescription_abbreviations

Retrieve the specialized guide for common prescription abbreviations. Returns structured content including tables of abbreviation-meaning pairs used in medical prescriptions.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-openmd-com-api-0280bd3d/get_prescription_abbreviations \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_research_guide

Retrieve the structured content of a specific research guide. Use a slug from list_research_guides results. Returns title and content blocks (text, headings, lists, tables).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `guide_slug` | string | Yes | Guide slug from list_research_guides (e.g. 'medical-terminology', 'blood-types', 'levels-of-evidence'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-openmd-com-api-0280bd3d/get_research_guide \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"guide_slug":"<string>"}'
```

### get_word_parts_by_letter

Retrieve medical word parts (roots, prefixes, suffixes) starting with a specific letter. Returns word part and meaning pairs.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `letter` | string | No | Single letter A-Z to filter word parts. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-openmd-com-api-0280bd3d/get_word_parts_by_letter \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"letter":"<string>"}'
```

### list_research_guides

List available health research guides. Returns titles, URLs, and slugs that can be used with get_research_guide.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-openmd-com-api-0280bd3d/list_research_guides \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### search_dictionary

Search for medical terms in the OpenMD dictionary. Returns a direct match with full details if the term exists, or a list of matching term links otherwise.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Medical term or phrase to search for (e.g. 'heart', 'lung'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-openmd-com-api-0280bd3d/search_dictionary \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```