Vitals.com Physician Scraper

Extract comprehensive physician profiles and ratings from Vitals.com with detailed provider information including credentials, education, certifications, accepted insurance, patient ratings, and practice locations. Designed for healthcare market research, provider directory building, and patient analytics.

Features

• Complete Provider Profiles - Names, specialties, education history, board certifications, and licenses
• Patient Ratings & Reviews - Rating scores, review counts, rating distribution, and patient feedback summaries
• Insurance Information - Accepted insurance plans, Medicare and Medicaid acceptance status
• Practice Details - Office locations, phone numbers, languages spoken, and new patient acceptance
• Advanced Filtering - Search by medical specialty, geographic location, or direct profile URLs
• Automatic Pagination - Collects results across multiple pages automatically
• Duplicate Prevention - Built-in deduplication by unique provider identifier

Use Cases

Healthcare Market Research

Analyze physician distribution, specialization trends, and geographic availability across the United States. Build comprehensive provider databases for healthcare intelligence platforms.

Provider Network Management

Verify and update in-network physician databases with current insurance acceptance data, practice locations, and contact information.

Recruitment & Staffing

Identify specialists in specific fields and locations with complete credential information for clinical staffing and partnership opportunities.

Patient Research Tools

Enable patients to compare healthcare providers using ratings, reviews, accepted insurance, and verified credentials.

---

Input Parameters

Parameter	Type	Required	Default	Description
specialty	String	No	Cardiovascular Disease	Medical specialty or field (e.g., Cardiology, Dermatology)
location	String	No	-	City, state, or region to search (e.g., "New York", "California")
startUrl	String	No	-	Direct vitals.com URL that overrides specialty/location parameters
results_wanted	Integer	No	20	Maximum number of physician profiles to collect (1-500)
max_pages	Integer	No	5	Maximum listing pages to process
collectDetails	Boolean	No	true	When enabled, fetches full profile pages for complete data
proxyConfiguration	Object	No	-	Proxy settings for reliable data collection

---

Output Data

Each physician record contains the following fields:

Field	Type	Description
providerid	String	Unique provider identifier
npi	String	National Provider Identifier number
name	String	Full physician name
firstname	String	Physician first name
lastname	String	Physician last name
suffix	String	Name suffix (Dr., MD, etc.)
gender	String	Physician gender
specialty	String	Primary medical specialty
specialties	String	All associated specialties
location	String	Practice location (city, state)
city	String	Practice city
state	String	Practice state
postalcode	String	ZIP code
geolocation	String	Latitude and longitude coordinates
profileurl	String	Link to vitals.com profile
rating	Number	Average patient rating (0-5)
schema_rating	Number	Schema.org rating score
review_count	Number	Total number of patient reviews
number_of_ratings	Number	Total rating count
years_of_experience	Number	Years in practice
total_awards	Number	Number of awards received
accepts_new_patients	Boolean	Accepting new patients
languages	String	Languages spoken
photourl	String	Profile photo URL
degreeabbr	String	Degree abbreviations
education	String	Medical education and training history
certifications	String	Board certifications
licenses	String	Active state medical licenses
insurance_accepted	String	Accepted insurance plans
is_medicare	Boolean	Accepts Medicare
is_medicaid	Boolean	Accepts Medicaid
bio	String	Physician biography
awards	String	Award details
job_title	String	Professional job title
display_type	String	Provider display category
type	String	Provider type

---

Usage Examples

Basic Search by Specialty

{
    "specialty": "Cardiology",
    "results_wanted": 25
}

Search with Location Filter

{
    "specialty": "Dermatology",
    "location": "Florida",
    "results_wanted": 50,
    "collectDetails": true
}

Advanced Configuration

{
    "specialty": "Psychiatry",
    "location": "California",
    "results_wanted": 100,
    "max_pages": 5,
    "collectDetails": true,
    "proxyConfiguration": {
        "useApifyProxy": true,
        "apifyProxyGroups": ["RESIDENTIAL"]
    }
}

---

Sample Output

{
    "providerid": "1AB150C9-9D65-4B93-BDCE-3536D6523B01",
    "npi": "1336372010",
    "name": "Mershed Kareem Alsamara",
    "specialty": "Cardiovascular Disease",
    "specialties": "Cardiovascular Disease, Cardiologist",
    "location": "Richland, WA",
    "city": "Richland",
    "state": "WA",
    "rating": 5,
    "schema_rating": 4.97,
    "review_count": 706,
    "years_of_experience": 24,
    "education": "Providence Hospital (Fellowship) - 2016; Providence Hospital (Residency) - 2013",
    "licenses": "Washington - Medical Doctor - Active",
    "insurance_accepted": "Cigna PPO; Medicare; Medicaid",
    "is_medicare": true,
    "is_medicaid": true,
    "accepts_new_patients": true,
    "languages": "Arabic; English"
}

---

Tips for Best Results

Choose the Right Specialty

Use specific specialty names (Cardiology, Dermatology, Psychiatry) rather than generic terms. The actor supports 30+ medical specialties with automatic slug mapping.

Start with Location Filters

Applying a state or city filter narrows results and speeds up collection. For broad national searches, leave location empty.

Enable Full Profiles

Setting collectDetails to true fetches complete physician data including education history, board certifications, accepted insurance plans, and full biographies.

Use Residential Proxies

For large collections, residential proxies provide the best reliability and help avoid rate limiting.

---

Integrations

Connect your data with:

• Google Sheets - Export for analysis and reporting
• Airtable - Build searchable provider databases
• Make - Create automated healthcare workflows
• Zapier - Trigger actions based on new data

Export Formats

• JSON - For developers and APIs
• CSV - For spreadsheet analysis
• Excel - For business reporting

---

Frequently Asked Questions

How many physicians can I collect?

You can collect up to 500 profiles per run. For larger datasets, run multiple searches with different specialties or locations.

What data is included in full profiles?

Full profiles include education history, board certifications, state licenses, accepted insurance plans, patient ratings, review counts, awards, and biographies.

How are duplicates handled?

Each provider is identified by a unique provider ID. Duplicate entries are automatically removed, so you always get clean, unique data.

Can I search by insurance provider?

Yes, the output includes accepted insurance plans for each physician. Filter results by insurance provider after collection.

Why are some fields empty?

Some physicians may not have complete profile information on vitals.com. The actor extracts all available data and omits empty fields.

---

Support

For issues or feature requests, contact support through the Apify Console.

Resources

• Apify Documentation
• API Reference
• Scheduling Runs

---

Legal Notice

This actor extracts publicly available physician directory information. Users are responsible for ensuring compliance with website terms of service and applicable data collection regulations. Use data responsibly and respect rate limits.