# Healthcare Reviews Scraper (from $1.68/1K) (`carabain-digital/healthcare-reviews`) Actor

Scrape doctor reviews from Zocdoc, Healthgrades, Vitals and WebMD in one run. Paste your links in any mix: each one is detected and scraped. One dataset with rating (1-5), text, date, reply and source.

- **URL**: https://apify.com/carabain-digital/healthcare-reviews.md
- **Developed by:** [Carabain Digital](https://apify.com/carabain-digital) (community)
- **Categories:** Lead generation, Marketing
- **Features:** Limited permissions
- **Stats:** 1 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $4.28 / 1,000 zocdoc reviews

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

#### What is Healthcare Reviews Scraper?

**Healthcare Reviews Scraper** extracts the **patient reviews of doctors and practices from Zocdoc, Healthgrades, Vitals and WebMD in one run**: star rating, title, review text, date, reviewer name and the doctor's reply. Paste your links in any mix, click **Start**, and download one combined dataset as JSON, CSV, Excel, XML or HTML. Every review carries a `source` field, so you can compare a doctor's reputation across review sites in a single table.

Most US doctors have a profile on several review sites, and each site shows its own reviews and rating. With this scraper you can:

- 🩺 **Scrape four sites with one Actor**: [Zocdoc](https://www.zocdoc.com), [Healthgrades](https://www.healthgrades.com), [Vitals](https://www.vitals.com) and [WebMD](https://doctor.webmd.com)
- 🔗 **Mix links freely**: several doctors, several sites, one run. Each link is routed to the right site automatically
- 📊 **Compare sites side by side**: one dataset, one format, a `source` column
- 💬 **Get review text and the doctor's reply**
- 📅 **Fetch only new reviews** since a given date, ideal for daily monitoring
- 🛡️ **Get past bot protection**: a real browser and a US residential proxy are included in the price
- 🔌 **Connect the data** to Google Sheets, Slack, Make, Zapier or your own app via the API

#### What data can I extract?

<table>
<tr><td>⭐ Star rating (1-5)</td><td>💬 Review text</td></tr>
<tr><td>👤 Reviewer name</td><td>📅 Publication date</td></tr>
<tr><td>↩️ Reply</td><td>🆔 Stable review ID</td></tr>
<tr><td>📝 Review title (if any)</td><td>🌍 Site (`source`)</td></tr>
<tr><td>🔗 Source link</td><td></td></tr>
</table>

#### Why scrape doctor reviews from several sites?

- 🏥 **Practices, clinics and hospital groups**: see how patients rate every provider on every site, in one export
- 📈 **Healthcare marketing agencies**: report on your clients' online reputation without copying reviews by hand
- 📊 **Reputation benchmarking**: compare a doctor's Zocdoc, Healthgrades, Vitals and WebMD ratings, or compare providers in a region
- 🤖 **Sentiment analysis**: feed all patient reviews into your own analysis or LLM pipeline

#### How do I use Healthcare Reviews Scraper?

1. [Create a free Apify account](https://console.apify.com/sign-up).
2. Open each doctor or practice on its site and copy the URL of its profile page. Examples: `https://www.healthgrades.com/physician/dr-jonathon-wertz-x5ksw` or `https://www.zocdoc.com/practice/westside-family-medicine-1174`.
3. Paste all links into **Review page links**, in any mix of the supported sites.
4. Set **Max reviews per link**, and optionally **Only reviews after** to fetch only reviews since a given date.
5. Click **Start** and wait for the run to finish.
6. Download your data from the **Output** tab in JSON, CSV, Excel, XML or HTML.

#### How much does scraping doctor reviews cost?

You **pay per review** that ends up in your dataset, and the price depends on the site it comes from. On top of that there is **$0.05 per run** ($0.025 per GB of memory; the default is 2 GB) for starting the browser and proxy. No subscription, no rental fee.

| Site | Price per 1,000 reviews |
|---|---|
| Zocdoc | $5.70 |
| Healthgrades | $1.68 |
| Vitals | $2.28 |
| WebMD | $2.40 |

Zocdoc costs more because every link needs a real browser to get past its bot protection.

The monthly credits in Apify's free plan cover a couple of thousand reviews.

💡 **Tip:** for monitoring, schedule a daily run with **Only reviews after** set to the date of your last run. You only pay for new reviews.

💡 **Only need one site?** This Actor is the convenient bundle. The single-site scrapers are a bit cheaper: [Zocdoc](https://apify.com/carabain-digital/zocdoc-reviews), [Healthgrades](https://apify.com/carabain-digital/healthgrades-reviews), [Vitals](https://apify.com/carabain-digital/vitals-reviews) and [WebMD](https://apify.com/carabain-digital/webmd-reviews).

You can set a maximum cost per run in the run options; the scraper stops when it is reached.

#### 🧠 AI review analysis (add-on)

Turn on **AI review analysis** (`aiAnalysis`) and each review with text gets four extra fields, in any language:

| Field | Example |
|---|---|
| `ai_sentiment` | `positive`, `neutral`, `negative` or `mixed` |
| `ai_score` | `-0.8` (from -1, very negative, to 1, very positive) |
| `ai_topics` | `["delivery time", "food temperature"]` (up to 5, in English) |
| `ai_summary` | `The order arrived two hours late and was cold.` (one sentence, in English) |

Use it to spot complaints fast, chart sentiment over time or group reviews by topic, without your own AI setup. It costs **$3 per 1,000 analysed reviews** on top of the scraping price; reviews without text are not analysed or charged.

#### ⬇️ Input

The only required field is the list of links. See the **Input** tab for all options.

| Field | Description |
|---|---|
| **Review page links** (`startUrls`) | Doctor or practice pages on Zocdoc, Healthgrades, Vitals or WebMD, any mix, several per site. The site is detected from each link |
| **Max reviews per link** (`limit`) | Stop after this many reviews for each link, newest first. Default 100 |
| **Only reviews after** (`cutoff_date`) | Skip reviews published before this date |
| **AI review analysis** (`aiAnalysis`) | Adds sentiment, score, topics and a summary to each review (add-on, $3 per 1,000 reviews) |
| **Proxy** (`proxyConfiguration`) | US residential proxy, on by default and included in the price. Keep it on: these sites block data-center IPs, and Healthgrades only serves US visitors |

```json
{
    "startUrls": [
        {"url": "https://www.healthgrades.com/physician/dr-jonathon-wertz-x5ksw"},
        {"url": "https://www.vitals.com/doctors/beth-shubin-stein-epgjil"}
    ],
    "limit": 100,
    "cutoff_date": "2026-01-01"
}
```

#### ⬆️ Output sample

Each review is one item in the dataset. View it as a table in the **Output** tab or download it in JSON, CSV, Excel, XML or HTML.

##### 📘 Scraped doctor review sample (illustrative)

```json
{
    "id": "healthgrades:8f1c2a7e",
    "source": "healthgrades",
    "author": "Jessica M.",
    "rating": 5,
    "title": null,
    "text": "Great experience from start to finish, would recommend!",
    "published_at": "2026-09-27T03:12:05Z",
    "reply": null,
    "replied_at": null,
    "source_url": "https://www.healthgrades.com/physician/dr-jonathon-wertz-x5ksw"
}
```

| Field | Description |
|---|---|
| `id` | The site's review ID prefixed with the site (`vitals:abc123`), unique across sites and stable across runs, so you can deduplicate on it |
| `source` | The site: `zocdoc`, `healthgrades`, `vitals` or `webmd` |
| `rating` | Star rating (1-5) on every site, or `null` if the review has no score |
| `title` | Review title, or `null` when the site has none |
| `text` | Review text |
| `published_at` | Publication date in ISO 8601 |
| `reply` | The doctor's or practice's public reply, or `null` |
| `replied_at` | Reply date, or `null` when the site doesn't publish it |
| `source_url` | The link from your input that the review came from |

All our review scrapers use this same format, so you can combine datasets from different sites directly. See for example our [Kiyoh Reviews Scraper](https://apify.com/carabain-digital/kiyoh-reviews).

#### 🔌 Integrations

Connect Healthcare Reviews Scraper to almost any cloud service or web app with [Apify integrations](https://apify.com/integrations): Make, Zapier, Slack, Google Sheets, Google Drive, Airbyte, GitHub and more. Or use [webhooks](https://docs.apify.com/platform/integrations/webhooks) to trigger an action when a run finishes, for example to post new reviews to Slack.

#### 💻 Using Healthcare Reviews Scraper with the Apify API

The [Apify API](https://docs.apify.com/api/v2) lets you start runs, schedule them and fetch results from your own code. Use the [Python](https://docs.apify.com/api/client/python) or [JavaScript](https://docs.apify.com/api/client/js) client, or call the scraper from AI agents through the [Apify MCP server](https://mcp.apify.com). The **API** tab has ready-to-use code.

#### ❓ FAQ

##### Which sites and links are supported?

Zocdoc, Healthgrades, Vitals and WebMD (doctor.webmd.com). Use the profile page of one doctor or practice, not a search or specialty page. A link from any other site is skipped, and the log says so.

##### Can I scrape multiple doctors at once?

Yes. Add one link per doctor and site in **Review page links**. **Max reviews per link** applies to each link separately. Links run one after the other, so large lists take a while: split them over several runs or [tasks](https://docs.apify.com/platform/actors/running/tasks) if you need them fast.

##### What happens if one link fails?

It is skipped and the other links still run; you only pay for reviews that reach the dataset. The run fails only when every link failed. Check the log for the reason per link.

##### Can I use this Actor from an AI agent or MCP client?

Yes. Connect the [Apify MCP server](https://mcp.apify.com), add this Actor and ask your agent something like "get the latest 20 reviews of this doctor on Healthgrades and Vitals". Pass the links as `startUrls`.

##### Do I need accounts or proxies?

No accounts: the scraper only reads publicly visible reviews. A US residential proxy is on by default and its cost is included in the price per review. If a request gets blocked, the scraper retries on a fresh IP automatically.

##### Anything special about this data?

Zocdoc uses strong bot protection, so the scraper opens a real browser first; Healthgrades, Vitals and WebMD are read directly. Runs with Zocdoc links take a bit longer and need more memory than a plain HTTP scraper. Scores are shown as 1-5 stars on every site, but the sites' own averages are computed differently, so compare trends rather than decimals.

##### My run failed. What now?

Check the status message of the run. "not a supported site" means the link is not from one of the four sites. "Blocked" means the sites refused every link; run it again and keep the proxy on.

##### Is it legal to scrape doctor reviews?

This scraper only collects publicly visible reviews. Reviews can contain personal data, such as reviewer names and, in patient reviews, health information, which is protected by the GDPR in the EU and by other regulations elsewhere. Only scrape and store personal data when you have a legitimate reason, and consult your lawyer if you are unsure. Read more in Apify's post on [the legality of web scraping](https://blog.apify.com/is-web-scraping-legal/).

#### Your feedback

Found a bug or missing a field? Open an issue in the **Issues** tab and we'll look into it.

⭐ **Does it work well for you?** A review on the Store page helps others find this Actor and helps us keep it maintained.

# Actor input Schema

## `startUrls` (type: `array`):

Links to the doctor or practice pages whose reviews you want. Mix sites and add several links per site: the site of each link is detected automatically. Supported: Zocdoc, Healthgrades, Vitals and WebMD (doctor.webmd.com). Links from other sites are skipped with a message in the log.

## `limit` (type: `integer`):

Stop after this many reviews for each link (newest first). Ten links with 100 means up to 1,000 reviews.

## `cutoff_date` (type: `string`):

Skip reviews published before this date (YYYY-MM-DD). Useful for incremental runs.

## `aiAnalysis` (type: `boolean`):

Adds sentiment (positive, neutral, negative or mixed), a score from -1 to 1, up to 5 topics and a one-line summary to each review with text, using AI. Charged as the AI review analysis add-on per analysed review; reviews without text are not charged.

## `proxyConfiguration` (type: `object`):

A US residential proxy is on by default because all four sites block data-center IPs (Healthgrades only serves US visitors). Its cost is included in the price.

## Actor input object example

```json
{
  "startUrls": [
    {
      "url": "https://www.healthgrades.com/physician/dr-jonathon-wertz-x5ksw"
    },
    {
      "url": "https://www.vitals.com/doctors/beth-shubin-stein-epgjil"
    }
  ],
  "limit": 10,
  "aiAnalysis": false,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ],
    "apifyProxyCountry": "US"
  }
}
```

# Actor output Schema

## `reviews` (type: `string`):

All scraped reviews from all sites, one item per review.

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "startUrls": [
        {
            "url": "https://www.healthgrades.com/physician/dr-jonathon-wertz-x5ksw"
        },
        {
            "url": "https://www.vitals.com/doctors/beth-shubin-stein-epgjil"
        }
    ],
    "limit": 10,
    "proxyConfiguration": {
        "useApifyProxy": true,
        "apifyProxyGroups": [
            "RESIDENTIAL"
        ],
        "apifyProxyCountry": "US"
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("carabain-digital/healthcare-reviews").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "startUrls": [
        { "url": "https://www.healthgrades.com/physician/dr-jonathon-wertz-x5ksw" },
        { "url": "https://www.vitals.com/doctors/beth-shubin-stein-epgjil" },
    ],
    "limit": 10,
    "proxyConfiguration": {
        "useApifyProxy": True,
        "apifyProxyGroups": ["RESIDENTIAL"],
        "apifyProxyCountry": "US",
    },
}

# Run the Actor and wait for it to finish
run = client.actor("carabain-digital/healthcare-reviews").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "startUrls": [
    {
      "url": "https://www.healthgrades.com/physician/dr-jonathon-wertz-x5ksw"
    },
    {
      "url": "https://www.vitals.com/doctors/beth-shubin-stein-epgjil"
    }
  ],
  "limit": 10,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ],
    "apifyProxyCountry": "US"
  }
}' |
apify call carabain-digital/healthcare-reviews --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,carabain-digital/healthcare-reviews"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/V0IiJAQKlSZuIdEZD/builds/lmZ7v08xvCKZJGsuy/openapi.json
