NPPES NPI Registry Scraper

Search and extract US healthcare provider data from the National Plan and Provider Enumeration System (NPPES) — the official CMS federal database containing 7 million+ active NPI registrations for physicians, nurses, dentists, hospitals, clinics, and other healthcare providers.

What It Does

This actor queries the public NPPES API (no authentication required) to retrieve structured provider records including:

• Full name, credentials, and gender
• Medical specialty / taxonomy
• Practice address, city, state, ZIP, and phone
• License number and issuing state
• NPI number and enrollment date

Input Parameters

Field	Type	Description
mode	select	searchProviders, byNpiNumbers, or searchOrganizations
lastName	string	Provider last name (partial match)
firstName	string	Provider first name (partial match)
taxonomyDescription	string	Specialty (e.g. Cardiology, Family Medicine, Dentistry)
state	select	US state abbreviation (NY, CA, TX, etc.)
city	string	City name filter
postalCode	string	ZIP code filter
gender	select	M or F (individual providers only)
npiNumbers	array	10-digit NPI numbers for direct lookup (mode=byNpiNumbers)
organizationName	string	Organization name search (mode=searchOrganizations)
maxItems	integer	Maximum records to return (default 50, max 1200)

Output Fields

Each record includes:

{
  "npi": "1234567890",
  "providerType": "Individual",
  "fullName": "John A Smith",
  "firstName": "John",
  "lastName": "Smith",
  "credential": "MD",
  "gender": "Male",
  "primaryTaxonomy": "Internal Medicine",
  "taxonomyCode": "207R00000X",
  "licenseNumber": "123456",
  "licenseState": "NY",
  "address1": "123 Main St",
  "city": "New York",
  "state": "NY",
  "postalCode": "10001",
  "telephone": "212-555-1234",
  "status": "A",
  "enumerationDate": "2005-03-15",
  "lastUpdated": "2024-01-10",
  "sourceUrl": "https://npiregistry.cms.hhs.gov/provider-view/1234567890",
  "recordType": "provider",
  "scrapedAt": "2026-06-02T12:00:00+00:00"
}

Example Use Cases

• Provider directory enrichment — Build or enrich a database of local physicians
• Specialty networks — Find all cardiologists in a given state
• Credentialing research — Verify provider NPI, credentials, and license numbers
• Competitive analysis — Map healthcare providers by ZIP code or city

Data Source

Data comes directly from the NPPES NPI Registry API (npiregistry.cms.hhs.gov) — a public federal database maintained by the Centers for Medicare & Medicaid Services (CMS). No authentication, proxy, or cookies required. Updated daily by CMS.

Frequently Asked Questions

Is this data free to use? Yes. The NPPES registry is a public federal database. The data is in the public domain.

How many providers are in the database? Over 7 million active NPIs covering all 50 US states plus territories.

Can I search by specialty? Yes — use the taxonomyDescription field. Examples: Cardiology, Family Medicine, Dentistry, Nurse Practitioner, Orthopedic Surgery, Psychiatry.

What is an NPI? A National Provider Identifier (NPI) is a unique 10-digit identification number issued by CMS to healthcare providers and organizations. It is required for Medicare/Medicaid billing.

Does this include hospital systems? Yes — use mode=searchOrganizations to search hospitals, clinics, labs, and other healthcare organizations.