# 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/workflows/webmd
- Handle: `@webmd`
- Category: [Health](https://fous.com/workflows/category/health)
- Source website: https://webmd.com
- Last verified: Sep 29, 2026
- Fous is not affiliated with WebMD.

## Methods

### Get condition

Operation `get_condition`, version 1. 1 credit per call.

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 | `"Sore Throat: The Basics"` | 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-09-18"` | Medical review date in YYYY-MM-DD, when provided. |
| `article_link` | string or null | `"https://www.webmd.com/cold-and-flu/understanding-sore-throat-basics"` | 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": "sore throat"
}
```

**Example output**

```json
{
  "title": "Sore Throat: The Basics",
  "causes": "There are many causes of sore throat. The most common are bacterial and viral infections like the cold and flu.\n\nViral infections\n\nThis is the most common cause of a sore throat. It happens when a vir…",
  "overview": "Everyone knows what a sore throat feels like. It’s one of the most common health complaints, particularly during the colder months of the year when respiratory diseases are at their peak.\n\nThe raw, sc…",
  "symptoms": "If you have a sore throat, you might notice:\n\nScratchiness, pain, or irritation in your throat\n\nPain when you speak or swallow\n\nTrouble swallowing\n\nA scratchy, muffled, or hoarse voice\n\nRed, swollen t…",
  "diagnosis": "Your doctor will probably start by looking at your throat with a tiny flashlight. They may also check your nose and ears. Then, they’ll feel the sides of your neck for any lumps, which can be a sign o…",
  "treatment": "The way you treat a sore throat depends on what is causing it. Most sore throats are caused by viral infections, which usually go away on their own in 5–7 days. Antibiotics won’t fix this kind of infe…",
  "review_date": "2024-09-18",
  "article_link": "https://www.webmd.com/cold-and-flu/understanding-sore-throat-basics",
  "medically_reviewed_by": "Poonam Sachdev, MD",
  "when_to_call_a_doctor": "It’s time to go to the doctor if you’re in severe pain, the sore throat doesn’t go away within a week, or it keeps coming back. Other signs to get medical care are:\n\nTrouble breathing\n\nTrouble swallow…"
}
```

## Quick start

Call the API with a Fous API key (`FOUS_API_KEY`). To create one, turn on Developer mode in Fous Studio, then open Keys & connections → API keys (https://app.fous.com/keys).

```bash
# First set your key: export FOUS_API_KEY='YOUR_FOUS_API_KEY'
: "${FOUS_API_KEY:?Set FOUS_API_KEY before running this example}"

curl 'https://api.fous.com/v1/query' \
  --fail-with-body --silent --show-error --max-time 120 \
  -H "Authorization: Bearer $FOUS_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.
# First set your key: export FOUS_API_KEY='YOUR_FOUS_API_KEY'
import json
import os
import urllib.error
import urllib.request

api_key = os.environ.get("FOUS_API_KEY")
if not api_key:
    raise RuntimeError("Set FOUS_API_KEY before running this example")

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=120) 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.
// First set your key: export FOUS_API_KEY='YOUR_FOUS_API_KEY'
const apiKey = process.env.FOUS_API_KEY;
if (!apiKey) throw new Error("Set FOUS_API_KEY before running this example");

const response = await fetch("https://api.fous.com/v1/query", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${apiKey}`,
    "Content-Type": "application/json",
  },
  signal: AbortSignal.timeout(120_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);
```

Or describe the data in plain language: send `{"api":"@webmd","prompt":"Describe the data you need, with every detail"}` to the same URL. Fous fills in the input, runs the method that fits and returns only the fields you asked for; `data.route.calls[].request` is the exact call it made. Routing is free; the run costs the same.

## 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

### Is Fous affiliated with WebMD?

No. Fous is not affiliated with WebMD. This workflow reads the public webmd.com website and returns its data.

### How much does it cost?

Each run costs 1 credit. 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; repeating the same request within a day may return the saved result. Fous checks this workflow automatically; it last passed a check 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/workflows/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/workflows/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/workflows/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/workflows/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/workflows/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/workflows/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/workflows/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/workflows/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 workflows](https://fous.com/workflows/category/health)