Healthgrades Doctor & Provider Scraper - Reviews, Ratings, Insurance & Credentials

Scrape Healthgrades for doctor profiles, patient reviews, ratings, board certifications, insurance accepted, hospital affiliations, and practice locations. Extract NPI numbers, telehealth availability, and patient satisfaction scores. Essential for healthcare reputation monitoring, provider research, and patient acquisition analysis.

Features

• Provider Profiles - Complete doctor/provider data with all credentials
• Patient Reviews - Ratings, review text, wait times, recommendation status
• Specialty Search - Cardiologists, dentists, dermatologists, orthopedists, and more
• Insurance Filtering - Filter by Aetna, Blue Cross, United Healthcare, etc.
• Board Certifications - Education, certifications, years of experience
• Hospital Affiliations - Linked hospitals and medical centers
• NPI Numbers - National Provider Identifier for each doctor
• Telehealth Availability - Virtual visit capability flag
• Location-Based Search - City, state, or ZIP code filtering
• Anti-Detection - Residential proxies for reliable access
• No Login Required - Works with public Healthgrades data
• Demo Mode - Test with sample data before going live

Who Should Use This Actor?

Healthcare Marketing Agencies

Monitor client physician profiles on Healthgrades. Track review trends, identify low-rated providers needing attention, and benchmark against competitors in the same specialty.

Hospital Administrators

Track physician ratings across your network. Identify providers with declining patient satisfaction and compare your facility's doctors against competing hospitals.

Medical Practice Managers

Monitor your practice's Healthgrades presence. Respond to patient feedback, track review volume over time, and identify which providers drive the most patient interest.

Health Insurance Companies

Map provider networks, verify credentials, and identify high-rated providers for preferred network placement.

Healthcare Recruiters

Research physicians by specialty, location, and credentials. Identify top-rated providers in specific markets for recruitment campaigns.

Patient Acquisition Teams

Find areas with provider shortages or low-rated providers. Identify opportunities for new practice locations based on specialty gaps.

Important: Rate Limiting Considerations

Healthgrades monitors automated access. To minimize detection:

1. Start slow - Begin with maxResults: 10 and increase gradually
2. Use residential proxies - The actor defaults to residential proxies
3. Space your runs - Wait 15-30 minutes between runs
4. Keep review counts reasonable - Limit maxReviewsPerProvider to 10-25
5. Batch by specialty - Run one specialty per batch rather than broad searches

No account required - This scraper uses public data.

Quick Start

Demo Mode (Free Test)

{
  "demoMode": true
}

Search by Specialty and Location

{
  "scrapeType": "specialty_search",
  "specialty": "Cardiologist",
  "location": "Houston, TX",
  "includeReviews": true,
  "maxResults": 25,
  "demoMode": false
}

Scrape a Specific Provider

{
  "scrapeType": "provider_profile",
  "providerUrl": "https://www.healthgrades.com/physician/dr-john-smith-abc123",
  "includeReviews": true,
  "maxReviewsPerProvider": 25,
  "demoMode": false
}

Search by Name

{
  "scrapeType": "search",
  "providerName": "Dr. Smith",
  "specialty": "Orthopedic Surgery",
  "location": "Chicago, IL",
  "maxResults": 10,
  "demoMode": false
}

Input Parameters

Parameter	Type	Default	Description
scrapeType	string	search	Type: provider_profile, search, reviews, specialty_search
providerUrl	string	-	Direct Healthgrades profile URL
providerName	string	-	Doctor or provider name to search
specialty	string	-	Medical specialty (Cardiologist, Dentist, Dermatologist, etc.)
location	string	-	City, State or ZIP code
insuranceAccepted	string	-	Filter by insurance provider
minRating	number	-	Minimum rating (1.0-5.0)
gender	string	-	Filter by provider gender
acceptingNewPatients	boolean	-	Only show providers accepting new patients
includeReviews	boolean	true	Scrape patient reviews
maxReviewsPerProvider	number	25	Max reviews per provider
maxResults	number	50	Maximum providers
proxyConfiguration	object	Residential	Proxy settings
demoMode	boolean	true	Return sample data for testing
webhookUrl	string	-	Webhook URL for results delivery

Output Format

{
  "providerName": "Dr. John Smith, MD",
  "healthgradesUrl": "https://www.healthgrades.com/physician/dr-john-smith-abc123",
  "npi": "1234567890",
  "specialty": "Cardiologist",
  "subspecialties": ["Interventional Cardiology", "Heart Failure"],
  "rating": 4.8,
  "reviewCount": 156,
  "patientSatisfactionScore": 92,
  "education": [
    {
      "type": "Medical School",
      "institution": "Johns Hopkins University",
      "year": 2005
    }
  ],
  "boardCertifications": ["Cardiovascular Disease", "Internal Medicine"],
  "yearsExperience": 19,
  "gender": "Male",
  "languages": ["English", "Spanish"],
  "acceptingNewPatients": true,
  "telehealth": true,
  "insuranceAccepted": ["Aetna", "Blue Cross", "United Healthcare"],
  "practiceLocations": [
    {
      "name": "Heart Care Clinic",
      "address": "123 Medical Center Dr, Suite 200",
      "city": "Houston",
      "state": "TX",
      "zip": "77001",
      "phone": "(555) 123-4567"
    }
  ],
  "conditionsTreated": ["Heart Disease", "Arrhythmia", "Hypertension"],
  "proceduresPerformed": ["Cardiac Catheterization", "Stent Placement"],
  "hospitalAffiliations": ["Memorial Hermann Hospital", "Houston Methodist"],
  "awards": ["Top Doctor 2025", "Patient's Choice Award"],
  "reviews": [
    {
      "reviewId": "hg123456",
      "rating": 5,
      "title": "Excellent cardiologist",
      "text": "Dr. Smith is thorough and explains everything clearly...",
      "date": "November 2025",
      "waitTime": "Less than 15 minutes",
      "recommendsDoctor": true,
      "verified": true
    }
  ],
  "scrapedAt": "2026-01-28T10:30:00.000Z"
}

Pricing (Pay-Per-Event)

Event	Description	Price
provider_scraped	Per provider profile scraped	$0.08
review_scraped	Per review extracted	$0.005

Example costs:

• 50 providers with 25 reviews each: (50 x $0.08) + (1250 x $0.005) = $10.25
• 100 providers, no reviews: 100 x $0.08 = $8.00
• 10 providers with full reviews: (10 x $0.08) + (250 x $0.005) = $2.05
• Demo mode: $0.00

Common Scenarios

Scenario 1: Practice Reputation Monitoring

{
  "scrapeType": "provider_profile",
  "providerUrl": "https://www.healthgrades.com/physician/dr-your-name-abc123",
  "includeReviews": true,
  "maxReviewsPerProvider": 50,
  "demoMode": false
}

Schedule monthly to track patient satisfaction trends.

Scenario 2: Competitive Specialty Analysis

{
  "scrapeType": "specialty_search",
  "specialty": "Dentist",
  "location": "Nashville, TN",
  "minRating": 4.0,
  "acceptingNewPatients": true,
  "maxResults": 50,
  "demoMode": false
}

Scenario 3: Insurance Network Mapping

{
  "scrapeType": "specialty_search",
  "specialty": "Primary Care",
  "location": "Denver, CO",
  "insuranceAccepted": "United Healthcare",
  "maxResults": 100,
  "demoMode": false
}

Webhook & Automation Integration

Webhook Configuration

{
  "scrapeType": "specialty_search",
  "specialty": "Cardiologist",
  "location": "Houston, TX",
  "webhookUrl": "https://your-endpoint.com/webhook"
}

Zapier / Make.com / n8n

1. Create a webhook trigger in your automation platform
2. Copy the webhook URL to webhookUrl
3. Route results to Google Sheets, CRM, Slack, etc.

Popular automations:

• New negative reviews -> Slack alert (reputation monitoring)
• Provider data -> Google Sheets (network database)
• Low-rated providers -> Email to practice manager

Apify Scheduled Runs

Schedule monthly runs to track provider ratings over time.

Official API Alternatives

Healthgrades API

Healthgrades does not offer a public data API. Provider data is available through:

• NPPES NPI Registry - Free NPI lookups (no reviews or ratings)
• CMS Data - Medicare provider data (no patient reviews)

Alternative Sources

• Vitals.com - Patient reviews (limited)
• Zocdoc - Appointment and review platform (API for partners)
• WebMD - Provider directory (no API)
• RateMDs - Doctor reviews (limited API)

This Scraper's Advantages

1. No partnership required - Access public data directly
2. Patient reviews with full text - Including wait times and recommendations
3. NPI numbers - For cross-referencing with other databases
4. Insurance network data - Accepted insurance providers
5. Board certifications - Complete credential verification
6. Pay-per-result pricing

FAQ

Q: Do I need a Healthgrades account?

A: No. This scraper uses public Healthgrades data. No login required.

Q: Can I search for specific specialties?

A: Yes. Use the specialty parameter with values like "Cardiologist", "Dentist", "Dermatologist", "Orthopedic Surgeon", "Primary Care", etc.

Q: What is the NPI number?

A: The National Provider Identifier (NPI) is a unique 10-digit ID for healthcare providers. It can be used to cross-reference with CMS databases and insurance networks.

Q: Can I filter by telehealth availability?

A: The telehealth field in the output indicates if a provider offers virtual visits. Use this to filter results in post-processing.

Q: How often should I run this?

A: Monthly runs are sufficient for most reputation monitoring use cases. New reviews typically appear weekly on Healthgrades.

Common Problems & Solutions

"Provider not found"

• Verify the Healthgrades URL includes the provider's unique ID
• Try searching by name instead of URL
• Some newer providers may not have established profiles yet

"Limited review data"

• Not all providers have significant review volumes
• Healthgrades may hide some reviews from non-logged-in users
• Try increasing maxReviewsPerProvider

"Rate limited or blocked"

• Wait 15-30 minutes between runs
• Reduce maxResults to 10-25
• Run during off-peak hours (evenings, weekends)

"Demo data showing"

• Set demoMode: false - no account required

---

Built by John Rippy | Actor Arsenal