NPI Registry Scraper

Search and extract US healthcare provider data from the CMS NPI Registry — the official federal database of all licensed healthcare providers in the United States.

What is the NPI Registry?

The National Provider Identifier (NPI) Registry is maintained by the Centers for Medicare & Medicaid Services (CMS). It contains over 8 million healthcare providers — doctors, nurses, hospitals, pharmacies, and other organizations — all registered under the U.S. HIPAA system.

What does this scraper extract?

Each record includes:

Field	Description
npi	10-digit National Provider Identifier
entityType	individual or organization
firstName	Provider first name (individuals)
lastName	Provider last name (individuals)
organizationName	Organization name (organizations)
credential	Professional credential, e.g., MD, DO, NP
gender	M / F (individuals)
primarySpecialty	Primary taxonomy / specialty
specialties	All specialties (list)
practiceAddress	Practice street address
practiceCity	Practice city
practiceState	Practice state (2-letter code)
practiceZip	Practice ZIP code
practicePhone	Practice phone number
mailingAddress	Mailing street address
mailingCity	Mailing city
mailingState	Mailing state
enumerationDate	Date NPI was issued
certificationDate	Last certification / update date
status	A = Active, D = Deactivated
url	Direct NPI Registry profile URL
scrapedAt	Extraction timestamp (ISO 8601)

Modes

1. Search providers (searchProviders) — Default

Search by provider name and/or state. Works for individual healthcare providers.

Input:

{
  "mode": "searchProviders",
  "firstName": "John",
  "lastName": "Smith",
  "state": "CA",
  "maxItems": 50
}

2. Lookup by NPI number (lookupByNPI)

Fetch the exact record for a known NPI number.

Input:

{
  "mode": "lookupByNPI",
  "npiNumber": "1234567890"
}

3. Search by specialty (searchBySpecialty)

Filter providers by taxonomy description or medical specialty.

Input:

{
  "mode": "searchBySpecialty",
  "specialtyDescription": "Cardiology",
  "state": "NY",
  "maxItems": 100
}

4. Search organizations (searchByOrganization)

Search for hospitals, clinics, group practices, pharmacies, etc.

Input:

{
  "mode": "searchByOrganization",
  "organizationName": "Mayo Clinic",
  "state": "MN"
}

Sample Output

{
  "npi": "1234567890",
  "entityType": "individual",
  "firstName": "John",
  "lastName": "Smith",
  "credential": "MD",
  "gender": "M",
  "primarySpecialty": "Internal Medicine",
  "specialties": ["Internal Medicine"],
  "practiceAddress": "123 Medical Center Dr",
  "practiceCity": "Los Angeles",
  "practiceState": "CA",
  "practiceZip": "90001",
  "practicePhone": "310-555-0100",
  "enumerationDate": "2005-06-15",
  "certificationDate": "2024-01-01",
  "status": "A",
  "url": "https://npiregistry.cms.hhs.gov/provider-view/1234567890",
  "scrapedAt": "2026-05-23T10:00:00+00:00"
}

Use Cases

• Lead generation for healthcare — Find doctors, specialists, or organizations by state and specialty
• Provider directories — Build or update healthcare provider databases
• Credentialing — Verify provider NPI numbers and license information
• Healthcare analytics — Analyze provider distribution by specialty, state, or city
• Medical billing — Validate NPI numbers for insurance claims processing
• Research — Study provider demographics and specialty distribution

Filters Available

Filter	Applies to modes
firstName	searchProviders, searchBySpecialty
lastName	searchProviders, searchBySpecialty
organizationName	searchByOrganization
state	All except lookupByNPI
city	All except lookupByNPI
postalCode	All except lookupByNPI
specialtyDescription	searchBySpecialty

Data Source

The NPI Registry is a free public API maintained by CMS (Centers for Medicare & Medicaid Services). No API key, login, or proxy is required.

API documentation: https://npiregistry.cms.hhs.gov/api-page

FAQs

Q: Is this data free to use? A: Yes. The NPI Registry is a public U.S. government database. Data is freely available under government open data policies.

Q: How many providers are in the registry? A: Over 8 million individual providers and organizations are registered.

Q: What is an NPI number? A: A National Provider Identifier (NPI) is a unique 10-digit identification number issued to healthcare providers in the U.S. It is required for all HIPAA-covered healthcare transactions.

Q: Can I search for hospitals and clinics? A: Yes. Use mode=searchByOrganization to search for organizations, hospitals, group practices, pharmacies, and other health entities.

Q: What specialties can I search? A: The NPI registry uses NUCC taxonomy codes. Common specialties: Internal Medicine, Family Practice, Cardiology, Pediatrics, Dermatology, Orthopedic Surgery, and 600+ more.

Q: Why might some fields be absent? A: Not all providers complete every field. Older registrations may lack credentials, phone numbers, or mailing addresses.

Q: How current is the data? A: The NPI Registry is updated weekly by CMS with new registrations and address changes.

Q: Can I search by ZIP code? A: Yes. Use the postalCode input field with any 5-digit US ZIP code.