ParseForge
Healthgrades Doctor & Provider Scraper
parseforge/healthgrades-scraper
Developer toolsAutomationLead generation
Scrapes Healthgrades provider listings and detailed profiles. Returns name, specialty, rating, location, and contact data per row. Supports search by specialty, doctor name, or condition with optional full profile enrichment.
- Total users
- 20
- Monthly active
- 6
- Total runs
- 13K
- Bookmarked
- 0
- Rating
- Not rated yet
- Last modified
- 12 days ago
Overview
Healthgrades Doctor & Provider Scraper
Scrape doctor profiles, specialties, and provider data from Healthgrades, up to a million per run. Every record returns name, specialty, rating, location, and contact details. Optionally enrich with full education, insurance, and patient reviews. Export to CSV, JSON, Excel, or XML.
Healthgrades holds millions of U.S. provider profiles, but manually collecting them for market analysis or directory building is slow and repetitive. This Actor reads the public search and profile pages directly, letting you pull structured doctor and provider data by specialty, name, or condition in any city or ZIP code. No API key or browser extension needed, a search term and a location.
| Who uses it | What they scrape Healthgrades for |
|---|---|
| Healthcare market analysts | Map provider density and specialty availability across regions. |
| Medical recruiters | Build lists of physicians by specialty and location for outreach. |
| Insurance network managers | Verify in-network provider directories against current public listings. |
| Healthtech developers | Populate doctor search and referral applications with fresh provider data. |
What it does
This Actor collects Healthgrades provider listings from search results and optional detail pages, returning each provider as a flat row with name, specialty, rating, location, and contact information.
- 🔍 Targeted search: feed a specialty, doctor name, or condition plus a city or ZIP code to collect matching providers.
- 📋 Bulk extraction: set a high maximum items count to pull thousands of records in a single run.
- 📄 Full profile enrichment: enable Include Full Details to visit each profile and collect education, certifications, hospital affiliations, insurance accepted, conditions treated, procedures performed, awards, languages, and patient reviews.
- ⚙️ Concurrency control: adjust the request speed from 1 to 20 parallel requests to stay under rate limits.
Results export to CSV, JSON, Excel, or XML, or straight from the API.
What you can do with Healthgrades data
📊 Analyze provider markets.
A healthcare consultant runs the Actor for 'cardiologist' in 'Miami, FL' to count providers and average ratings for a competitive landscape report.
📋 Build recruitment lists.
A staffing agency scrapes 'family medicine' across multiple ZIP codes to generate a clean CSV of potential candidates with phone numbers.
🏥 Verify directory accuracy.
An insurance plan manager pulls all 'internal medicine' providers in a county and cross-references the list against their internal network database.
💻 Power a doctor finder app.
A developer populates a patient-facing search tool with fresh Healthgrades data, including accepted insurance and languages spoken.
Why choose this scraper
| What you get | |
|---|---|
| Direct search input | Scrape results for any specialty, doctor name, or condition in a specific city or ZIP code. |
| Optional deep profiles | Toggle full details to add education, insurance, hospital affiliations, and patient sentiment. |
| Flexible output | Export structured data to CSV, JSON, Excel, or XML for analysis or database import. |
How it compares
This Actor focuses on flexible search-driven collection with optional deep profile enrichment, compared to other Healthgrades scrapers on Apify.
| Feature | ParseForge | Healthgrades Scraper - Doctor NPI, Ratings & Contact Data | HealthGrades Scraper | $4 / 1k | US Doctors & Hospitals | HealthGrades Scraper 🩺 |
|---|---|---|---|---|
| Search by specialty and location | Yes | Not listed | Yes | Not listed |
| Full profile detail pages | Yes, optional | Yes | Not listed | Not listed |
| Patient review text extraction | Yes | Not listed | Not listed | Yes |
| Direct URL input | Yes | Not listed | Not listed | Not listed |
| Configurable concurrency | Yes | Not listed | Not listed | Not listed |
Configure the run
Drive the Actor with a search query and location, or a direct Healthgrades URL, and set a maximum number of providers to cap the run. The Input tab lists every parameter.
A first run with the defaults:
{
"maxItems": 10,
"searchQuery": "cardiologist",
"location": "New York, NY"
}
A larger pull:
{
"maxItems": 200,
"searchQuery": "cardiologist",
"location": "New York, NY"
}
Pricing
Pay-per-result: $0.01734 per result collected. You pay only for the results written to your dataset.
| Results collected | Approximate cost |
|---|---|
| 100 results | $1.73 |
| 1,000 results | $17.34 |
| 10,000 results | $173.40 |
New Apify accounts start with $5 in free credit.
Free users
Free-plan runs return up to 10 results as a preview. Upgrade your Apify plan to collect up to 1,000,000 results per run.
Run it
- Create a free Apify account with $5 in credit.
- Open the Healthgrades Doctor & Provider Scraper.
- Set your inputs and any filters, then click Start.
- Export the results as CSV, Excel, JSON, or XML from the Dataset tab.
Run it programmatically through the Apify API (run-sync-get-dataset-items) or the ApifyClient for JavaScript and Python.
Use with AI agents (MCP)
Give an AI agent live access to Healthgrades through the Model Context Protocol. Add the Actor to Claude, Cursor, or any MCP client:
claude mcp add --transport http apify "https://mcp.apify.com?tools=parseforge/healthgrades-scraper"
Then prompt it in plain language to run the scraper and read back the results.
Troubleshooting
Why am I getting no results?
Check that your search query and location combination returns results on the Healthgrades website itself. Try a broader term like 'doctor' and a major city to verify the Actor is working, then narrow your search.
The run is very slow with full details enabled.
Enabling full details visits every single profile page, which multiplies the number of requests. Increase the max concurrency slightly or run the Actor without full details first to get a base list, then run a second time with details on a smaller subset.
I am getting errors or empty fields in my results.
Healthgrades may occasionally change its page layout. If fields come back empty, try running a smaller test batch. If the issue persists, the page structure may have updated and the Actor will need an adjustment.
The Actor stops before reaching my max items.
The Actor stops when it has exhausted the available search results for your query. If fewer providers exist than your max items setting, it will finish early. Try a broader search term or a larger geographic area.
FAQ
| Question | Answer |
|---|---|
| Can I scrape providers without using a specific doctor name? | Yes. Use the search query field with a specialty like 'dermatologist' or a condition like 'back pain' combined with a city or ZIP code to return all matching providers. |
| Does this Actor collect patient reviews? | When you enable Include Full Details, the Actor visits each profile page and extracts patient review scores and comment snippets along with the full profile data. |
| How do I get NPI numbers? | The Actor extracts the data available on the public Healthgrades profile. If an NPI number is displayed on the profile page and you have enabled full details, it will be included in the output. |
| Can I scrape hospitals and pharmacies too? | This Actor is built for individual doctor and provider profiles. It can return results from a general search, but the detailed profile enrichment is optimized for person-level provider pages. |
| What is the maximum number of providers I can scrape? | You can set the maximum providers input up to 1,000,000 per run. The actual number collected depends on the search results available for your query and location. |
| How do I avoid getting blocked? | Start with the default concurrency of 5. If you see rate limiting, lower the max concurrency setting to reduce request speed. Using a higher plan with more IP rotation also helps for very large runs. |
| Can I input a direct URL instead of searching? | Yes. Paste any Healthgrades search results URL into the start URL field, and the Actor will parse that page directly, ignoring the search query and location inputs. |
| Does this work for dentists and other specialists? | Yes. Any provider type listed on Healthgrades, including dentists, can be searched by entering the specialty name in the search query field. |
Related actors
Browse the full ParseForge collection for more scrapers.
🆘 Need help? Email parseforge@protonmail.com with your run ID, your input, and what you expected.
⚠️ Disclaimer. This Actor is unofficial and is not affiliated with, endorsed by, or sponsored by Healthgrades Marketplace, LLC. It collects only publicly available data. You are responsible for using the collected data in compliance with the source's terms of service and applicable data-protection laws, including GDPR, CCPA, and PIPL. Do not use it to collect personal data unlawfully.
Input
| Field | Type | What it does | Default |
|---|---|---|---|
| startUrl | string | Direct Healthgrades search URL. If provided, Search Query and Location are ignored. | not set |
| maxItems | integer | How many providers to collect per run. | 10 |
| searchQuery | string | What to search for (e.g. 'cardiologist', 'dentist', 'Dr. John Smith'). | cardiologist |
| location | string | City and state or ZIP code (e.g. 'Miami, FL', '10001'). Used together with Search Query. | New York, NY |
| includeDetails | boolean | Visits each provider's profile page to collect education, certifications, hospitals, insurance, conditions, procedures, awards, languages, and patient reviews. Slower but much richer data. | false |
| maxConcurrency | integer | Maximum number of parallel requests. Lower this if you experience rate limiting. | 5 |
Pricing
from $12.99 per 1,000 results
| Charged for | What it is | Price each |
|---|---|---|
| Actor Start | Charged once when the run starts. | $0.005 |
| Result Item | Charged once per result collected. | $0.01299 to $0.01734 |
Tiered: the lower figure is the price on a higher Apify plan. Billing and the free credit live on Apify.
API
One POST returns the dataset directly. Same shape for every scraper in the library, so swapping the slug is the only change.
curl -X POST "https://api.apify.com/v2/acts/parseforge~healthgrades-scraper/run-sync-get-dataset-items?token=$APIFY_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"helloWorld": 123
}' Examples
Input that runs as-is.
{
"helloWorld": 123
} Reviews
No reviews yet. Be the first.
Issues
We build and maintain this scraper, so a problem with it comes to us. Report it on the Apify listing and the thread stays attached to the scraper where the next person can find it: open an issue.
Broken and urgent, or you would rather not post in public? Write to parseforge@protonmail.com and it reaches the people who wrote it.
Related scrapers
Run Healthgrades Doctor & Provider Scraper on Apify All scrapers