NPI Healthcare Provider Scraper (NPPES)

What this Actor scrapes

The NPPES NPI Registry is the authoritative federal directory of every healthcare provider in the United States. Every active physician, dentist, chiropractor, nurse practitioner, hospital, and medical group is listed here — complete with verified location address, telephone number, fax, speciality taxonomy, licence number, and enumeration status.

The registry's own API is publicly accessible, but turning it into a reliable bulk export takes real engineering: paginating past NPPES's 200-record-per-request ceiling, normalising the nested taxonomy and address objects, handling partial-result pages near the 1 200-result query cap, and coercing dates and flags into consistent types. We handle all of that and hand you back one richly-typed row per provider.

What we handle for you

• 🔁 Automatic pagination — the NPPES API returns at most 200 records per request. We page through all available results (up to ~1 200 per query combination) and merge them transparently.
• 🧱 Rate-limit-aware backoff — when the CMS endpoint pushes back we slow down, honour Retry-After headers, and retry up to 5 times with exponential backoff before surfacing an error.
• 🧊 Pydantic-validated rows — every field is typed at write time. Booleans are booleans. Dates arrive as ISO-8601 strings. Taxonomy codes, licence numbers, and address fields are normalised across individual and organisational providers.
• 🌐 Proxy-ready — the NPPES API is a public federal endpoint and direct routing works on most infrastructure. The proxy configuration field is there when you need it.
• 💰 Pay-Per-Event pricing — you pay only for records that land in your dataset. No data, no charge beyond the small run warm-up fee.
• 📦 Export in any format — Apify Console exports the dataset as JSON, CSV, or Excel with one click. Pull via API for automated pipelines.

Use cases

• Pharma / medical-device field rep territory lists — pull every GP or specialist in a sales territory by state + taxonomy and load into your CRM.
• Dental-supply prospecting — filter by dentist taxonomy and state for a fresh dentist contact list at a fraction of the cost of a list broker.
• Healthcare-data vendor pipelines — bulk-export the registry by specialty and resell structured datasets to compliance, billing, or referral-network products.
• Credentialing verification — cross-reference provider NPI numbers, licence states, and taxonomy codes for onboarding workflows.
• Insurance network gap analysis — identify active providers in a region and compare against your network panel.
• Academic and policy research — map provider density and specialty distribution by state or ZIP.

Input

Paste this into the Apify Console, or send it as the run input over the API. Proxy settings are on by default; you rarely need to touch them.

{
  "state": "CA",
  "taxonomyDescription": "dentist",
  "enumerationType": "NPI-1",
  "maxItems": 200,
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}

Output

One row per result, schema-validated before it is written. Export JSON, CSV, Excel or XML from the run, or read it over the API.

npienumeration_typenamecredentialstatusprimary_taxonomyspecialtylicenselicense_stateaddress_line1citystatepostal_codephonefaxsole_proprietor

{
  "npi": "1234567890",
  "enumeration_type": "NPI-1",
  "name": "Jane Smith",
  "credential": "DDS",
  "status": "Active",
  "primary_taxonomy": "122300000X",
  "specialty": "Dentist",
  "license": "CA12345",
  "license_state": "CA",
  "address_line1": "123 Main St",
  "city": "Los Angeles",
  "state": "CA",
  "postal_code": "90001",
  "country": "US",
  "phone": "310-555-0100",
  "fax": "310-555-0101",
  "sole_proprietor": true,
  "gender": "F",
  "enumeration_date": "2010-03-15",
  "last_updated": "2024-11-01",
  "scraped_at": "2026-06-07T10:00:00+00:00"
}

Pricing

You pay only for results that land. Cap any run with maxTotalChargeUsd. See pricing & billing for worked examples.

Limitations

• NPPES query cap — the registry limits skip to 1 000, so any single state + specialty combination returns at most ~1 200 records. For large specialties (e.g. all physicians in California) you will need to paginate by city or ZIP code range across multiple runs.
• No email addresses — NPPES does not publish provider email addresses. Phone and fax are included; email is not part of the public registry.
• US providers only — the NPPES registry covers US-based or US-licensed providers. International providers are out of scope.
• Data freshness — NPPES records reflect CMS update cycles. Providers who recently enrolled or updated their information may appear with a short delay. The last_updated field indicates the record's freshness.
• Deactivated NPIs — by default the API returns both active and inactive providers. Filter by status == "Active" post-export if you only want active practitioners.