dermnetnz.org APIdermnetnz.org ↗
Access structured data on dermatological conditions from DermNet NZ. Search conditions, retrieve symptoms/causes/treatments, and fetch image galleries via 3 endpoints.
curl -X GET 'https://api.parse.bot/scraper/c465a1a4-e154-43fb-bf56-9ce7571dd9e7/list_conditions?query=eczema' \ -H 'X-API-Key: $PARSE_API_KEY'
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 conditions from the DermNet database.
| Param | Type | Description |
|---|---|---|
| query | string | Optional search keyword to filter conditions by title or synonym. Omitting the query returns a default set of conditions. |
{
"type": "object",
"fields": {
"conditions": "array of condition objects with title, slug, url, categories, and synonyms",
"is_filtered": "boolean indicating whether default hair/scalp filter was applied (true when no query provided)",
"total_found": "integer total number of matching conditions"
},
"sample": {
"data": {
"conditions": [
{
"url": "https://dermnetnz.org/topics/asteatotic-eczema",
"slug": "asteatotic-eczema",
"title": "Asteatotic eczema",
"synonyms": [
"Xerosis",
"Xerosis cutis",
"Eczema craquele"
],
"categories": [
"Eczemas"
]
}
],
"is_filtered": false,
"total_found": 38
},
"status": "success"
}
}About the dermnetnz.org API
The DermNet NZ API provides structured access to dermatological condition data across 3 endpoints, covering condition search, detailed clinical information, and image library lookups. The get_condition_details endpoint returns up to 7 mapped clinical fields — description, symptoms, causes, diagnosis, treatment, prevention, and outcome — alongside a full image gallery for any condition identified by its slug.
Condition Search and Discovery
The list_conditions endpoint accepts an optional query parameter to filter conditions by title or synonym. When no query is supplied, it returns a default set and sets is_filtered: true. Each result in the conditions array includes a title, slug, url, categories, and synonyms array, making it straightforward to build autocomplete or browse interfaces. The total_found integer tells you how many records matched.
Detailed Clinical Data
get_condition_details takes a slug (obtainable from list_conditions) and returns a details object with structured fields: description, symptoms, causes, diagnosis, treatment, prevention, and outcome. Not every condition will have all seven fields populated — the all_sections array exposes every content section with its raw header and content strings, so you can access data that doesn't map to the standard fields. The images array on the same response gives per-image url, caption, title, source, and id, with image_count as a convenience integer.
Image Library Search
get_image_library accepts a required query string and returns up to 100 matching images searched across the entire DermNet database by title and caption. Each image object includes title, caption, url, detail_url, file_size, and an is_sensitive boolean — useful for filtering content in consumer-facing applications before display.
- Build a symptom-reference tool that pulls structured
symptomsandcausesfields for a queried skin condition. - Populate a dermatology education platform with
treatmentandoutcomedata fromget_condition_details. - Drive an image search feature using
get_image_librarywithis_sensitivefiltering for safe-search compliance. - Create condition autocomplete using
list_conditionswith aqueryparameter matched against titles and synonyms. - Assemble a clinical reference app that displays all raw content sections via the
all_sectionsarray for conditions lacking standard mapped fields. - Aggregate condition metadata (categories, slugs, synonyms) for taxonomy or classification research pipelines.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does DermNet NZ have an official developer API?+
What does `get_condition_details` return beyond the seven standard clinical fields?+
details object (description, symptoms, causes, diagnosis, treatment, prevention, outcome), the response includes all_sections — an array of every content section with its header and content strings. This captures any condition-specific sections that don't map to the seven standard fields. The images array on the same response contains full image metadata including caption, source, and is_sensitive.Does `list_conditions` return all conditions when called without a query?+
query, the endpoint returns a default set of conditions (not the full database) and sets is_filtered: true in the response. To retrieve conditions outside that default set, pass a query string to filter by title or synonym.Does the API expose patient case discussions, forum threads, or community content from DermNet?+
Is there pagination support for `list_conditions` or `get_image_library` results?+
get_image_library returns up to 100 images per call with no pagination parameters. list_conditions returns matches without offset or page controls. Neither endpoint currently exposes cursor or page-based pagination. You can fork the API on Parse and revise it to add pagination support if your use case requires iterating through larger result sets.