Documentation

Meducate API provides structured, consistent, and up-to-date educational medical information through a simple, developer-friendly API.


What the Medical Data API Provides

Meducate aggregates medical reference data from external providers and processes it using large language models (LLMs). This data is normalised and structured into predictable formats with ICD-10 standardized categorization that can be reliably consumed by applications.

All health topics are classified by type (Disease, Drug, Procedure, etc.) and assigned to standardized medical categories based on ICD-10 chapters—such as Respiratory System, Circulatory System, Mental & Behavioral, and more—ensuring consistent, industry-standard medical classification across all data.

To ensure information remains current, all source data is reprocessed and summarised daily using automated background jobs.


Authentication

All API requests must include your organisation's API key using the X-Api-Key request header.

X-Api-Key: YOUR_API_KEY

Keep your API key secure. Do not expose it in client-side or public applications.


Quick Start: Query ICD-10 Health Topics

Search for health topics using your API key. Replace YOUR_API_KEY with your key or use the demo key below.

curl -H "X-Api-Key: YOUR_API_KEY" \
  "https://api.meducateapi.com/api/topics/search?query=diabetes"

API Rate Limits & Daily Usage

  • 1,000 requests per day per API key
  • Usage resets every 24 hours (midnight UTC)
  • Requests exceeding the limit will receive a 429 response
  • You can create up to 5 API keys per organisation

Health check

A public health endpoint is available for monitoring at GET /health. No authentication required.

curl https://api.meducateapi.com/health

Try it out

Use the interactive explorer below to browse endpoints and test requests. Enter your X-Api-Key via the Authorize button to authenticate.

Public demo key

Shared demo key — 50 requests/day. Create a free account for 1,000/day.
An unhandled error has occurred. Reload 🗙

Rejoining the server...

Rejoin failed... trying again in seconds.

Failed to rejoin.
Please retry or reload the page.

The session has been paused by the server.

Failed to resume the session.
Please reload the page.