# WebMD API

> WebMD returns condition guides with symptoms, causes, diagnosis, and treatment, available as a workflow and API.

WebMD’s Get condition method returns a plain-language condition guide with available symptoms, causes, diagnosis, treatment, and doctor-call guidance. Get condition needs a condition or symptom name, such as migraine or acid reflux.

- Page: https://fous.com/tools/webmd
- Handle: `@webmd`
- Category: [Health](https://fous.com/tools/category/health)
- Source website: https://webmd.com
- Last verified: Sep 29, 2026

## Methods

### Get condition

Operation `get_condition`, version 1. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.

Get a plain-language overview and the available symptoms, causes, diagnosis, treatment, and doctor-call guidance from WebMD’s main condition guide. Missing sections and review details are null.

**Input**

| Field | Type | Required | Example | Description |
|---|---|---|---|---|
| `condition` | string | yes | `"migraine"` | Condition or symptom name, such as migraine or acid reflux. |

**Input schema**

```json
{
  "type": "object",
  "required": [
    "condition"
  ],
  "properties": {
    "condition": {
      "type": "string",
      "description": "Condition or symptom name, such as migraine or acid reflux.",
      "examples": [
        "migraine",
        "acid reflux",
        "sore throat"
      ]
    }
  },
  "additionalProperties": false,
  "examples": [
    {
      "condition": "migraine"
    },
    {
      "condition": "acid reflux"
    },
    {
      "condition": "sore throat"
    }
  ]
}
```

**Output**

| Field | Type | Example | Description |
|---|---|---|---|
| `title` | string or null | `"What Is Migraine?"` | Article title. |
| `causes` | string or null |  | Causes described in the guide. |
| `overview` | string or null | `"Everyone knows what a sore throat feels like. It’s one of the most common health complaints, particularly during the co` | Plain-language introduction to the condition. |
| `symptoms` | string or null |  | Symptoms described in the guide. |
| `diagnosis` | string or null |  | Diagnosis described in the guide. |
| `treatment` | string or null |  | Treatment described in the guide. |
| `review_date` | string or null | `"2024-03-14"` | Medical review date in YYYY-MM-DD, when provided. |
| `article_link` | string or null | `"https://www.webmd.com/migraines-headaches/migraines-headaches-migraines"` | Link to the WebMD guide. |
| `medically_reviewed_by` | string or null | `"Poonam Sachdev, MD"` | Named medical reviewer, when provided. |
| `when_to_call_a_doctor` | string or null |  | Guidance on when to contact a doctor. |

**Example input**

```json
{
  "condition": "migraine"
}
```

**Example output**

```json
{
  "title": "What Is Migraine?",
  "causes": "Doctors don’t know exactly what causes migraines, though they seem to be related to your genes, as well as to changes in your brain . Your genes may even influence what triggers your headaches, whethe…",
  "overview": "Migraine is a brain and nervous system disorder whose symptoms almost always include intense headaches. You get these headaches repeatedly, in episodes that can last anywhere from 4 to 72 hours. Along…",
  "symptoms": "For many people, a migraine episode happens in stages. Symptoms you may have during these stages include:\n\nMigraine prodrome\n\nHours or days before a headache, about 60% of people who have migraine not…",
  "diagnosis": "Before making a diagnosis, your doctor will ask about your health history and your symptoms. It may help if you keep track of your symptoms and any triggers you've noticed. Write down or enter into a …",
  "treatment": "There's no cure for migraine, but there are many ways to treat it. Some treatments stop attacks after they start, some prevent them, and some can do both.\n\nMigraine medications\n\nCommon migraine treatm…",
  "review_date": "2024-03-14",
  "article_link": "https://www.webmd.com/migraines-headaches/migraines-headaches-migraines",
  "medically_reviewed_by": "Poonam Sachdev, MD",
  "when_to_call_a_doctor": "See your doctor any time a headache doesn't go away or keeps coming back.\n\nGet medical help right away if you have an intense headache and:\n\nA stiff neck with fever, nausea, and vomiting\n\nNumbness or …"
}
```

## Quick start

Replace `YOUR_API_KEY` with a Fous API key. To create one, open Developers at the bottom of Fous Studio, turn on Developer mode, then go to API keys (https://app.fous.com/keys). Change the values in `input` to run the same tool on new data.

```bash
curl 'https://api.fous.com/v1/query' \
  --fail-with-body --silent --show-error --max-time 180 \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "api": "@webmd",
  "visibility": "public",
  "operation": "get_condition",
  "version": 1,
  "input": {
    "condition": "migraine"
  },
  "response": {
    "format": "json"
  }
}'
```

```python
# Save as fous.py and run with python3 fous.py. No packages needed.
import json
import urllib.error
import urllib.request

api_key = "YOUR_API_KEY"

body = json.loads("{\n  \"api\": \"@webmd\",\n  \"visibility\": \"public\",\n  \"operation\": \"get_condition\",\n  \"version\": 1,\n  \"input\": {\n    \"condition\": \"migraine\"\n  },\n  \"response\": {\n    \"format\": \"json\"\n  }\n}")
request = urllib.request.Request(
    "https://api.fous.com/v1/query",
    data=json.dumps(body).encode("utf-8"),
    headers={
        "Authorization": f"Bearer {api_key}",
        "Content-Type": "application/json",
    },
    method="POST",
)
try:
    with urllib.request.urlopen(request, timeout=180) as response:
        result = json.load(response)
except urllib.error.HTTPError as error:
    raise RuntimeError(f"HTTP {error.code}: {error.read().decode('utf-8', errors='replace')}") from error
if result.get("success") is False:
    raise RuntimeError(result.get("error", {}).get("message", "Request failed"))
print(json.dumps(result["data"]["output"], indent=2))
```

```typescript
// Save as fous.mts and run with npx tsx fous.mts.
const apiKey = "YOUR_API_KEY";

const response = await fetch("https://api.fous.com/v1/query", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${apiKey}`,
    "Content-Type": "application/json",
  },
  signal: AbortSignal.timeout(180_000),
  body: JSON.stringify({
  "api": "@webmd",
  "visibility": "public",
  "operation": "get_condition",
  "version": 1,
  "input": {
    "condition": "migraine"
  },
  "response": {
    "format": "json"
  }
}),
});
type ApiResult = { success: boolean; data?: { output: unknown }; error?: { message: string } };
const result: ApiResult = await response.json();
if (!response.ok || result.success === false) {
  throw new Error(result.error?.message ?? `HTTP ${response.status}`);
}
if (!result.data) throw new Error("Missing API response data");
console.log(result.data.output);
```

## Use from an AI assistant

Connect this tool to Claude Code, Claude Desktop, Cursor, VS Code, Codex and any MCP client as its own MCP server. Each method is a typed tool whose arguments are the method’s input.

- Server URL: `https://api.fous.com/mcp/tools/webmd`
- Authorization: `Authorization: Bearer <Fous API key>`

**Tools**

- `get_condition`: Get condition. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.
- `fous_get_run`: the result of a run that was still going, by its `request_id`. Free.

Claude Code:

```bash
claude mcp add --scope user --transport http fous-webmd https://api.fous.com/mcp/tools/webmd --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"
```

To give the assistant every tool, connect `https://api.fous.com/mcp`: it finds one with `fous_search_tools` and runs it with `fous_run_tool`. Setup for other clients: https://fous.com/llms-full.txt.

## Use cases

- Review symptoms and causes described in a condition guide
- Compare condition diagnosis and treatment information
- Find guidance on when to contact a doctor
- Identify the medical reviewer and review date when provided

## FAQ

### Can I run it with my own inputs?

Yes. Change the inputs in Studio and press Run, or send new inputs from your code, or ask a connected AI assistant.

### Can I call this WebMD tool as an API?

Yes. Send a POST request to /v1/query with your Fous API key and the inputs, and get JSON back.

### How much does it cost?

Each completed run costs 1 credit. Failed runs without a completed receipt are free; completed work can remain charged if delivery is interrupted. With pay as you go, a credit costs 1¢. Monthly plans cost less per credit.

### Do I need a WebMD account?

No. You only need a Fous account.

### How current is the data?

Fous gets the data from webmd.com when you run it. Some results are reused for up to 24 hours, and results that use your account or key are never reused. It was last verified on Sep 29, 2026.

### What symptoms does a condition guide describe?

Get condition returns the symptoms described in WebMD’s guide for the supplied condition or symptom.

### What treatments does WebMD describe for a condition?

Get condition returns treatment information described in the guide for the supplied condition or symptom.

### When should I contact a doctor?

Get condition returns the guide’s available guidance on when to contact a doctor.

## Related

- [Mayo Clinic API](https://fous.com/tools/mayo-clinic.md): Mayo Clinic provides health information from public condition pages, including condition overviews and, where available, diagnosis, treatment, home care, alternative medicine, and appointment preparation.
- [NHS API](https://fous.com/tools/nhs.md): NHS provides condition and medicine guidance, with condition dates reflecting the latest pages used, and nearby England service listings ordered by distance; availability details may be missing.
- [MedlinePlus API](https://fous.com/tools/medlineplus.md): MedlinePlus provides health information from the U.S. National Library of Medicine, including condition and symptom overviews and explanations of tests with matching pages.
- [Drugs.com API](https://fous.com/tools/drugs-com.md): Drugs.com provides public medicine guides, interaction and food or lifestyle warnings for 2–10 medicines, pill matches by imprint, color, or shape, and listed US cash prices by strength, form, and quantity.
- [CDC API](https://fous.com/tools/cdc.md): CDC provides disease facts, age-based vaccine guidance, current travel notices, and destination-specific travel health recommendations; review dates appear only when CDC supplies them.
- [NLM Clinical Tables API](https://fous.com/tools/nlm-clinical-tables.md): NLM Clinical Tables provides public clinical terminology tables, with diagnosis searches that may miss relevant codes and code explanations checked against current NLM and official classification sources.
- [ClinicalTrials.gov API](https://fous.com/tools/clinicaltrials-gov.md): ClinicalTrials.gov helps users find studies and view public trial records, including sponsor-run or funded studies; site distances are approximate, and contacts, eligibility, or exact dates may be missing.
- [PubMed API](https://fous.com/tools/pubmed.md): PubMed searches medical and life-science articles by topic and retrieves one article’s abstract and publication details; abstracts and free full-text links may be unavailable.
- [All Health tools](https://fous.com/tools/category/health)