# WebMD Healthcare Provider Directory Search

> WebMD Healthcare Provider Directory Search is a paid API for AI agents from api.companyrecords-api.workers.dev, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-24).

Returns a paginated list of WebMD-listed doctors for a given medical specialty and US city, including credentials, ratings, office details, and profile links.

## Facts

- Endpoint: GET https://api.companyrecords-api.workers.dev/api/b2b/webmd-healthcare-provider-directory?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-24
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/webmd-healthcare-provider-directory-search-7f3387b8
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_XeVbRFZCoD3YAOu8ZpWtp

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability webmd-healthcare-provider-directory-search-7f3387b8
```

Example prompt: Can you find me cardiologists in Austin, Texas from the WebMD doctor directory — I need their names, credentials, NPI numbers, ratings, and office contact info, page 1?

## When to prefer this

Use this endpoint when you need structured doctor/provider data for a specific US city and medical specialty, sourced from WebMD's public directory. It is ideal for building provider databases, referral tools, or patient-facing doctor-finder applications. Prefer this over general web scraping when you need NPI numbers, ratings, review excerpts, and office contact details in a single structured call.

## Known failure modes

- Missing required parameters (specialty, state, or city) returns an error
- Invalid or unrecognized specialty slug returns empty results
- City/state combination with no WebMD listings returns zero results
- Page number out of range (above 20) may return empty or error
- Residential proxy rate limiting or blocking may cause request failures
- WebMD page structure changes may break parsing and return malformed data

## How this service works

Pay-per-call company registry, government, legal and B2B data tools for AI agents, from official registers and public sources. Payment: x402, USDC on Base, Solana, Arc, Polygon, Arbitrum, Monad, World Chain, Optimism, Avalanche, Celo or Stellar, or RLUSD/XRP on the XRP Ledger. No signup, no API key; a failed call is not charged.

## Output

Returns up to 60 doctor records per page, each containing: full name, credentials (e.g. MD, DO), NPI number, specialty, gender, medical school graduation year, patient star rating, review count, a sample review quote, nearest office address, medical group name, phone number, distance, and a direct WebMD profile URL. Also returns the total count of matching providers.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "specialty",
      "state",
      "city"
     ],
     "properties": {
      "city": {
       "type": "string",
       "description": "City name, e.g. austin"
      },
      "page": {
       "type": "string",
       "description": "Results page 1 to 20 (default 1)"
      },
      "state": {
       "type": "string",
       "description": "Full state name, e.g. texas or 'new york'"
      },
      "specialty": {
       "type": "string",
       "description": "WebMD specialty slug, e.g. family-medicine, dermatology, cardiology, pediatrics, dentistry"
      }
     }
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/webmd-healthcare-provider-directory-search-7f3387b8/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.companyrecords-api.workers.dev](https://www.zero.xyz/host/api.companyrecords-api.workers.dev/llms.txt)