# Vitals.com Doctor Scraper - NPI, Phone, Reviews & Insurance (`scrapersdelight/vitals-doctor-scraper`) Actor

Scrape Vitals.com doctors and dentists by specialty and city or state, or from profile links: NPI, office phone, address, ZIP, GPS, rating, reviews, education, licences, hospitals, insurances, Medicare/Medicaid and the newest patient review texts. No login.

- **URL**: https://apify.com/scrapersdelight/vitals-doctor-scraper.md
- **Developed by:** [Scrapers Delight](https://apify.com/scrapersdelight) (community)
- **Categories:** Lead generation, Automation, Agents
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

$1.30 / 1,000 doctors

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

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 does Vitals.com Doctor Scraper do?

**Vitals.com Doctor Scraper** extracts doctor and dentist profiles from [Vitals.com](https://www.vitals.com), the US doctor-rating directory, by specialty and city or state, or from profile links. Each row is one doctor with NPI, office phone and address, rating, credentials, accepted insurances and the newest patient reviews. Built for medical-device and pharma sales teams, healthcare recruiters, practice marketers and provider-data teams.

Also searched as: Vitals scraper · Vitals.com scraper · Vitals doctor scraper · physician directory scraper · doctor reviews scraper.

- **Doctor leads with NPI and phone:** NPI on 99-100% of doctors and an office phone on 80-96% in our test runs, plus a link to each doctor's record in the CMS NPI Registry.
- **The full profile in the same row:** every office with street address, ZIP, GPS and opening hours; education, state licences with their status, board certifications, hospital affiliations, insurance plans, Medicare and Medicaid.
- **Patient reviews with text:** the 10 newest written reviews per doctor (star rating, date, helpful votes), the star histogram, Vitals' patient-feedback tallies and its written review summary.
- **City, state or nationwide:** 3,076 cardiologists around New York City, 5,866 across New York State, 63,870 nationwide (Vitals' counts on 2026-10-14) - one search each.
- **No login, cookies or API key:** type a specialty and a place, or paste vitals.com links.
- **Pay per doctor, no start fee:** a doctor found by two of your searches appears (and is charged) once.
- **Monitor mode:** on a schedule, deliver only doctors that earlier runs have not delivered.
- **Export anywhere:** JSON, CSV, Excel, XML; schedules, webhooks, Make, Zapier, n8n, Google Sheets; the Apify API and MCP server for AI agents.

### What data can you get from Vitals.com?

<table>
<tr>
<td>👤 Name, prefix, degrees</td>
<td>🆔 NPI (`npi`) + NPI Registry link</td>
<td>🩺 Specialty, all specialties, expertise</td>
</tr>
<tr>
<td>☎️ Office phone (`phone`)</td>
<td>🏥 Practice and office name</td>
<td>📍 Address, city, state, ZIP</td>
</tr>
<tr>
<td>🧭 Latitude / longitude</td>
<td>🏢 Every office with hours (`offices`)</td>
<td>🌐 Website, booking and telehealth links</td>
</tr>
<tr>
<td>⭐ Rating, precise score, ratings count</td>
<td>💬 10 newest review texts (`reviews`)</td>
<td>📊 Star histogram, feedback tallies, wait time</td>
</tr>
<tr>
<td>🎓 Medical school, residency, fellowship</td>
<td>📜 Licences with status, certifications</td>
<td>🏨 Hospital affiliations</td>
</tr>
<tr>
<td>💳 Insurance plans accepted</td>
<td>✅ Medicare, Medicaid, new patients</td>
<td>🗣️ Languages, gender, years in practice</td>
</tr>
</table>

On our 100-doctor test runs (Family Medicine in Houston, Dentists in Chicago) 80-96% of rows had an office phone, 99-100% an NPI and 94-98% a full street address.

### How to scrape Vitals.com with Vitals.com Doctor Scraper

1. [Create a free Apify account](https://console.apify.com/sign-up) - it comes with monthly free credit, no card needed.
2. Open **Vitals.com Doctor Scraper** and click **Try for free**.
3. Type one or more **Specialties** ("Cardiology", "Dentist") and **Locations** ("Houston, TX", "TX") - or paste vitals.com links.
4. Set **Max doctors** and, if you like, filters such as rating, gender or "accepting new patients".
5. Click **Start**. Doctors stream into the dataset as they are read.
6. Open the **Storage** tab and **Export** as JSON, CSV or Excel - or schedule the run.

### ⬇️ Input

| Parameter | Type | Description |
|---|---|---|
| **🔍 What to scrape** | | |
| `specialties` | List | Specialties in everyday words: "Cardiology", "Family Medicine", "Dentist", "OB-GYN", "Dermatologist". Any Vitals specialty works. Default (prefill): `["Cardiology"]` |
| `locations` | List | "City, ST" ("St. Louis, MO") for a city and its area, a state ("TX", "California") for the whole state, empty for nationwide. Prefill: `["New York, NY"]` |
| `startUrls` | List | vitals.com specialty pages (`/cardiology/ny/new-york`, `/dermatology/ca`, `?page=N`), profiles (`/doctors/{name-id}`, `/dentists/...`) and `/search` links |
| **🎯 Filters** (on the Vitals list, before any profile is opened) | | |
| `gender` | Select | Any / Female / Male. Default: any |
| `minRating` | Select | Any, 1-5 stars & up, 4.5 & up. Default: any |
| `minReviewCount` | Integer | Minimum number of patient ratings. Default: 0 |
| `acceptingNewPatientsOnly` | Boolean | Only doctors accepting new patients. Default: false |
| `telehealthOnly` | Boolean | Only doctors offering virtual visits. Default: false |
| `minYearsExperience` / `maxYearsExperience` | Integer | Years in practice window. 0 = no limit |
| `languages` | List | Speaks any of, e.g. "Spanish" |
| `nameContains` | List | Name contains, e.g. "Patel" |
| `excludeSponsored` | Boolean | Skip Vitals' paid (Sponsored) profiles. Default: false |
| **✂️ Refine results** (read on the profile) | | |
| `requirePhone` | Boolean | Drop doctors with no office phone |
| `acceptsMedicareOnly` / `acceptsMedicaidOnly` | Boolean | Profile says Medicare / Medicaid accepted |
| `insuranceContains` | List | Accepted plans contain e.g. "Aetna", "Blue Cross" |
| **➕ Extra data** | | |
| `includeDetails` | Boolean | Open each profile for the full row. Default: true. Off = list data only, much faster |
| `includeReviews` / `maxReviewsPerDoctor` | Boolean / Integer | Newest review texts, up to 10. Default: on, 10 |
| **🔁 Monitoring** | | |
| `monitorMode` / `monitorStoreName` | Boolean / Text | Deliver only doctors not delivered by earlier runs of this monitor. A doctor delivered earlier without profile details comes back once, with `monitorStatus` `details`, when a run reads profiles |
| **📦 Output** | | |
| `maxItems` | Integer | Total cap. Default 100, prefill 5, 0 = no limit |
| `maxItemsPerSearch` | Integer | Cap per specialty x location (and per link). 0 = off |
| `maxPagesPerSearch` | Integer | List pages per search (60-65 doctors each). 0 = as many as needed |
| `flattenForCsv` | Boolean | One flat line per doctor for spreadsheets |
| **⚙️ Advanced** | | |
| `proxyConfiguration` | Proxy | Leave as is |

#### Input JSON

```json
{
  "specialties": ["Cardiology", "Dermatology"],
  "locations": ["Houston, TX", "Dallas, TX"],
  "minRating": "4",
  "acceptingNewPatientsOnly": true,
  "maxItems": 500
}
```

#### Search a specialty in a "City, ST", a state or the whole country

A city search returns the doctors Vitals lists around that city (its own radius, so suburbs are included and every row carries `distanceMiles`). A state code returns every doctor of that specialty in the state, and an empty location the whole country. **Do:** `"Saint Louis, MO"`, `"St. Louis, MO"`, `"MO"` · **Don't:** `"63101"` or `"Missouri, USA"` (a ZIP or a country is not read; the input is listed as skipped in the run summary).

#### Paste vitals.com links when you already have the page

Any vitals.com specialty page works as is, including its `?page=` number. A doctor's profile link returns that one doctor. A `vitals.com/search?...` link is read as its specialty (`sid`) and `city_state`, with its gender and rating filters applied; a search link without a specialty is skipped and listed in the run summary.

#### Turn profile details off for a fast phone list

With **Profile details** on, every doctor costs one extra page (30-40 doctors a minute). Off, a run reads 60-65 doctors per page and returns name, NPI, phone, city, specialty, rating, years and languages from the list alone. The price per doctor is the same either way.

### ⬆️ Output

One dataset item per doctor. A real row from the test run (offices, education, reviews shortened):

```json
{
  "npi": "1740421189",
  "fullName": "Satjit Bhusri",
  "formattedName": "Dr Satjit Bhusri, MD",
  "primarySpecialty": "Cardiology",
  "phone": "(212) 752-3464",
  "locationName": "Upper East Side Cardiology & Vein Institute",
  "address": "45 East End Ave #1S",
  "city": "New York", "state": "NY", "zip": "10028",
  "latitude": 40.77728, "longitude": -73.95396,
  "ratingScore": 4.97, "numberOfRatings": 378, "reviewCount": 342,
  "yearsOfExperience": 23,
  "medicalSchool": "Yale", "residency": "Lenox Hill Hospital",
  "licenses": [{ "type": "Medical Doctor", "state": "New York", "expiryDate": "2026-01-31", "status": "Expired" }],
  "acceptsNewPatients": true, "acceptsMedicare": false,
  "languages": ["English", "Spanish"],
  "insurances": ["Capital BlueCross", "Empire Blue Cross Blue Shield (BCBS)", "..."],
  "reviews": [{ "reviewId": "44538577", "rating": 5, "text": "Dr. Bhursi was very thorough and helped me through a very scary period of recovery...", "date": "2026-09-16", "helpfulCount": 2 }],
  "profileUrl": "https://www.vitals.com/doctors/satjit-bhusri-ms507s",
  "npiRegistryUrl": "https://npiregistry.cms.hhs.gov/provider-view/1740421189",
  "detailsFetched": true
}
```

#### Fields

Fill = share of rows with a value on the two 100-doctor test runs (Family Medicine in Houston, TX / Dentists in Chicago, IL), details on.

| Field | What it is | Fill |
|---|---|---|
| `npi` | National Provider Identifier (10 digits) | 100% / 99% |
| `fullName` | Name without the Dr prefix | 100% / 100% |
| `formattedName` | Name as Vitals shows it, with prefix and degrees | 100% / 100% |
| `degrees` | Degrees (MD, DO, DDS, ...) | 91% / 47% |
| `gender` | M or F as Vitals shows it | 97% / 94% |
| `providerType` | doctor or dentist | 100% / 100% |
| `profileType` | Basic, Enhanced or Sponsored (the listing tier Vitals shows) | 100% / 100% |
| `primarySpecialty` | Primary specialty | 100% / 100% |
| `specialties` | All specialties on the profile | 100% / 100% |
| `jobTitle` | Specialty description from the list card | 94% / 96% |
| `expertise` | Areas of expertise listed on the profile | 89% / 100% |
| `phone` | Office phone, formatted (XXX) XXX-XXXX: the main office's own line, else its tracking line | 96% / 80% |
| `practiceName` | Practice name of the main office | 87% / 83% |
| `locationName` | Office (location) name of the main office | 93% / 71% |
| `address` | Street address of the main office | 94% / 98% |
| `city` | City of the main office (the list card's city when details are off) | 100% / 100% |
| `state` | State code | 100% / 100% |
| `zip` | ZIP code of the main office | 100% / 100% |
| `latitude` | Latitude of the main office | 94% / 98% |
| `longitude` | Longitude of the main office | 94% / 98% |
| `website` | Doctor or practice website when Vitals lists one | 29% / 2% |
| `offices` | Every office: names, address, ZIP, phone, tracking line, website, GPS, primary flag, new patients / Medicare / Medicaid, hours, practice page | 100% / 100% |
| `distanceMiles` | Miles from the searched city's centre (city searches only) | 100% / 100% |
| `ratingScore` | Precise average rating (e.g. 4.97) | 100% / 100% |
| `numberOfRatings` | Number of patient ratings | 100% / 100% |
| `reviewCount` | Number of written reviews | 100% / 100% |
| `vitalsScore` | Vitals physician score shown on the profile | 100% / 100% |
| `avgWaitTimeMinutes` | Average reported wait time in minutes | 89% / 50% |
| `ratingsByStar` | Ratings per star (5 to 1) | 100% / 100% |
| `patientFeedback` | Patient feedback tallies: question, didWell, needsImprovement | 89% / 87% |
| `patientPerspective` | Strengths patients mention most, as Vitals summarises them | 88% / 82% |
| `reviewSummary` | Vitals' written summary of the patient reviews (when the profile has one) | 19% / 0% |
| `reviewSnippet` | Short patient review quoted on the list card | 87% / 66% |
| `yearsOfExperience` | Years in practice | 81% / 10% |
| `education` | Education entries: type, institution, year | 96% / 10% |
| `medicalSchool` | First medical (or dental) school listed | 90% / 10% |
| `residency` | First residency listed | 56% / 1% |
| `fellowship` | First fellowship listed | 2% / 0% |
| `licenses` | State licences: type, state, expiry date, status | 86% / 80% |
| `certifications` | Board certifications: issuer, type, year | 31% / 0% |
| `awards` | Vitals awards: title, year, description | 16% / 0% |
| `acceptsNewPatients` | True if at least one office accepts new patients, false if none does | 100% / 100% |
| `telehealth` | True when the doctor offers virtual visits on Vitals; null when not stated | 29% / 2% |
| `appointmentUrl` | Online appointment link | 24% / 2% |
| `languages` | Languages spoken | 92% / 15% |
| `insurances` | Insurance plans accepted, as listed on the profile | 74% / 41% |
| `acceptsMedicare` | Profile says the doctor accepts Medicare | 100% / 100% |
| `acceptsMedicaid` | Profile says the doctor accepts Medicaid | 100% / 100% |
| `hospitals` | Hospital affiliations: name, Vitals page | 70% / 8% |
| `bio` | Profile biography | 100% / 100% |
| `photoUrl` | Profile photo URL | 100% / 100% |
| `videoUrl` | Profile video URL | 22% / 2% |
| `reviews` | Newest written reviews (up to 10): id, rating, text, date, updated date, helpful votes | 100% / 75% |
| `profileUrl` | Vitals profile URL | 100% / 100% |
| `providerId`, `intId`, `vitalsGuid`, `entityId` | Vitals ids (provider id is unique per doctor) | 100% / 100% |
| `firstName`, `middleName`, `lastName`, `prefix` | Name parts | first/last 100% |
| `rating`, `isSponsored`, `officeCount`, `totalAwards`, `displayType`, `telehealthUrl`, `npiRegistryUrl` | Rounded stars, paid-profile flag, counts, links | see JSON |
| `searchSpecialty`, `searchLocation`, `sourceUrl`, `detailsFetched`, `scrapedAt` | Which search found the doctor, and when | 100% |

Not on Vitals, so not in the row: email addresses and fax numbers (every fax field we sampled was empty). To find emails, run the `website` column through [Website Contact Scraper](https://apify.com/scrapersdelight/website-contact-scraper).

### How can I use Vitals.com doctor data?

- 💊 **Medical-device and pharma sales:** build territory lists of specialists with NPI, office phone, address and hospital affiliations.
- 🧑‍⚕️ **Healthcare recruiting:** source physicians by specialty, years in practice, languages and licence state.
- 📣 **Practice marketing and reputation:** benchmark ratings, review counts, wait times and recent review texts against nearby practices.
- 🗂️ **Provider directories and data enrichment:** match on NPI and add Vitals ratings, insurances and office hours to your own records.
- 🏥 **Network and insurance analysis:** map which doctors in an area accept Medicare, Medicaid or a given plan, and who takes new patients.
- 🔁 **New-doctor alerts:** schedule a monitor run weekly to get only doctors added since last time.

### How much does it cost to scrape Vitals.com?

**$0.0013 per doctor ($1.30 per 1,000).** No start fee and nothing else to pay: the price covers the run. Profile details and reviews cost nothing extra. You pay only for the doctors written to your dataset.

| Doctors | Price |
|---|---|
| 10 | $0.013 |
| 100 | $0.13 |
| 1,000 | $1.30 |
| 10,000 | $13.00 |

Apify's free plan includes $5 of monthly credit - about 3,800 doctors at this price.

### Integrations, API, scheduling & MCP

- **Schedule** any search daily or weekly; with **Monitor mode** each run returns only new doctors.
- **Webhooks** fire when a run finishes; **Make, Zapier, n8n, Google Sheets, Slack** and the other Apify integrations take the dataset straight from there.
- **API:** start runs and read results with the [Apify API](https://docs.apify.com/api/v2) or the `apify-client` packages for [Python](https://docs.apify.com/api/client/python) and [JavaScript](https://docs.apify.com/api/client/js).
- **MCP:** AI agents (Claude, Cursor and other MCP clients) can run Vitals.com Doctor Scraper through the [Apify MCP server](https://mcp.apify.com).

### More doctor-directory scrapers

| Actor | Use it when |
|---|---|
| 🩺 [Healthgrades Scraper](https://apify.com/scrapersdelight/healthgrades-scraper) | you want Healthgrades' provider directory and reviews |
| ⭐ [RateMDs Scraper](https://apify.com/scrapersdelight/ratemds-scraper) | you need RateMDs ratings and reviews (US and Canada) |
| 📅 [Zocdoc Scraper](https://apify.com/scrapersdelight/zocdoc-scraper) | you have Zocdoc profile links and want insurance and booking data |
| 🆔 [NPI Registry Scraper](https://apify.com/scrapersdelight/npi-registry-scraper) | you need the official NPPES record for a list of NPIs or names |
| 🗃️ [NPPES NPI Bulk Scraper](https://apify.com/scrapersdelight/nppes-provider-scraper) | you need every registered provider by specialty and state |
| ✉️ [Website Contact Scraper](https://apify.com/scrapersdelight/website-contact-scraper) | you want emails from the practice websites in the `website` column |

### Limits & empty runs

- **Reviews:** the profile page shows the 10 newest written reviews; older ones are not read. Review counts and the star histogram cover all reviews.
- **Name search** works inside a specialty and location (`nameContains`); Vitals' site-wide name search is not used. For a known doctor, paste the profile link.
- **Order** is Vitals' own best-match order; Vitals' sort options do not apply to its specialty pages.
- **Very large nationwide lists** are served only to a fixed depth (nationwide cardiology: about 16,000 of 63,870 doctors); the run stops at that point and says so in the run summary. Search state by state to cover the rest - city and state lists were served in full in our tests (13,361 dentists around New York City).
- **Speed:** with profile details about 30-40 doctors a minute (100 doctors in 2.5 minutes; 1,000 Texas internists in 35 minutes in our tests). The actor paces itself to Vitals' rate limit and slows down if Vitals asks it to; list-only runs read 60-65 doctors per page.
- **Profile not readable:** if a profile page cannot be loaded, the doctor is still delivered from the list data with `detailsFetched: false` (name, NPI, phone, city, rating).
- **Empty runs:** you pay only for doctors written to the dataset. A search whose filters match nobody stops after 20 list pages in a row without a match; raise **Max list pages per search** to read further. A city Vitals does not know is reported in the run summary (`RUN_SUMMARY` in the key-value store) with the closest names it lists.

### FAQ

#### How much does Vitals.com Doctor Scraper cost?

$0.0013 per doctor saved to the dataset, with no start fee. Profile details and reviews are included in that price. 1,000 doctors cost $1.30.

#### How many doctors can Vitals.com Doctor Scraper return?

As many as Vitals lists: around 3,000 for a big-city specialty, 6,000 for a large state and over 60,000 nationwide for a common specialty. Set **Max doctors** to cap a run.

#### Does Vitals.com Doctor Scraper return the NPI number?

Yes, on 99-100% of doctors in our tests. When Vitals shows no NPI the field is empty rather than a placeholder.

#### Can Vitals.com Doctor Scraper get patient reviews?

Yes: the 10 newest written reviews on each profile with star rating, date and helpful votes, plus the rating histogram and Vitals' review summary. Reviewer names are not shown by Vitals, so they are not in the data.

#### Does it find emails?

Vitals does not publish doctor emails. Use the `website` column with our Website Contact Scraper to look for practice emails.

#### Can I schedule Vitals.com Doctor Scraper and get only new doctors?

Yes. Turn on **Only new doctors (monitor)** and schedule the run; each run delivers only doctors this monitor has not delivered before.

#### Can I use Vitals.com Doctor Scraper with the Apify API or Python?

Yes. Start it with the Apify API or the `apify-client` package for Python or JavaScript and read the dataset when the run finishes.

#### Can AI agents use Vitals.com Doctor Scraper through MCP?

Yes, through the Apify MCP server. Give the agent a specialty, a location and a cap.

#### Do I need a Vitals account, cookies or an API key?

No. The actor reads the public Vitals.com pages any visitor sees.

#### Why did my Vitals.com Doctor Scraper run return no doctors?

Usually the filters matched nobody, the city name is not one Vitals uses, or the specialty has no Vitals list. The run summary lists every skipped input and the reason.

#### Does it cover dentists, podiatrists and optometrists?

Yes - search "Dentist", "Podiatrist" or "Optometrist", or paste their vitals.com profile links.

### Disclaimer

This actor is not affiliated with, endorsed by or connected to Vitals.com, WebMD or Internet Brands.

### Your feedback

Found a bug or missing a field? Open an issue on the actor's **Issues** tab and we will look at it.

# Actor input Schema

## `specialties` (type: `array`):

One or more specialties, in everyday words: "Cardiology", "Family Medicine", "Dentist", "Dermatologist", "OB-GYN". Any Vitals specialty works (e.g. "Anesthesiology"). Each specialty is searched in every location below.

## `locations` (type: `array`):

"City, ST" (e.g. "Houston, TX", "St. Louis, MO") for a city and its area, or a state ("TX", "California") for the whole state. Leave empty to search nationwide.

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

Optional. Specialty pages (vitals.com/cardiology/ny/new-york, /dermatology/ca, /pediatrics, ?page=N honoured), doctor profiles (vitals.com/doctors/{name-id}, /dentists/...) and vitals.com/search links (read as the matching specialty + city).

## `gender` (type: `string`):

Keep only doctors of this gender. Doctors whose gender Vitals does not show are dropped when a gender is picked.

## `minRating` (type: `string`):

Keep doctors rated at least this many stars (Vitals' average patient rating). Unrated doctors are dropped when a floor is set.

## `minReviewCount` (type: `integer`):

Keep doctors with at least this many patient ratings. 0 keeps everyone.

## `acceptingNewPatientsOnly` (type: `boolean`):

Keep only doctors Vitals marks as accepting new patients at one or more offices.

## `telehealthOnly` (type: `boolean`):

Keep only doctors who offer virtual visits on Vitals.

## `minYearsExperience` (type: `integer`):

Keep doctors with at least this many years in practice. 0 = no floor. Doctors without a stated figure are dropped when a floor is set.

## `maxYearsExperience` (type: `integer`):

Keep doctors with at most this many years in practice. 0 = no ceiling.

## `languages` (type: `array`):

Keep doctors who speak one of these languages, e.g. "Spanish", "Mandarin". Empty keeps everyone.

## `nameContains` (type: `array`):

Keep doctors whose name contains one of these words, e.g. "Patel". Works inside the specialty and location you search.

## `excludeSponsored` (type: `boolean`):

Vitals places some paid ("Sponsored") profiles in its lists. Turn on to keep only the others.

## `requirePhone` (type: `boolean`):

Drop doctors with no office phone on Vitals.

## `acceptsMedicareOnly` (type: `boolean`):

Keep only doctors whose Vitals profile says they accept Medicare. Reads the profile, so profile details turn on.

## `acceptsMedicaidOnly` (type: `boolean`):

Keep only doctors whose Vitals profile says they accept Medicaid. Reads the profile, so profile details turn on.

## `insuranceContains` (type: `array`):

Keep doctors whose accepted-insurance list contains one of these words, e.g. "Aetna", "Cigna", "Blue Cross". Reads the profile.

## `includeDetails` (type: `boolean`):

ON: opens each doctor's profile for full office address, ZIP, GPS, every office with hours, education, licences, certifications, hospitals, insurances, Medicare/Medicaid and the rating breakdown. OFF: list data only (name, NPI, phone, city, rating) - about 40x fewer page loads.

## `includeReviews` (type: `boolean`):

Adds the newest written reviews shown on the profile (text, star rating, date, helpful votes). Needs profile details.

## `maxReviewsPerDoctor` (type: `integer`):

How many of the newest reviews to keep per doctor. The profile page shows up to 10.

## `monitorMode` (type: `boolean`):

Deliver only doctors this monitor has not delivered in earlier runs. Pairs with a daily or weekly schedule. Doctors filtered out are re-checked next run.

## `monitorStoreName` (type: `string`):

Name of the key-value store that remembers delivered doctors. Use a different name for each list you watch.

## `maxItems` (type: `integer`):

Stop after this many doctors in total (across all searches and links). 0 = no limit. A big-city specialty can list 3,000+ doctors and a state 6,000+.

## `maxItemsPerSearch` (type: `integer`):

Cap for each specialty x location (and each link). 0 = only the total cap applies.

## `maxPagesPerSearch` (type: `integer`):

Vitals shows 60 doctors per city page and 65 per state or nationwide page. 0 = as many pages as the caps need; a search whose filters match nothing for 20 pages in a row stops on its own.

## `flattenForCsv` (type: `boolean`):

Turns lists into text (languages joined with "; ", offices, education and reviews as JSON text) so every row is one flat line.

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

Leave as is. The actor reads Vitals directly, switches to a US residential proxy by itself if Vitals refuses the connection, and uses Apify's Unblocker for list pages only as a last resort. Bring your own proxy URLs only if you have them.

## Actor input object example

```json
{
  "specialties": [
    "Cardiology"
  ],
  "locations": [
    "New York, NY"
  ],
  "gender": "any",
  "minRating": "0",
  "minReviewCount": 0,
  "acceptingNewPatientsOnly": false,
  "telehealthOnly": false,
  "minYearsExperience": 0,
  "maxYearsExperience": 0,
  "excludeSponsored": false,
  "requirePhone": false,
  "acceptsMedicareOnly": false,
  "acceptsMedicaidOnly": false,
  "includeDetails": true,
  "includeReviews": true,
  "maxReviewsPerDoctor": 10,
  "monitorMode": false,
  "monitorStoreName": "vitals-doctor-monitor",
  "maxItems": 5,
  "maxItemsPerSearch": 0,
  "maxPagesPerSearch": 0,
  "flattenForCsv": false,
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}
```

# Actor output Schema

## `doctors` (type: `string`):

One item per doctor or dentist found on Vitals.com.

## `summary` (type: `string`):

Per-search counts (listed, delivered, filtered, duplicates), not-found and skipped inputs, and why the run stopped.

# 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 = {
    "specialties": [
        "Cardiology"
    ],
    "locations": [
        "New York, NY"
    ],
    "maxItems": 5
};

// Run the Actor and wait for it to finish
const run = await client.actor("scrapersdelight/vitals-doctor-scraper").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 = {
    "specialties": ["Cardiology"],
    "locations": ["New York, NY"],
    "maxItems": 5,
}

# Run the Actor and wait for it to finish
run = client.actor("scrapersdelight/vitals-doctor-scraper").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 '{
  "specialties": [
    "Cardiology"
  ],
  "locations": [
    "New York, NY"
  ],
  "maxItems": 5
}' |
apify call scrapersdelight/vitals-doctor-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,scrapersdelight/vitals-doctor-scraper"
        }
    }
}
```

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/7mxHfuMbRJUaAcxtn/builds/3aKmOaBYciE9L4zCJ/openapi.json
