Healthcare Provider Scraper: NPI, Hospitals & Clinics Data

Extract structured healthcare provider data from the official US National Provider Identifier (NPI) Registry. Search by name, specialty, location, or NPI number and get doctor names, credentials, specialties, addresses, phone numbers, and more.

What data can you get?

Field	Example
Provider name	John Smith, MD
Credentials	MD, DO, NP, PA, RN, DDS
Specialty	Cardiology, Orthopedic Surgery, Family Practice
NPI number	1234567890
Practice address	123 Medical Blvd, Boston, MA 02101
Phone	(555) 123-4567
Organization	Boston Medical Group
Status	Active / Inactive

Use cases

• Healthcare lead generation -- find providers by specialty and location for B2B outreach
• Market research -- analyze provider distribution across states, cities, or ZIP codes
• Provider verification -- look up NPI numbers for identity and credential verification
• Directory building -- bulk extract provider data for healthcare directories
• Competitive analysis -- map provider density by specialty in target markets

How to use

Search by location

{
  "searchType": "byLocation",
  "city": "Boston",
  "state": "MA",
  "maxResults": 100
}

Search by specialty

{
  "searchType": "bySpecialty",
  "specialty": "Cardiology",
  "state": "CA",
  "maxResults": 50
}

Search by name

{
  "searchType": "byName",
  "firstName": "John",
  "lastName": "Smith",
  "state": "NY"
}

Search by NPI number

{
  "searchType": "byNPI",
  "npi": "1234567890"
}

Input parameters

Parameter	Type	Required	Description
searchType	string	Yes	byName, bySpecialty, byLocation, or byNPI
firstName	string	No	Provider first name (for byName)
lastName	string	No	Provider last name (for byName)
specialty	string	No	Medical specialty (for bySpecialty)
city	string	No	City name (for byLocation)
state	string	No	US state abbreviation, e.g. CA, NY, TX
zipCode	string	No	ZIP code
npi	string	No	10-digit NPI number (for byNPI)
organizationType	string	No	Individual, Organization, or Both (default)
maxResults	integer	No	1-1000, default 100
includeInactiveProviders	boolean	No	Include deactivated providers (default: false)

Output example

{
  "npi": "1234567890",
  "providerType": "Individual",
  "namePrefix": "Dr.",
  "firstName": "John",
  "lastName": "Smith",
  "credential": "MD",
  "gender": "Male",
  "status": "Active",
  "lastUpdated": "2025-12-01",
  "taxonomy": {
    "code": "207RC0000X",
    "description": "Cardiovascular Disease",
    "isPrimary": true
  },
  "addresses": {
    "practice": {
      "line1": "123 Medical Blvd",
      "city": "Boston",
      "state": "MA",
      "zip": "02101",
      "phone": "555-123-4567"
    }
  }
}

Data source

This actor queries the NPI Registry maintained by the Centers for Medicare & Medicaid Services (CMS) -- the official, authoritative source for US healthcare provider data covering 3M+ licensed providers. No API keys required. Data is free and publicly available.

Cost of usage

This actor uses a pay-per-event pricing model:

• Actor start: $0.01 per run (per GB of memory)
• Per result: $0.002 per provider record

Example: scraping 100 providers costs approximately $0.21.

Limitations

• US healthcare providers only (NPI Registry is US-specific)
• Rate limiting is applied to respect the data source
• Maximum 1000 results per run
• Secondary data enrichment (Healthgrades, Zocdoc) is planned for future versions

Support

If you have questions or need help, open an issue on the actor's GitHub page or contact the author through Apify.