US Healthcare Provider & Clinic NPI Registry Lead Scraper

Scrape US healthcare providers, medical clinics, dental practices & physicians from the official CMS NPPES NPI Registry v2.1 with Authorized Officials, phones & licenses.

What it does

Queries the official US CMS National Plan and Provider Enumeration System (NPPES NPI Registry v2.1 API) across all 50 states for medical clinics, dental practices, labs, hospitals (NPI-2), and individual specialists (NPI-1) — extracting 10-digit NPIs, clinic Authorized Official decision-maker names/titles/phones, practice addresses, phone/fax numbers, state license numbers, and NUCC taxonomy codes. Export clean, deduplicated data as JSON, CSV, Excel, XML, or RSS, or connect directly via the Apify REST API, Python/JavaScript SDKs, CLI, MCP Server, Clay, n8n, Make, or Zapier — with no login, cookies, or browser overhead.

Use cases

• Healthcare SaaS, EHR & Medical Billing Outbound Sales: Extract NPI-2 clinics and medical groups with the Authorized Official decision-maker's full name (authorizedOfficialName), title (authorizedOfficialTitle, e.g., Owner, CEO, President, Medical Director), and direct telephone (authorizedOfficialPhone).
• Dental, MedSpa & Specialty Clinic Lead Generation: Build multi-state territory lists for Dentist, Dermatology, Cardiology, Physical Therapist, Optometrist, or Chiropractor practices with verified street addresses, phone, and fax numbers.
• Healthcare Staffing & Locum Tenens Recruiting: Identify licensed NPI-1 specialists (credential, licenseNumber, licenseState, primaryTaxonomyCode) across all 50 US states.
• Provider Network & Directory Verification: Validate 10-digit NPI numbers (npiNumber), active status, enumeration dates, and primary NUCC taxonomy classifications in bulk.

Why use this scraper?

Feature	This Actor	Generic Browser / HTML Scrapers
Architecture	Direct structured API / JSON / SSR requests (curl_cffi)	Heavy headless browser automation
Speed & reliability	2–25 seconds for 50–200 items	Minutes of high compute burn
Pricing model	Pay per result ($0.00 actor-start fee)	Monthly rental or high CU overhead
Error handling	Failed inputs logged in ERRORS key-value record and never charged	Bills compute time even on failures

Input parameters

Parameter	Type	Default	Description
taxonomies	array	["Dentist", "Cardiology", "Dermatology", "Phy...	Specialty or taxonomy descriptions to query across the CMS NPPES NPI Registry (e.g. 'Dentist', 'Cardiology', 'Dermatology', 'Physical Therapist', 'Family Medicine', 'Clinic', 'Optometrist').
states	array	["CA", "NY", "TX"]	Two-letter US state or territory codes (e.g. 'CA', 'NY', 'TX', 'FL', 'IL').
city	string	""	Optional city name filter (e.g. 'Los Angeles', 'New York', 'Houston').
postalCode	string	""	Optional 5-digit ZIP code or prefix filter (e.g. '90210' or '902*').
enumerationType	string	"ALL"	Filter to 'NPI-2' (Organizations, Clinics, Dental Practices & Labs — includes Authorized Official decision-maker name, title & phone), 'NPI-1' (Individual Physicians & Specialists), or 'ALL'.
organizationName	string	""	Optional medical group, hospital, or clinic organization name filter.
onlyNew	boolean	false	Deduplicate by 10-digit NPI number across runs via Apify Key-Value Store.
maxResultsPerQuery	integer	20	Maximum number of NPI provider/clinic records to emit per specialty taxonomy (default 4 taxonomies x 20 = 80 records).
delaySeconds	number	0.15	Polite pause between upstream HTTP requests (seconds).

Parameter details

• Medical specialties or taxonomy descriptions (taxonomies, array): Specialty or taxonomy descriptions to query across the CMS NPPES NPI Registry (e.g. 'Dentist', 'Cardiology', 'Dermatology', 'Physical Therapist', 'Family Medicine', 'Clinic', 'Optometrist').
• US State codes (2-letter) (states, array): Two-letter US state or territory codes (e.g. 'CA', 'NY', 'TX', 'FL', 'IL').
• City filter (optional) (city, string): Optional city name filter (e.g. 'Los Angeles', 'New York', 'Houston').
• ZIP / Postal code filter (optional) (postalCode, string): Optional 5-digit ZIP code or prefix filter (e.g. '90210' or '902*').
• Provider entity type (NPI-2 Clinics vs NPI-1 Individuals) (enumerationType, string): Filter to 'NPI-2' (Organizations, Clinics, Dental Practices & Labs — includes Authorized Official decision-maker name, title & phone), 'NPI-1' (Individual Physicians & Specialists), or 'ALL'.
• Organization / Clinic name search (optional) (organizationName, string): Optional medical group, hospital, or clinic organization name filter.
• Only new NPI numbers (onlyNew, boolean): Deduplicate by 10-digit NPI number across runs via Apify Key-Value Store.
• Max results per specialty query (maxResultsPerQuery, integer): Maximum number of NPI provider/clinic records to emit per specialty taxonomy (default 4 taxonomies x 20 = 80 records).
• Delay between requests (delaySeconds, number): Polite pause between requests (default 0.15).

Example input

{
  "taxonomies": [
    "Dentist",
    "Cardiology",
    "Dermatology",
    "Physical Therapist"
  ],
  "states": [
    "CA",
    "NY",
    "TX"
  ],
  "city": "",
  "postalCode": "",
  "enumerationType": "ALL",
  "organizationName": "",
  "onlyNew": false,
  "maxResultsPerQuery": 20
}

Quickstart: API, Python & Automation (Clay / n8n / Make)

Run directly via the Apify REST API (POST /v2/acts/informed_almandine_vzb~us-npi-healthcare-provider-scraper/runs) or Python SDK:

from apify_client import ApifyClient

client = ApifyClient("YOUR_APIFY_TOKEN")
run = client.actor("informed_almandine_vzb/us-npi-healthcare-provider-scraper").call(run_input={"taxonomies": ["Dentist", "Cardiology", "Dermatology", "Physical Therapist"], "states": ["CA", "NY", "TX"], "city": "", "postalCode": "", "enumerationType": "ALL", "organizationName": "", "onlyNew": false, "maxResultsPerQuery": 20})
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

Output & example output

One dataset row per result. Default table view columns: npiNumber, entityType, providerOrOrganizationName, primaryTaxonomyDescription, practiceCity, practiceState, practicePhone, authorizedOfficialName, authorizedOfficialTitle, url. Full structured JSON is stored in the run's default dataset.

Example output item

{
  "npiNumber": "1760813802",
  "entityType": "NPI-2 Organization",
  "providerOrOrganizationName": "101 DENTAL GROUP",
  "firstName": "AMIR",
  "lastName": "CHOROOMI",
  "credential": "MD/DDS/Provider",
  "primaryTaxonomyCode": "1223G0001X",
  "primaryTaxonomyDescription": "Dentist, General Practice",
  "licenseNumber": "54634",
  "licenseState": "CA",
  "practiceAddressLine1": "7259 OWENSMOUTH AVE",
  "practiceAddressLine2": "",
  "practiceCity": "CANOGA PARK",
  "practiceState": "CA",
  "practiceZip": "91303-1530",
  "practicePhone": "818-999-9900",
  "practiceFax": "818-999-9978",
  "authorizedOfficialName": "AMIR H CHOROOMI",
  "authorizedOfficialTitle": "dentist",
  "authorizedOfficialCredential": "MD/DDS/Provider",
  "authorizedOfficialPhone": "8187353800",
  "enumerationDate": "2013-11-27",
  "lastUpdatedDate": "2013-11-27",
  "status": "ACTIVE",
  "url": "https://npiregistry.cms.hhs.gov/provider-view/1760813802",
  "scrapedAt": "2026-10-25T16:20:13+00:00"
}

Pricing (Pay-Per-Result)

This Actor uses transparent Pay-Per-Event pricing with a $0.00 actor-start fee:

Event	What is charged	Price
provider-result	Healthcare provider or clinic NPI record scraped (One normalized US healthcare provider or medical clinic record from CMS NPPES NPI Registry)	$0.0015 / result ($1.50 / 1,000 results)
apify-actor-start	Actor start fee	$0.00

Concrete pricing math

• provider-result (Healthcare provider or clinic NPI record scraped): 1,000 results = $1.50 (50 results = $0.07, 10,000 results = $15.00). Apify's $5.00/month Free Tier covers up to 3,333 results/month at $0.00 out-of-pocket.
• Empty runs (0 results) & skipped duplicates (onlyNew / onlyChanged): $0.00.

Data and compliance

100% official public U.S. federal business/practice registry data published by the Centers for Medicare & Medicaid Services (CMS NPPES API v2.1) under FOIA and HIPAA Administrative Simplification mandates. Strictly commercial provider/practice directory data; zero patient PHI. Requests are rate-limited and routed through Apify Proxy. Per-input errors are recorded in the run's ERRORS key-value record and are never charged.

FAQ

Do I need an account, login, or API key?
No. This Actor queries public endpoints directly and requires zero credentials.

What happens if I start a run with empty {} input via API or CLI?
Every input defines identical prefill and default values in .actor/input_schema.json, so an empty {} run automatically returns 50+ live records out of the box.

How does incremental deduplication (onlyNew) work?
When onlyNew: true is enabled, the Actor stores seen record IDs in a named Apify Key-Value Store (npi-healthcare-provider-directory-state) and emits only newly discovered records on subsequent scheduled runs.

Can I export to CSV, Excel, Google Sheets, Clay, or n8n?
Yes. Every dataset item uses flat, normalized top-level keys (npiNumber, entityType, providerOrOrganizationName, primaryTaxonomyDescription, practiceCity, practiceState, etc.) for one-click CSV/Excel download or native webhook delivery.