Healthgrades Scraper 🩺 — Doctors, Ratings & Reviews by Specialty + Location

Extract US healthcare provider data from Healthgrades as clean, structured JSON — search doctors by specialty and location and get name, NPI, specialty, patient star rating & review count, practice addresses, hospital affiliations, accepting-new-patients status, telehealth and more.

Fast and reliable: API-first (the data is read straight from Healthgrades' own structured feed, no fragile HTML scraping), with automatic pagination and US residential proxy handling.

💡 Why this actor? It returns the ratings, reviews and rich practice data that the free NPI/NPPES registry simply doesn't have — patient star ratings, review counts, Healthgrades Choice badges, hospital affiliations and specialty detail — perfect for healthcare lead-gen, referral networks and market research.

---

📋 Table of contents

• What does it do?
• Use cases
• How to use it
• Input parameters
• Input examples
• Output — data fields
• Sample output record
• How it compares to the NPI registry
• Tips & best practices
• Frequently asked questions
• Changelog

---

What does it do?

Give it a specialty (or condition / doctor name) and one or more locations, and it returns every matching provider with:

• 👩‍⚕️ Identity: name, NPI, specialty, gender, years since graduation, photo, profile URL.
• ⭐ Reputation: patient star rating, review count, Healthgrades Choice / patient-favorite / recommended flags, patient-highlighted strengths.
• 📍 Practice: every office location with street, city, state, ZIP and coordinates.
• 🏥 Affiliations & access: affiliated hospitals, accepts-new-patients, telehealth availability.

Export to JSON, CSV, Excel, XML or HTML, or pull from the Apify API.

---

Use cases

📇 Healthcare lead generation & marketing

• Build targeted provider lists by specialty + city with ratings and practice addresses.
• Power referral networks, medical staffing and outreach.

📊 Market & competitive research

• Map provider density, ratings and hospital affiliations across markets.
• Benchmark reputation by specialty and location.

🏥 Health systems & recruiters

• Find and qualify providers; track accepting-new-patients and telehealth.

🤖 Data & AI teams

• Build provider datasets enriched with patient-reputation signals.

---

How to use it (step by step)

No coding required.

1. Click Try for free / Start.
2. Enter a Specialty (e.g. Cardiologist, Dermatologist, Family Medicine).
3. Add one or more Locations (e.g. Miami, FL, New York, NY).
4. Set Max providers.
5. Keep the proxy on its default — US Residential (required).
6. Click Save & Start, then export the results.

---

Input parameters

Field	Type	Description
specialty	string	Specialty / condition / name to search, e.g. Cardiologist.
locations	array	Locations as City, ST (e.g. Miami, FL). The specialty is searched in each.
startUrls	array	Advanced: paste Healthgrades search URLs directly. Overrides the builder.
maxItems	integer	Max providers. 0 = no limit. Default 200.
maxPagesPerSearch	integer	Pagination cap per specialty+location (~20 providers/page). Default 20.
proxyConfiguration	object	US Residential is required (Healthgrades is US-only and blocks datacenter IPs). Default.
maxConcurrency	integer	Max parallel requests. Default 3.

---

Input examples

1) Cardiologists in Miami

{
  "specialty": "Cardiologist",
  "locations": ["Miami, FL"],
  "maxItems": 200
}

2) Dermatologists across several cities

{
  "specialty": "Dermatologist",
  "locations": ["New York, NY", "Los Angeles, CA", "Chicago, IL"],
  "maxItems": 1000
}

3) Advanced — paste a search URL

{
  "startUrls": [
    { "url": "https://www.healthgrades.com/usearch?what=Pediatrician&where=Austin,+TX" }
  ]
}

---

Output — data fields

One record per provider:

Field	Description
name	Provider name (with credentials)
npi	National Provider Identifier
profileUrl	Healthgrades profile URL
specialty	Primary specialty
specialtyDescription	Specialty description
gender	Gender
yearsSinceGraduation	Years since graduation
rating	Patient star rating (0–5)
reviewCount	Number of patient surveys/reviews
ratingPercent	Overall rating percentage
acceptsNewPatients	Accepting new patients
telehealthAvailable / isTelehealthOnly	Telehealth flags
isHealthgradesChoice / isPatientFavorite / isRecommendedProvider	Badges
primaryOfficeName	Main practice name
phone / phones	Primary office phone number(s)
photoUrl	Provider photo
city / state / zip / address / latitude / longitude	Primary location (flattened)
addresses	All practice locations (address1, address2, city, state, zip, cityState, officeCode, latitude, longitude)
affiliatedHospitalIds	Affiliated hospital IDs
hasTopHospital	Affiliated with a top hospital
payorCount / payors	Accepted insurance (when available)
strengths	Patient-highlighted strengths
aboutMe / carePhilosophy	Bio / care philosophy
providerId	Internal provider ID
searchSpecialty / searchLocation	The search that produced this record
scrapedAt	ISO timestamp

---

Sample output record

{
  "name": "Dr. Juan Cueto, MD",
  "npi": "1588614572",
  "profileUrl": "https://www.healthgrades.com/physician/dr-juan-cueto-x3bjy",
  "specialty": "Cardiology",
  "gender": "M",
  "rating": 4.8,
  "reviewCount": 15,
  "acceptsNewPatients": true,
  "telehealthAvailable": true,
  "isHealthgradesChoice": false,
  "city": "Miami",
  "state": "FL",
  "zip": "33133",
  "address": "3663 S Miami Ave",
  "addresses": [
    { "address1": "3663 S Miami Ave", "city": "Miami", "state": "FL", "zip": "33133", "officeCode": "XR66RS" }
  ],
  "affiliatedHospitalIds": ["HGST5D138D46100167"],
  "photoUrl": "https://photos.healthgrades.com/img/prov/x/3/b/x3bjy_...jpg",
  "searchSpecialty": "Cardiologist",
  "searchLocation": "Miami, FL",
  "scrapedAt": "2026-06-05T12:00:00.000Z"
}

---

How it compares to the NPI registry

The free NPI / NPPES registry gives you the complete universe of providers with NPI, taxonomy and licensing — but it has no patient ratings, no reviews, no star scores, no Healthgrades Choice badges, no hospital affiliations, no photos/bios and no specialty reputation data. This actor adds exactly that consumer-facing reputation and rich practice layer. Use the NPI registry for the full universe and verification, and this Healthgrades actor for ratings, reviews and enrichment — together they make a complete healthcare lead-gen dataset.

---

Tips & best practices

• 🌍 Use the default US Residential proxy — Healthgrades is US-only and blocks datacenter IPs; non-residential will return 0 results.
• 🧪 Start with one specialty + one city and a small maxItems to confirm the output.
• 🧱 Add multiple locations to cover a region or the whole country.
• 🔁 Schedule runs to track ratings, new providers and accepting-new-patients changes over time.
• 💾 Use the Apify API / integrations to push results into Google Sheets, a CRM, or a webhook.

---

Frequently asked questions

Do I need a US proxy? Yes — Healthgrades only serves US traffic and blocks datacenter IPs. The actor defaults to US Residential; keep it.

Does it include patient ratings and review counts? Yes — star rating, review count and rating percentage are core fields.

Does it return NPI? Yes, when available on the listing.

Can I search a whole region? Add multiple City, ST locations and the actor searches each.

What export formats are supported? JSON, CSV, Excel, XML, HTML table, RSS — plus the Apify API and integrations.

---

Changelog

0.1.0

• Initial release: search providers by specialty + location with automatic pagination.
• Rich provider records: NPI, specialty, patient rating & review count, all practice locations with coordinates, hospital affiliations, badges, telehealth and accepting-new-patients.
• US residential proxy handling; API-first structured parsing.