Healthgrades Scraper

Healthgrades Scraper collects public US doctor profiles and optional patient reviews from Healthgrades for healthcare marketing, lead lists and reputation analysis. Search by specialty and location, or supply directory and provider profile URLs, then export the results as structured dataset rows.

Use the data to map a local healthcare market, compare public reputation signals, identify practices that accept particular insurers, or match provider records through their National Provider Identifier (NPI). Each provider row includes the Healthgrades profile URL so you can return to the source and check the current information.

How to scrape Healthgrades without code

1. Open the actor and enter a specialty such as Dermatology and a location such as Chicago, IL, or paste one or more Healthgrades search, directory or profile URLs into startUrls.
2. Set maxItems to the number of providers you need. Leave includeReviews off for a provider list, or switch it on and choose maxReviewsPerPlace to add patient reviews.
3. Start the run. Providers appear in the dataset as they are collected, each followed by its reviews.
4. Export the dataset as CSV, Excel or JSON, or read it through the Apify API from your own code, a spreadsheet integration or a scheduled task.

Healthgrades Scraper input

Start with a specialty and a location. The following search was used to collect the example output:

{
  "specialty": "Dermatology",
  "location": "Chicago, IL",
  "maxItems": 45,
  "includeReviews": true
}

specialty accepts a specialty, provider name or condition. searchQuery is an alias for that field. If you provide both fields, specialty takes precedence. location accepts a US city and state, a five digit ZIP code, a state abbreviation or a full state name. A state input searches the whole state. A city search uses the source's default radius of five miles unless you set radiusMiles.

For a wider search, set radiusMiles to an integer between 1 and 100. A value of 0 requests a national search. Choose sortBy from bestmatch, distance or ratings. These options apply to text searches. Search URLs preserve their own query parameters and ordering.

You can supply up to 20 URLs in startUrls. Supported pages include Healthgrades search results, specialty directories and individual physician or provider profiles. For example, the profile fixture comes from https://www.healthgrades.com/physician/dr-anthony-rizzo-xp8bc. When URLs are supplied, they take precedence over the text search fields. Providers are deduplicated across the supplied pages.

maxItems limits the number of unique providers per search or directory, from 1 to 1,980. It defaults to 20. Reviews do not consume this provider limit. A profile URL supplies one provider. Large searches continue automatically within an Apify run; you do not need to manage the continuation cursor yourself.

Output and exported fields

The dataset contains two kinds of rows. record_type and _type identify a row as place or review. Both types carry source, platform, fetched_at and place_id. Reviews appear immediately after their provider, which makes the exported dataset easy to inspect and join.

Provider rows include the name, NPI, primary specialty, profile URL, practice address, city, state, postal code, coordinates and telephone where the source displays them. Additional fields include accepted insurers, age, gender, years of experience, acceptance of new patients, telehealth availability, profile image and practice locations. Some fields can be absent or null because the public page does not display them. The scraper respects address and telephone suppression in the source results.

rating is the displayed average star score. ratings_count counts all star ratings, while reviews_count counts written reviews. These measures serve different purposes and should be kept separate in your analysis. An unrated provider has a null rating, which avoids presenting a missing score as a zero star review.

Set includeReviews to true to collect written reviews as separate rows. maxReviewsPerPlace controls the number returned for each provider, from 1 to 20. Review rows include the review ID, provider ID, provider name and URL, star rating, original text, publication date and helpful count. A title or author name appears when the source supplies one. Profile URLs can also provide a public provider reply when available.

Example Healthgrades doctor row

This is the first provider row from the Dermatology / Chicago, IL search, exactly as the actor returned it:

{
  "_type": "place",
  "record_type": "place",
  "source": "healthgrades-scraper",
  "platform": "healthgrades",
  "fetched_at": "2026-10-05T08:42:46.578Z",
  "row_id": "place:YT6R6",
  "place_id": "YT6R6",
  "name": "Dr. Ralph Fiore, DO",
  "url": "https://www.healthgrades.com/physician/dr-ralph-fiore-yt6r6",
  "npi": "1770524043",
  "street": "1411 S Michigan Ave",
  "city": "Chicago",
  "state": "IL",
  "postal_code": "60605",
  "lat": 41.86298,
  "lng": -87.62393,
  "phone": "(312) 942-2195",
  "address": "1411 S Michigan Ave, Chicago, IL 60605",
  "country_code": "US",
  "category": "Dermatology",
  "categories": [
    "Dermatology",
    "Dermatologist"
  ],
  "specialty": "Dermatology",
  "rating": 4.8,
  "ratings_count": 51,
  "reviews_count": 33,
  "gender": "M",
  "age": 51,
  "years_experience": null,
  "insurances": [
    "Aetna",
    "Anthem",
    "Anthem Blue Cross Blue Shield",
    "Blue Cross Blue Shield",
    "CareFirst Blue Cross Blue Shield",
    "Cigna",
    "Curative",
    "First Health",
    "Humana",
    "MultiPlan"
  ],
  "accepts_new_patients": true,
  "telehealth": true,
  "is_patient_favorite": false,
  "distance_miles": 0.9,
  "image_url": "https://photos.healthgrades.com/img/prov/Y/T/6/YT6R6_w90h120_v23544.jpg",
  "about": "Dr. Ralph Fiore II is a board-certified Dermatologist specializing in medical dermatology and surgical dermatology with an emphasis on the detection and treatment of premalignant and malignant conditions of the skin.",
  "practice_locations": [
    {
      "street": "1411 S Michigan Ave",
      "city": "Chicago",
      "state": "IL",
      "postal_code": "60605",
      "lat": 41.86298,
      "lng": -87.62393
    },
    {
      "street": "13401 S Ridgeland Ave",
      "city": "Palos Heights",
      "state": "IL",
      "postal_code": "60463",
      "lat": 41.6481,
      "lng": -87.77699
    },
    {
      "street": "18425 West Creek Dr Ste F",
      "city": "Tinley Park",
      "state": "IL",
      "postal_code": "60477",
      "lat": 41.55622,
      "lng": -87.80044
    },
    {
      "street": "10500 W Loomis Rd Ste 110",
      "city": "Franklin",
      "state": "WI",
      "postal_code": "53132",
      "lat": 42.87986,
      "lng": -88.04972
    }
  ],
  "search_query": "Dermatology",
  "search_location": "Chicago, IL",
  "search_position": 1
}

Example patient review row

The review rows for that provider follow directly after it. This is the first one:

{
  "_type": "review",
  "record_type": "review",
  "source": "healthgrades-scraper",
  "platform": "healthgrades",
  "fetched_at": "2026-10-05T08:42:46.605Z",
  "row_id": "review:883924cf-c043-4072-a6e9-bd57c80fd2ce",
  "review_id": "883924cf-c043-4072-a6e9-bd57c80fd2ce",
  "place_id": "YT6R6",
  "place_name": "Dr. Ralph Fiore, DO",
  "place_url": "https://www.healthgrades.com/physician/dr-ralph-fiore-yt6r6",
  "rating": 5,
  "text": "Dr. Fiore is very friendly, takes the time to explain everything to you, answers all your questions ",
  "published_at": "2024-07-03T00:00:00Z",
  "likes": 0,
  "title": "Definitely",
  "author_name": "Rose Culhane"
}

Download the dataset in JSON, CSV, Excel or another format supported by Apify. Use place_id to join a review back to its provider and NPI to match provider records in another healthcare dataset. NPI identifies the provider; it does not identify a particular practice location.

Use cases for Healthgrades data

• Healthcare marketing and lead lists. Build a list of dermatologists, orthopedic surgeons or family physicians in a city or state, with practice address, phone, NPI and the insurers they accept, ready for outreach or territory planning.
• Reputation monitoring. Track star ratings, rating counts and the newest written reviews for your own physicians and for competing practices, and see which providers patients mark as favorites.
• Market and network analysis. Count providers per specialty and ZIP code, find areas where few doctors accept new patients or offer telehealth, and check which insurance networks are well covered.
• Data enrichment. Join Healthgrades ratings and reviews onto an existing provider database through the NPI, so a CRM or analytics table carries the public patient view next to your own records.
• Research. Study how ratings, review volume, experience and insurance acceptance vary across specialties and regions.

Healthgrades Scraper compared with other options

Option	What you get	Trade-off
Browsing healthgrades.com by hand	Any profile you open	Slow, no export, no review history across many doctors
Healthgrades business products	Tools for practices managing their own listings	Meant for a provider's own profile, not for exporting the directory
A self-built Healthgrades scraper	Full control	You maintain parsing, paging and review collection when the site changes
Other Healthgrades actors in the Apify Store	Doctor rows, often with NPI	Many cover providers only; check whether reviews, insurers and practice locations are included
This Healthgrades Scraper	Providers with NPI, insurers, ratings, practice locations and optional patient reviews in one dataset	Limited to what Healthgrades shows publicly: 99 search pages and 20 recent reviews per provider

Pricing and free usage

The actor uses separate provider and review events. A provider event corresponds to one delivered place row, and a review event corresponds to one delivered review row. The current event prices are shown in the actor's pricing tab. There is no scraper start fee, and a run that returns no rows has no result events to charge.

Free users receive up to 10 dataset rows per run, counting providers and reviews together. Your chosen maxReviewsPerPlace remains in effect within that total row limit. Because reviews follow their provider, enabling them means fewer providers fit into the free sample. For a provider only sample, leave includeReviews disabled. Your Apify spending limit can also stop delivery before the requested provider limit is reached.

Limits and incomplete searches

Healthgrades exposes at most 99 pages for one search and at most 20 recent written reviews per provider. A profile can show more total written reviews than the scraper can retrieve. The actor reports the provider's displayed total without suggesting that the exported review sample represents its complete history.

For broader coverage, split large searches into cities, ZIP codes or smaller radii. A national search still has the same page limit. Check the run output for partial and warnings when a source page or optional review request could not be completed. Provider rows remain available when only review collection fails. An unrecognised location produces no matching provider rows instead of returning the source's fallback city.

Frequently asked questions

Can I retrieve every historical review?

The source exposes up to 20 recent written reviews per provider. Increasing maxReviewsPerPlace beyond 20 is unsupported. Keep the displayed written review total separate from the number of review rows you export.

Can I search an entire state?

Yes. Use a state abbreviation such as NY, a full state name or a state specialty directory URL. The same maximum of 99 source pages applies. Split the state into smaller searches when you need coverage beyond that limit.

Why are ratings and review counts different?

A person can submit a star rating without a written review. ratings_count includes star ratings, and reviews_count counts written reviews. Review rows represent the written review sample actually returned by the source.

Does this provide private patient records or medical advice?

It collects public provider information and public review text displayed by Healthgrades. The output describes the source's listings and opinions. It does not provide medical advice or determine whether a provider is suitable for an individual patient.

Is there an official Healthgrades API?

Healthgrades does not offer a public self-serve API for exporting its doctor directory or patient reviews. This actor works as a Healthgrades API alternative: start it through the Apify API with the same input as above and read the dataset as JSON.

Can I export Healthgrades doctors to Excel or CSV?

Yes. Every run stores its rows in an Apify dataset, which you can download as CSV, Excel, JSON, XML or HTML. Filter on record_type to separate doctors from reviews.

Does the scraper return email addresses?

No. Healthgrades does not show email addresses on provider profiles, so the actor returns the phone number and practice address that the source displays.