# Healthgrades Provider Search & Profile Scraper

> Healthgrades Provider Search & Profile Scraper is a paid API for AI agents from api.scrapeforagents.tech, paid per call via x402, $0.025/call, status unknown (last checked 2026-10-02).

Scrapes Healthgrades to return structured provider listings including NPI, ratings, specialties, office contacts, insurance plans, and full profile details for a given search query and location.

## Facts

- Endpoint: POST https://api.scrapeforagents.tech/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-profile-scraper-82d7f315
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ld7mGK0mfySdP9tH69P8r

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-profile-scraper-82d7f315 -d '<json body>'
```

Example prompt: Search Healthgrades for cardiologists in Austin, TX and return up to 50 providers including their ratings, specialties, and office contact details like phone numbers, hours, and coordinates.

## When to prefer this

Use this endpoint when you need structured, machine-readable provider data from Healthgrades — including ratings, specialties, insurance plans, and detailed profile information — without building your own scraper. It is ideal for healthcare directory applications, insurance verification workflows, or agent-driven doctor discovery where up-to-date Healthgrades data is required. Prefer it over general-purpose web scrapers when you need Healthgrades-specific schema output (NPI, provider ID, structured reviews) and pay-per-successful-call pricing.

## Known failure modes

- Empty result set if search query or location returns no Healthgrades matches (not charged)
- Invalid or inaccessible startUrl causing failed scrape (not charged)
- Rate limiting or anti-scraping measures on Healthgrades causing partial or failed extraction
- maxItems set too low to capture meaningful results
- Malformed location string not recognized by Healthgrades search

## 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 and an array of provider items, each containing NPI, name, gender, rating, specialty, provider ID, review count, and specialties. When detail flags are enabled, also includes biography, education, certifications, hospitals, conditions treated, procedures, languages, awards, patient reviews, insurance plan names, office addresses, phone/fax numbers, websites, 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-profile-scraper-82d7f315/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.scrapeforagents.tech](https://www.zero.xyz/host/api.scrapeforagents.tech/llms.txt)