Healthgrades Doctor & Physician Directory Scraper

Scrape healthcare provider profiles from Healthgrades.com to build a doctor directory or physician database. Find doctors by specialty and by state, and extract doctor names, specialties, contact details, patient ratings, board certifications, hospital affiliations, and education history across all 50 U.S. states and 40 medical specialties.

Healthgrades Scraper Features

• Searches Healthgrades by state, specialty, city, or ZIP code — any combination
• Supplies direct profile URLs when you already know which providers you want, bypassing search entirely
• Returns every field a provider's Healthgrades profile publishes, so records are as complete as the profile itself
• Deduplicates providers across paginated search results — the same doctor will not appear twice
• Pages through up to 90 result pages per search combination (about 1,800 providers), then stops
• Formats phone numbers consistently as (XXX) XXX-XXXX across all records
• Gets through Healthgrades' blocking, where most tools return nothing
• Pay-per-event pricing at roughly $0.002 per provider record

Who Uses This Healthcare Provider Database?

• Healthcare marketers — build targeted outreach lists by specialty and geography for medical device, pharma, and software sales
• Referral network builders — identify specialists by location and affiliation for patient referral programs
• Healthcare analytics teams — aggregate provider counts, rating distributions, and experience data by market
• Medical staffing firms — source candidate pools filtered by specialty, city, or hospital affiliation
• Competitive intelligence analysts — map provider density and ratings by region to identify underserved markets

How Healthgrades Scraper Works

1. You provide states, specialty, city, or ZIP — or a list of direct profile URLs. If you provide direct URLs, search is skipped entirely.
2. The scraper collects the providers listed on each search results page, then pages through the rest of the results.
3. Each profile is visited individually, and its details, NPI, biography, practice name and availability are read from the profile page.
4. Records are deduplicated by provider ID and saved to the dataset. The run stops when maxItems is reached.

Input

Search by state and specialty

{
  "states": ["CA", "TX"],
  "specialty": "cardiologist",
  "maxItems": 500,
  "sp_intended_usage": "Lead generation for cardiac device sales",
  "sp_improvement_suggestions": "n/a"
}

Narrow by city

{
  "states": ["NY"],
  "specialty": "dermatologist",
  "city": "Brooklyn",
  "maxItems": 100,
  "sp_intended_usage": "Market sizing",
  "sp_improvement_suggestions": "n/a"
}

Scrape specific provider profiles directly

{
  "providerUrls": [
    { "url": "https://www.healthgrades.com/physician/dr-jane-smith-abc123" },
    { "url": "https://www.healthgrades.com/dentist/dr-john-doe-xyz789" }
  ],
  "maxItems": 10,
  "sp_intended_usage": "Profile verification",
  "sp_improvement_suggestions": "n/a"
}

Input Parameters

Field	Type	Default	Description
states	string[]	—	One or more U.S. state codes (e.g. CA, TX). Defaults to all states if empty.
specialty	string	All Specialties	Filter by medical specialty. See the full list below. Leave empty for all specialties.
city	string	—	Filter by city name. Works best when combined with a state filter.
zip	string	—	Filter by ZIP code. Healthgrades searches within a radius of the provided ZIP.
providerUrls	array	—	Direct Healthgrades profile URLs. When provided, bypasses search entirely.
maxItems	integer	100	Maximum provider records to return. Set to 0 for unlimited.
sp_intended_usage	string	—	Required. Describe how you plan to use the data.
sp_improvement_suggestions	string	—	Required. Feedback on what could be improved.

Supported specialties: Allergist, Anesthesiologist, Cardiologist, Chiropractor, Dentist, Dermatologist, Endocrinologist, Family Practice, Gastroenterologist, Geriatrician, Hematologist, Immunologist, Infectious Disease, Internist, Nephrologist, Neurologist, Neurosurgeon, OB/GYN, Oncologist, Ophthalmologist, Optometrist, Oral Surgeon, Orthopedic Surgeon, ENT, Pain Management, Pathologist, Pediatrician, Physiatrist, Plastic Surgeon, Podiatrist, Psychiatrist, Psychologist, Pulmonologist, Radiologist, Rheumatologist, Sports Medicine, Surgeon, Urologist, Vascular Surgeon.

Healthgrades Scraper Output Fields

{
  "provider_name": "Dr. Jane Smith, MD",
  "first_name": "Jane",
  "last_name": "Smith",
  "title": "MD",
  "specialty": "Cardiologist",
  "address": "1234 Medical Center Blvd",
  "city": "Los Angeles",
  "state": "CA",
  "zip": "90024",
  "phone": "(310) 555-0182",
  "patient_rating": 4.7,
  "review_count": 143,
  "years_of_experience": 22,
  "education": [
    "Johns Hopkins University School of Medicine",
    "UCLA Medical Center - Residency"
  ],
  "hospital_affiliations": [
    "Cedars-Sinai Medical Center",
    "Ronald Reagan UCLA Medical Center"
  ],
  "languages": ["English", "Spanish"],
  "profile_url": "https://www.healthgrades.com/physician/dr-jane-smith-abc123",
  "npi": "1477534816",
  "practice_name": "Westside Cardiology Associates",
  "bio": "Dr. Jane Smith, MD is a board-certified cardiologist in Los Angeles, CA. She is accepting new patients and telehealth appointments.",
  "accepting_new_patients": true,
  "telehealth_available": true
}

Field	Type	Description
provider_name	string	Full name with professional title (e.g. Dr. Jane Smith, MD)
first_name	string	Provider first name
last_name	string	Provider last name
title	string	Professional credential (MD, DO, DDS, DMD, DPM, etc.)
specialty	string	Primary medical specialty
address	string	Practice street address
city	string	Practice city
state	string	Practice state abbreviation
zip	string	Practice ZIP code
phone	string	Practice phone number formatted as (XXX) XXX-XXXX
patient_rating	number	Patient satisfaction rating on a 0–5 scale
review_count	number	Number of patient reviews
years_of_experience	number	Years in medical practice
education	string[]	Medical school and residency history
hospital_affiliations	string[]	Affiliated hospitals
languages	string[]	Languages spoken by the provider
profile_url	string	Full Healthgrades profile URL
npi	string	10-digit National Provider Identifier as printed on the profile, null when absent. Joins to NPPES (see the nppes-npi-crawler actor); never inferred from the name
practice_name	string	Name of the provider's primary practice or organization, null when Healthgrades lists none
bio	string	The profile's short "About" biography, null when absent
accepting_new_patients	boolean	true when the biography states the provider is accepting new patients, false when it states they are not, otherwise null (never guessed)
telehealth_available	boolean	true when the profile shows telehealth / virtual visits, otherwise null (a missing badge is not a "no")

FAQ

How many providers does the Healthgrades Scraper cover? Healthgrades indexes over 1.5 million healthcare providers across the U.S. The scraper can reach all of them given sufficient maxItems and state/specialty coverage. A national crawl across all specialties is a large job — plan accordingly.

How long does a typical run take? A run of 500 records across a single state and specialty takes roughly 10 minutes. Larger national crawls with multiple specialties can run for several hours. Set timeoutSecs to at least 14400 (4 hours) for large jobs.

How do I find doctors by specialty and state? Set the specialty field to one of the 40 supported specialties and add one or more state codes to the states field. The scraper searches Healthgrades for matching providers and returns a doctor directory filtered to that specialty and geography. Add city or zip to narrow further.

Can I scrape a specific list of doctors? Yes. Provide their Healthgrades profile URLs directly in providerUrls. The scraper will visit each URL directly and skip search entirely — faster and more precise for known targets.

What data is available on every profile vs. only some? provider_name, specialty, city, state, phone, profile_url, npi, and bio are available on nearly all profiles. accepting_new_patients, telehealth_available, and practice_name are filled when the profile shows them and null otherwise. Healthgrades publishes no practice website and no per-provider list of accepted insurance on a profile, so the scraper does not return those. Fields like hospital_affiliations, years_of_experience, and languages depend on what each provider has filled out on Healthgrades — not every profile has all fields populated.

Is it legal to scrape Healthgrades? The scraper collects publicly available information from Healthgrades. You are responsible for ensuring your use of the data complies with applicable laws and regulations, including HIPAA if you are processing data in a healthcare context. This scraper does not access patient records or any protected health information.

How much does it cost to run? Pricing is pay-per-event at approximately $0.002 per provider record. A run of 1,000 providers costs roughly $2. Actual costs depend on run time and memory usage — check your Apify usage dashboard for exact figures.

Need More Features?

Need a custom specialty filter, additional output fields, or a bulk national dataset? Get in touch.

Why Use Healthgrades Scraper?

• Complete profile data — Every field a provider's profile publishes, including NPI, biography, practice name and availability, in one record.
• Direct URL mode — Skip search entirely when you have a known list of providers. Useful for verification, enrichment, and monitoring workflows.
• Priced per record — Pay only for the data you actually collect. No monthly subscription, no minimum commitment.

---

Further reading: NPI Database Download: How to Get Healthcare Provider Data in Bulk