# Healthgrades Doctor Search by Specialty and City

> Healthgrades Doctor Search by Specialty and City is a paid API for AI agents from api.jobsproperty-api.workers.dev, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-28).

Returns up to 20 doctors near a US city from Healthgrades' specialty directory, with name, NPI, rating, practice address, availability, and insurance info.

## Facts

- Endpoint: GET https://api.jobsproperty-api.workers.dev/api/realestate/healthgrades?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-28
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/healthgrades-doctor-search-by-specialty-and-city-f4283d8f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_x6TPOU6FMmjZ2-YbuIJvo

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 healthgrades-doctor-search-by-specialty-and-city-f4283d8f
```

Example prompt: Can you find me a list of dermatologists near Austin, TX from Healthgrades — show me up to 10 providers with their ratings, whether they accept new patients, and if they offer telehealth?

## When to prefer this

Use this endpoint when you need structured doctor/provider data from Healthgrades for a specific US city and medical specialty — especially when you need NPI numbers, new-patient status, telehealth flags, insurance acceptance counts, and appointment availability in a single call. Prefer this over general web search when you need structured, comparable provider records rather than narrative results.

## Known failure modes

- Missing required parameters (specialty, state, or city) returns a validation error
- Invalid or unrecognized specialty slug may return zero results or an error
- City not found in Healthgrades directory returns empty provider list
- Limit value outside 1–20 range may be clamped or rejected
- Healthgrades website structure changes may break scraping and return parsing errors
- Rate limiting or upstream Healthgrades blocks may cause timeouts

## How this service works

Doctors near a US city from Healthgrades' specialty directory (family practice, dermatology, cardiology...): up to 20 providers with name, NPI, Healthgrades ID, specialty, rating and review counts, practice address, distance, gender, age, new-patient and telehealth flags, appointment availability, number of accepted insurance plans and profile link.

## Output

A list of up to 20 doctor profiles from Healthgrades including: full name, NPI number, Healthgrades provider ID, specialty, star rating, review count, practice address, distance from city center, gender, approximate age, whether they accept new patients, telehealth availability, appointment availability, number of accepted insurance plans, and a direct link to their Healthgrades profile page.

## 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"
      },
      "limit": {
       "type": "string",
       "description": "Providers, 1 to 20 (default 20)"
      },
      "state": {
       "type": "string",
       "description": "Two-letter US state code, e.g. TX"
      },
      "specialty": {
       "type": "string",
       "description": "Healthgrades directory slug, e.g. family-practice, dermatology, cardiology, pediatrics, orthopedic-surgery, psychiatry, obstetrics-gynecology"
      }
     }
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/healthgrades-doctor-search-by-specialty-and-city-f4283d8f/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.jobsproperty-api.workers.dev](https://www.zero.xyz/host/api.jobsproperty-api.workers.dev/llms.txt)