# Healthgrades Provider Search Scraper

> Healthgrades Provider Search Scraper is a paid API for AI agents from x402.186-241-26-229.sslip.io, paid per call via x402, $0.025/call, status unknown (last checked 2026-10-02).

Scrapes Healthgrades for structured healthcare provider listings including ratings, specialties, and optional detailed profiles via pay-per-call x402 micropayment.

## Facts

- Endpoint: POST https://x402.186-241-26-229.sslip.io/v1/healthgrades?utm_source=zero.xyz
- Price: $0.025/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/healthgrades-provider-search-scraper-8c90ac47
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap__ssDZi8OdDmpfo_9FCbGl

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-provider-search-scraper-8c90ac47 -d '<json body>'
```

Example prompt: Search Healthgrades for cardiologists in Boston, MA and give me up to 50 results with their ratings, specialties, and office contact information including phone numbers and hours.

## When to prefer this

Use this endpoint when you need structured, machine-readable healthcare provider data from Healthgrades — especially when you need ratings, NPI numbers, specialty filters, and optionally deep profile data like insurance acceptance, office hours, or doctor credentials. Prefer this over general web scraping when targeting Healthgrades specifically, and over manual search when you need bulk provider data programmatically. The pay-only-on-success model makes it low-risk for exploratory queries.

## Known failure modes

- Empty result set if search query or location returns no Healthgrades matches — not charged
- Network or scraping failure if Healthgrades changes page structure — not charged
- Invalid or unreachable startUrl returns error
- maxItems of 0 may result in very large response times for popular specialties
- Location string not recognized by Healthgrades geolocation returns empty results

## How this service works

Pay-per-call structured web data. Failed or empty runs are not charged.

## Output

Returns a JSON object with a count of matched providers and an array of items, each containing NPI, name, gender, star rating, primary specialty, provider ID, review count, and specialties list. With optional flags enabled, also returns biography, education, certifications, hospitals, conditions, procedures, languages, awards, patient reviews, named insurance plans, office addresses, phone/fax numbers, website, hours, and GPS coordinates.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "location": {
   "type": "string",
   "description": "City and state or ZIP code for the search."
  },
  "maxItems": {
   "type": "integer",
   "default": 100,
   "maximum": 1000000,
   "minimum": 0,
   "description": "Maximum number of unique providers to return. Set 0 to collect all available search pages."
  },
  "startUrl": {
   "type": "string",
   "description": "A public Healthgrades /usearch URL. When set, it takes priority over the search query and location."
  },
  "searchQuery": {
   "type": "string",
   "description": "Search term such as cardiologist, dentist, or a doctor name."
  },
  "includeDetails": {
   "type": "boolean",
   "default": false,
   "description": "Visit each provider profile for biography, education, certifications, hospitals, conditions, procedures, languages, awards, and visible patient reviews."
  },
  "includeInsurancePlans": {
   "type": "boolean",
   "default": false,
   "description": "Visit each provider profile for named plans and plan types under each insurer."
  },
  "includeOfficeContacts": {
   "type": "boolean",
   "default": false,
   "description": "Visit each provider profile for all listed offices, phone and fax numbers, website, hours, and coordinates."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 1,
  "items": [
   {
    "npi": null,
    "name": null,
    "gender": null,
    "rating": null,
    "specialty": null,
    "providerId": null,
    "reviewCount": null,
    "specialties": null
   }
  ],
  "product": "healthgrades"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/healthgrades-provider-search-scraper-8c90ac47/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.186-241-26-229.sslip.io](https://www.zero.xyz/host/x402.186-241-26-229.sslip.io/llms.txt)