Home › Funding, grants and compliance › NPI Registry Scraper
New and changed healthcare organizations (NPI type 2: clinics, pharmacies, home health, DME suppliers, labs) from the official CMS NPPES NPI Registry, with taxonomy, practice address and phone. Organizations only. No API key; new-only monitor mode.
| Field | Name | Required | What it does |
|---|---|---|---|
mode | Mode | no | New enrollments = organizations whose NPI was issued on or after the start date. Changes = any organization record updated since the start date (new enrollments are labelled).... |
states | States | no | Two-letter US state or territory codes, e.g. MI, TX. Each state is scanned separately. |
cities | Cities | no | Only organizations whose practice location is in these cities. Use together with a state. |
postalCodes | ZIP codes or prefixes | no | 5-digit ZIPs or prefixes of at least 2 digits (for example 482 for Detroit). |
specialties | Taxonomy (specialty) text | no | NUCC taxonomy description, for example Pharmacy, Home Health, Durable Medical Equipment, Clinic/Center, Laboratory, Dentist. Each one is scanned separately; wildcards like Pharm*... |
primarySpecialtyOnly | Match primary taxonomy only | no | Keep an organization only when the chosen taxonomy is its primary one, not just one of several listed. |
organizationCategories | Organization categories | no | Keep only these categories (derived from the primary taxonomy code). Leave empty for all. |
organizationName | Organization name (optional) | no | Legal or DBA name to match, at least 2 characters; trailing * works as a wildcard, e.g. Walgreen*. |
npis | Look up NPIs (optional) | no | Up to 200 10-digit NPI numbers to look up directly. Individual (type 1) NPIs are never returned. |
activeOnly | Active organizations only | no | Skip deactivated NPI records. |
lookbackDays | Look back (days) | no | Start date = today minus this many days. Ignored when you set a start date below. |
sinceDate | Start date (optional) | no | YYYY-MM-DD. Overrides the look-back. Leave empty to use the look-back. |
maxResults | Max results | no | Cap on organizations delivered (and charged) this run. Start with 25. |
requirePhone | Only organizations with a practice phone | no | Skip rows with no practice-location phone on record. |
One row per result. These are the 31 fields declared in the actor's dataset schema (field list from the schema, not a sample run).
| Field | Type | Meaning |
|---|---|---|
npi | string | 10-digit National Provider Identifier (type 2, organization). |
providerType | string | Type as published in the NPPES NPI Registry. |
organizationName | string | Organization as published in the NPPES NPI Registry. |
otherNames | array | Other names (DBA) as published in the NPPES NPI Registry. |
organizationCategory | string | pharmacy, dme_supplier, home_health, hospice, laboratory, hospital, clinic_center, group_practice, nursing_facility, residential_treatment,... |
primaryTaxonomyCode | string | Taxonomy code as published in the NPPES NPI Registry. |
primaryTaxonomy | string | Primary taxonomy as published in the NPPES NPI Registry. |
taxonomyCodes | array | All taxonomy codes as published in the NPPES NPI Registry. |
taxonomies | array | All taxonomies as published in the NPPES NPI Registry. |
taxonomyCount | integer | Number of taxonomies (service lines) listed on the record; more than one usually means a multi-service organization. |
licenseNumber | string | License no. as published in the NPPES NPI Registry. |
licenseState | string | License state as published in the NPPES NPI Registry. |
isSubpart | boolean | Subpart as published in the NPPES NPI Registry. |
parentOrganizationName | string | Parent organization as published in the NPPES NPI Registry. |
practiceStreet | string | Practice street as published in the NPPES NPI Registry. |
practiceCity | string | City as published in the NPPES NPI Registry. |
practiceState | string | State as published in the NPPES NPI Registry. |
practiceZip | string | ZIP as published in the NPPES NPI Registry. |
practicePhone | string | Practice phone as published in the NPPES NPI Registry. |
practiceFax | string | Practice fax as published in the NPPES NPI Registry. |
mailingStreet | string | Mailing street as published in the NPPES NPI Registry. |
mailingCity | string | Mailing city as published in the NPPES NPI Registry. |
mailingState | string | Mailing state as published in the NPPES NPI Registry. |
mailingZip | string | Mailing ZIP as published in the NPPES NPI Registry. |
enumerationDate | string | Enrolled as published in the NPPES NPI Registry. |
lastUpdated | string | Last updated as published in the NPPES NPI Registry. |
changeType | string | new_enrollment when enrolled on/after the start date, else updated. |
daysSinceEnrollment | integer | Days since enrollment as published in the NPPES NPI Registry. |
status | string | Status as published in the NPPES NPI Registry. |
registryUrl | string | Registry page as published in the NPPES NPI Registry. |
scrapedAt | string | Scraped at as published in the NPPES NPI Registry. |
Public data only, no login. Fields a source does not publish come back empty rather than guessed. Coverage and freshness follow the underlying public source.
Pay on Apify, no subscription: $0.002 per organization returned (pay per event). The live price is on the actor page.
Disclosure: we build and maintain this actor.