NPI Registry & Healthcare Provider Leads Scraper (NPPES)

Extract verified US healthcare providers, medical practices, dental clinics, mental health groups, pharmacies, and individual doctors/practitioners (NPI-1 and NPI-2) directly from the official CMS National Plan and Provider Enumeration System (NPPES) NPI Registry API v2.1.

Built for healthcare B2B sales teams, medical/dental device reps, healthcare SaaS founders, medical billing & RCM agencies, healthcare recruiters, and credentialing/KYB workflows.

---

Why Use This NPI Registry Scraper Over Raw API Calls?

1. Direct Decision-Maker Contacts (Authorized Official on NPI-2 Practices): Every NPI-2 organization record (dental clinics, medical groups, urgent care centers, dermatology practices, surgical centers, behavioral health clinics) includes the clinic's registered Authorized Official (authorizedOfficialName, authorizedOfficialTitle such as Owner, President, CEO, Medical Director, Managing Partner, and authorizedOfficialPhone).
2. Multi-Specialty & Multi-State Fan-Out with Automatic Deduplication: The raw CMS NPPES API only accepts a single state and a single taxonomy_description per request, and fails with Error 07 if you query a state without an additional criterion. This actor accepts arrays of specialties, states, cities, and postalCodes, fans out across all combinations automatically, handles state-only queries via ZIP-prefix slicing, and deduplicates by 10-digit NPI number.
3. Flattened, CRM-Ready Lead Schema: Raw NPPES responses nest practice locations, mailing addresses, primary vs. secondary NUCC taxonomy codes, state medical/dental licenses, DBA trade names, and endpoints across 7 separate sub-arrays. This actor flattens every record into clean top-level columns ready for HubSpot, Salesforce, Clay, Apollo, or CSV export while preserving the full arrays.
4. Built-In B2B Lead Quality Filters: Filter with requirePhone: true (skip records missing telephone numbers), requireAuthorizedOfficial: true (only return clinics with a named executive/owner), and activeOnly: true.

---

Extracted Fields

Field	Type	Description
npi	string	10-digit National Provider Identifier ("1063828648")
entityType	string	"Organization (NPI-2)" or "Individual (NPI-1)"
displayName	string	Cleaned practice/organization name or practitioner full name + credential
organizationName	string	Legal organization name (NPI-2)
dbaName	string	Doing-Business-As / trade name (other_names) when registered
firstName / lastName / credential	string	Practitioner name and credentials (MD, DO, DDS, DMD, NP, PA-C, etc.)
primarySpecialty	string	Primary NUCC specialty description (e.g., "Clinic/Center, Dental", "Dermatology")
primaryTaxonomyCode	string	Primary 10-character NUCC taxonomy code (e.g., "261QD0000X")
primaryLicenseNumber / primaryLicenseState	string	Primary state professional license number and state
authorizedOfficialName	string	Clinic decision-maker full name + credential (NPI-2)
authorizedOfficialTitle	string	Decision-maker role ("President", "Owner", "CEO", "Medical Director", "Dentist")
authorizedOfficialPhone	string	Direct phone number for the Authorized Official
practicePhone / practiceFax	string	Primary clinical practice location phone and fax numbers (XXX-XXX-XXXX)
practiceStreet1 / practiceCity / practiceState / practiceZip	string	Physical practice street address (LOCATION)
mailingStreet1 / mailingCity / mailingState / mailingZip	string	Billing / mailing office address (MAILING)
secondaryLocationsCount / secondaryLocations	array	Additional branch/clinic locations registered under this NPI
allSpecialties / allTaxonomies	array	Complete list of all specialties, NUCC codes, and state licenses
enumerationDate / lastUpdated	string	Initial NPI registration date and most recent NPPES update (YYYY-MM-DD)
npiRegistryUrl	string	Direct link to the official CMS NPPES profile (https://npiregistry.cms.hhs.gov/provider-view/<npi>)

---

Example Input

{
  "specialties": ["Dental", "Dentist"],
  "states": ["TX", "FL"],
  "enumerationType": "NPI-2",
  "requirePhone": true,
  "requireAuthorizedOfficial": true,
  "activeOnly": true,
  "maxItems": 100
}

Example Output Record

{
  "npi": "1063828648",
  "entityType": "Organization (NPI-2)",
  "enumerationType": "NPI-2",
  "status": "Active",
  "displayName": "ROBERT F. BENNINGFIELD D.D.S. INC.",
  "organizationName": "ROBERT F. BENNINGFIELD D.D.S. INC.",
  "dbaName": null,
  "primarySpecialty": "Clinic/Center, Dental",
  "primaryTaxonomyCode": "261QD0000X",
  "authorizedOfficialName": "Dr. ROBERT FAULKNER BENNINGFIELD, DDS",
  "authorizedOfficialTitle": "Dentist",
  "authorizedOfficialPhone": "817-249-4150",
  "practicePhone": "817-249-4150",
  "practiceFax": "817-249-4153",
  "practiceStreet1": "111 SPROLES DR",
  "practiceCity": "BENBROOK",
  "practiceState": "TX",
  "practiceZip": "76126-3213",
  "enumerationDate": "2014-07-03",
  "lastUpdated": "2014-07-03",
  "npiRegistryUrl": "https://npiregistry.cms.hhs.gov/provider-view/1063828648"
}