Pricing

Rating

Developer

Actor stats

Categories

Share

NPPES NPI Registry Lookup & Healthcare Provider Crawler

Run bulk NPI lookup and NPI number search across the CMS NPPES NPI Registry, the official federal database of 2.5M+ National Provider Identifiers. Extract healthcare provider records into a structured dataset: NPI numbers, names, credentials, specialties, taxonomy codes, practice addresses, phone numbers, license information, and gender for individual providers and healthcare organizations across all 50 US states. Use it as a programmatic NPI registry search or to build a healthcare provider directory.

Features

• Queries the official CMS NPPES REST API (v2.1) for structured JSON data -- no HTML scraping
• Filter by state, specialty/taxonomy code, city, ZIP code, provider type, or provider name
• Returns 25+ fields per record including practice and mailing addresses with formatted phone numbers
• Supports both individual providers (NPI-1: doctors, nurses, therapists) and organizations (NPI-2: hospitals, clinics, labs)
• State-only searches automatically enumerate through name prefixes to work around the API's minimum-criteria requirement
• No proxy required -- the NPPES API is a free, open government service with no authentication or rate limiting

Who Uses This NPI Lookup & Provider Directory Data?

• Pharma sales teams -- Build targeted call lists of physicians by specialty and geography
• Medical device companies -- Identify orthopedic surgeons, radiologists, or other specialists in target markets
• Healthcare SaaS platforms -- Enrich provider directories with verified NPI numbers and taxonomy codes
• Insurance companies -- Validate provider credentials and network participation
• Market researchers -- Analyze provider density, specialty distribution, and practice patterns by region
• Recruiting firms -- Find healthcare professionals by specialty, location, and credential type

How It Works

1. Configure filters -- Select states, specialties, cities, or ZIP codes. Combine filters to narrow results.
2. API queries -- The crawler builds optimized queries against the CMS NPPES API, paginating through results in batches of 200.
3. Data transformation -- Raw API responses are normalized: phone numbers formatted as (XXX) XXX-XXXX, ZIP codes hyphenated, taxonomy codes mapped to human-readable descriptions.
4. Export -- Clean JSON records land in your Apify dataset. Set maxItems to control volume.

Input

Search by state and specialty

{
"states":["AZ"],
"taxonomyCode":"207R00000X",
"maxItems":100
}

Search by ZIP code

{
"zip":"85016",
"maxItems":50
}

Search by city and state

{
"states":["WY"],
"city":"Cheyenne",
"maxItems":100
}

Search by provider name

{
"states":["CA"],
"lastName":"Smith",
"providerType":"NPI-1",
"maxItems":50
}

Search organizations only

{
"states":["TX"],
"providerType":"NPI-2",
"taxonomyCode":"261QM1300X",
"maxItems":100
}

Search Criteria Rules

The NPPES API requires at least two search criteria. A state alone is not sufficient. Valid combinations:

• State + specialty (taxonomyCode)
• State + city
• State + last name or organization name
• ZIP code alone
• State alone (the crawler auto-generates name prefix queries to satisfy the API requirement)

Output Fields

{
"npi":"1234567890",
"provider_type":"NPI-1",
"first_name":"JANE",
"last_name":"SMITH",
"credential":"MD",
"organization_name":"",
"taxonomy_code":"207R00000X",
"taxonomy_description":"Internal Medicine",
"specialty":"Internal Medicine",
"license_number":"MD12345",
"license_state":"AZ",
"address_practice":"1234 E CAMELBACK RD",
"city_practice":"PHOENIX",
"state_practice":"AZ",
"zip_practice":"85016-2345",
"phone_practice":"(602) 555-0100",
"fax_practice":"(602) 555-0101",
"address_mailing":"PO BOX 1234",
"city_mailing":"PHOENIX",
"state_mailing":"AZ",
"zip_mailing":"85001-1234",
"phone_mailing":"(602) 555-0100",
"gender":"F",
"sole_proprietor":"NO",
"enumeration_date":"2005-06-15",
"last_update_date":"2024-01-20",
"other_identifiers":["MEDICAID: 123456: (AZ)"]
}

Supported Taxonomy Codes

The taxonomy dropdown includes the most common healthcare provider specialties:

You can also enter any valid NUCC taxonomy code not listed in the dropdown by using the API directly.

Performance

• Speed: ~200 records per second. A 100-record run completes in under 5 seconds.
• Memory: 256 MB default. Sufficient for runs of any size since data streams through in batches.
• No proxy cost: The NPPES API is a free government service. No Apify proxy credits are consumed.
• Pricing: Pay-per-event at $0.001 per record ($1 per 1,000 records) plus $0.10 per actor start.

Data Source

All data comes from the CMS National Plan & Provider Enumeration System (NPPES), maintained by the Centers for Medicare & Medicaid Services (CMS), a division of the U.S. Department of Health and Human Services. The NPPES NPI Registry is updated continuously as providers create or modify their records. The database contains 2.5M+ active NPI records.

FAQ

How do I look up an NPI number?

Set a search filter — a last name, organization name, ZIP code, or state plus specialty — and run the actor. It queries the official CMS NPPES NPI Registry and returns matching provider records with the 10-digit NPI number for each. For a single provider, enter the lastName (individuals) or organizationName (organizations) along with a state.

Can I download the NPI registry database in bulk?

Yes. Use the states and taxonomyCode filters to pull every provider matching a specialty and geography, then raise maxItems to control how many records land in the dataset. Each NPI registry search exports clean JSON to your Apify dataset, which you can download as JSON, CSV, or Excel.

What's the difference between an NPI-1 and NPI-2 lookup?

NPI-1 returns individual providers (doctors, nurses, therapists); NPI-2 returns organizations (hospitals, clinics, labs). Set the providerType filter to restrict the search to one type, or leave it empty to return both.