Infermedica API

Health / API Key Intermediate HTTPS CORS
Varies by plan (check documentation)

Overview

Infermedica is an AI-powered health API that analyzes symptom descriptions in plain text and suggests possible conditions or next steps. It uses NLP to understand patient-reported symptoms and helps developers build symptom checkers, triage tools, and health chatbots. You need an API key from the Infermedica developer portal to get started.

💡

Beginner Tip

Start with the /parse endpoint to extract symptoms from free text before passing them to /diagnosis — this two-step approach gives the most accurate results.

Available Data

case counts and statistics
vaccination data
geographic breakdown
historical trend data

Example Response

JSON Response
{
  "input": "[email protected]",
  "is_valid": true,
  "format_valid": true,
  "details": "Input passes all validation checks"
}

Field Reference

mentions List of clinical concepts (symptoms, risk factors) extracted from the input text.
id Infermedica internal identifier for the recognized symptom or condition.
name Human-readable name of the extracted clinical concept.
common_name Everyday language name for the clinical concept.
choice_id Indicates whether the symptom is present, absent, or unknown (present/absent/unknown).
type Type of the concept, such as symptom or risk_factor.

Implementation Example

// ⚠️ Note: This URL may be a documentation page. Check official docs for actual API endpoint.
const url = "https://developer.infermedica.com/docs/";
// Replace headers or query params with the values required by this API.
const response = await fetch(url, {
  headers: {
  "X-API-Key": "YOUR_API_KEY"
  }
});
if (!response.ok) throw new Error(`Request failed: ${response.status}`);
const data = await response.json();
console.log(data);

What Can You Build?

Note: These code examples are AI-generated and unverified. Always refer to the official API documentation for accurate usage.

Common Errors & Troubleshooting

401 Unauthorized Missing or incorrect App-Id / App-Key headers
Include both App-Id and App-Key headers obtained from your Infermedica developer account.
400 Bad Request Malformed JSON body or missing required fields like age
Ensure the request body includes the age object (e.g. {"age":{"value":30}}) and valid JSON syntax.
422 Unprocessable Entity Text is too short or does not contain recognizable symptom mentions
Provide a more descriptive symptom phrase of at least a few words describing the health issue.

Matrix Score Breakdown

🌐 Reachability 30/30
⚡ Speed 15/20
🔒 Security 15/15
🛠 Developer XP 17/20
✓ Reliability 10/15

Partially tested on Apr 5, 2026

Technical Specifications

Auth API Key
HTTPS REQUIRED
CORS YES
Category Health
Difficulty Intermediate
Verified: 2026-04-07

Similar APIs

View All →