Healthgrades Scraper — Doctor NPI, Ratings & Contact Data

Extract complete doctor profiles from Healthgrades.com, one of the largest doctor directories in the United States. Search by specialty and location and get structured data for every matching provider: name, NPI number, specialty, star ratings and review counts, biography, education, board certifications, and every office location with phone, fax, and GPS coordinates — exported as JSON, CSV, or Excel.

⚡ Fast HTML parsing (no browser) · 🆔 NPI numbers · ⭐ Ratings & reviews · 📞 Phone & fax · 📍 Geo-coordinates · 🩺 Telehealth & new-patient flags

---

Why scrape Healthgrades?

• Healthcare lead generation — build targeted contact lists of providers by specialty and region, keyed by NPI for easy CRM deduplication.
• Data enrichment — the NPI field lets you join results directly against NPPES, CMS, and claims datasets.
• Market intelligence — monitor provider density, ratings, telehealth adoption, and new-patient availability by market.
• Provider directories — keep physician finders and referral networks up to date, including geo-coordinates for map views.

Running on Apify also gets you scheduling, an API for every run, webhooks, and integrations with Google Sheets, Zapier, and Make.

---

What data can you extract?

Field	Description
name, npi, profileUrl	Doctor's full name, 10-digit National Provider Identifier, and Healthgrades profile link
doctorSpecialty	Primary medical specialty
gender, age, yearsOfExperience	Demographics and years since medical school graduation
rating, reviewCount	Average patient star rating (1–5) and number of ratings, as numbers
acceptsNewPatients, telehealthAvailable	Availability flags
healthgradesChoice, patientFavorite	Healthgrades quality designations
biography	Short profile biography
education, boardCertifications, languages	Medical school / residency / fellowship history, certifications with accrediting board, languages spoken
locations	Every office: practice name, street address, city, state, ZIP, phone, fax, latitude, longitude, primary-office flag
attributes	Patient feedback highlights (e.g., "Listened/answered questions")
searchQuery	The specialty, location, and page that produced each result

---

How to scrape Healthgrades

1. Create a free Apify account.
2. Open the Healthgrades Scraper.
3. Enter a specialty (e.g., "Cardiologist", "Dermatologist", "Dentist") and a location (city + state, or ZIP).
4. Set Max Pages (each search page yields ~20 doctors) and click Start.
5. Download your results from the Dataset tab in JSON, CSV, Excel, or XML.

---

Input

Field	Type	Description	Default
specialty	String	Doctor specialty to search for	"Cardiologist"
location	String	City, state, or ZIP to search	"Portland, OR"
maxPages	Integer	Search pages to scrape, ~20 doctors each (0 = all pages, capped at 100)	1
proxyConfiguration	Object	Apify Proxy or custom proxy settings	Apify Proxy

---

Output

One record per doctor. Real example:

{
  "name": "Dr. Juan Cueto, MD",
  "npi": "1588614572",
  "profileUrl": "https://www.healthgrades.com/physician/dr-juan-cueto-x3bjy",
  "doctorSpecialty": "Cardiology",
  "gender": "M",
  "age": 60,
  "yearsOfExperience": null,
  "rating": 4.8,
  "reviewCount": 15,
  "acceptsNewPatients": true,
  "telehealthAvailable": true,
  "healthgradesChoice": true,
  "patientFavorite": false,
  "distanceMiles": 2.2,
  "address": "3663 S Miami Ave, Miami, FL 33133",
  "attributes": [
    "Appt. wasn't rushed",
    "Listened/answered questions"
  ],
  "imageUrl": "https://dims.healthgrades.com/dims3/MMH/format/webp/?url=https:%2F%2Fphotos.healthgrades.com%2Fimg%2Fprov%2Fx%2F3%2Fb%2Fx3bjy_w120h160_va56ebdd2621fcbbea0cba1cd90c1743e9659456f.jpg",
  "searchQuery": {
    "specialty": "Cardiologist",
    "location": "Miami, FL",
    "page": 1
  },
  "biography": "Dr. Juan Cueto, MD is a cardiologist in Miami, FL. Dr. Cueto has extensive experience in Adult Congenital Heart Conditions. He is affiliated with HCA Florida Mercy Hospital. He is accepting new patients and telehealth appointments.",
  "languages": ["Spanish"],
  "boardCertifications": [],
  "education": [
    {
      "type": "Residency Hospital",
      "name": "Jackson Mem Hosp/jackson Health",
      "completionYear": null
    }
  ],
  "locations": [
    {
      "practiceName": "Mercy Hospital Inc",
      "streetAddress": "3663 S Miami Ave",
      "city": "Miami",
      "state": "FL",
      "postalCode": "33133",
      "phone": "(305) 854-4400",
      "fax": "(305) 285-2779",
      "latitude": 25.74616,
      "longitude": -80.21206,
      "isPrimary": true
    }
  ]
}

Fields are null (or empty arrays) when Healthgrades doesn't publish that information for a doctor.

The dataset includes three ready-made views in Apify Console: Overview (ratings and contact at a glance), Credentials (education and certifications), and Locations & Contact (offices with phone/fax).

---

How much will it cost?

Pricing is pay-per-result: you pay a fraction of a cent per doctor scraped — at most $6.50 per 1,000 doctors (less on paid Apify plans; see the Pricing tab for your exact rate) plus a negligible Actor-start fee. Platform compute and proxy costs are already included in the per-result price. For example, scraping 100 cardiologists (5 search pages) costs about $0.65. You can cap spending on any run with the "Maximum cost per run" limit.

---

Tips

• Each search page returns ~20 doctors; set maxPages accordingly (e.g., 5 ≈ 100 doctors).
• maxPages: 0 scrapes every available page, with a built-in safety cap of 100 pages per run.
• Searches accept anything the Healthgrades search box does: specialties ("Cardiologist"), conditions, practice areas, or provider types ("Dentist", "Therapist").
• Use the npi field to deduplicate doctors across overlapping searches and to join with NPPES/CMS data.
• Filter exports on acceptsNewPatients or telehealthAvailable to build actionable outreach lists.

---

Integrations

Connect the dataset to Google Sheets, Zapier, Make, Slack, or any HTTP webhook using Apify integrations, or pull results programmatically via the Apify API and SDK clients for JavaScript and Python. Schedule recurring runs to keep your provider data fresh.

---

FAQ

Can I get doctors' NPI numbers from Healthgrades?

Yes — every result includes the doctor's 10-digit npi when Healthgrades publishes it (100% coverage in our test runs), so you can join results against NPPES, PECOS, and claims data.

Can I filter for doctors who offer telehealth or accept new patients?

Every record carries telehealthAvailable and acceptsNewPatients booleans — filter the exported dataset on either field.

Does it include office phone numbers and fax numbers?

Yes. Each entry in locations includes the office phone and, when published, the fax number, along with latitude/longitude for mapping.

How do I export results to Excel or CSV?

Open the run's Dataset tab and choose Excel, CSV, JSON, or XML — or fetch any format via the API.

Is it legal to scrape Healthgrades?

The scraper only collects publicly available professional information about healthcare providers — the same data any visitor sees. It does not collect patient data or anything behind a login. You are responsible for using the data in compliance with applicable laws (including GDPR/CCPA where relevant) and Healthgrades' terms of service. If in doubt, consult a lawyer.

What if a doctor's profile page fails to load?

The doctor is still saved with all search-page data (name, NPI, rating, specialty, address) — only the profile-page extras (biography, education, detailed locations) are skipped.