# Dermnetnz — 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.

> Search a comprehensive database of dermatological conditions to get detailed information including symptoms, causes, treatments, and extensive photo galleries for diagnosis and reference. Explore hair and scalp conditions or any other skin concern with structured medical descriptions and visual examples.

**Category:** Healthcare | **Website:** [dermnetnz.org/](https://dermnetnz.org/) | **Docs:** [parse.bot/marketplace/e19bc0a4-11ad-4135-bb7f-6ff7ce35f9b7/dermnetnz-org-api](https://parse.bot/marketplace/e19bc0a4-11ad-4135-bb7f-6ff7ce35f9b7/dermnetnz-org-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-dermnetnz-org-api-e19bc0a4/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_condition_details

Retrieve comprehensive dermatological information for a specific condition including descriptions, symptoms, causes, diagnosis, treatment options, prevention, and outcome prognosis. Also fetches all associated images from the condition's image collection. Content is extracted from DermNet NZ topic pages and structured into named detail fields plus a raw section list.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | The URL slug of the condition (e.g. 'alopecia-areata', 'acne-vulgaris'). Obtainable from list_conditions results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-dermnetnz-org-api-e19bc0a4/get_condition_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"slug":"<string>"}'
```

### get_image_library

Search for images across the entire DermNet database by keyword. Matches the query against image titles and captions. Returns up to 100 matching images with metadata including file size and sensitivity classification.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Search keyword for finding images by title or caption. |

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

### list_conditions

Search for dermatological conditions on DermNet NZ. When a query is provided, filters conditions by matching the query against titles and synonyms. When no query is provided, returns a default set of hair and scalp conditions. Results are sorted alphabetically by title.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | No | Optional search keyword to filter conditions by title or synonym. Omitting the query returns a default set of hair and scalp conditions. |

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