🩺 NPI Registry Scraper

🚀 Export U.S. National Provider Identifier (NPI) registry data in seconds. Provider name, taxonomy, address, phone, and credentials.

🕒 Last updated: 2026-06-05 · 📊 20 fields per record · 8 million+ U.S. healthcare providers · Public CMS API

The NPI Registry Scraper turns the public npiregistry.cms.hhs.gov/api/ endpoint into a structured dataset. It runs an NPPES search with the filters you provide (name, taxonomy, city, state, ZIP, NPI number) and returns one flat record per provider with the primary location and primary taxonomy already extracted.

🎯 Target Audience	💡 Primary Use Cases
🏥 Healthcare BD teams	Build provider outreach lists
💊 Pharma sales	Map prescribers by specialty and territory
🛡️ Compliance	Verify a clinician's NPI before claims
📊 Analysts	Map provider density by ZIP
🧪 Researchers	Study U.S. healthcare workforce trends
👩‍💻 Developers	Mirror NPPES into your CRM

📋 What the NPI Registry Scraper does

• Calls the public NPPES /api/ endpoint with version 2.1.
• Forwards every supported filter (name, organization, taxonomy, address, NPI number, enumeration type).
• Extracts the primary location address and primary taxonomy into top-level fields.
• Paginates through the NPPES result window (up to 1,200 records per query).
• Surfaces upstream errors as a single diagnostic record.
• Exports to every Apify dataset format.

💡 Why it matters: NPPES is the canonical source of U.S. provider identifiers, but its API returns deeply nested addresses and taxonomies. This actor flattens both into the fields your CRM expects.

🎬 Full Demo

🚧 Coming soon.

⚙️ Input

Field	Type	Required	Description
maxItems	integer	No	Free 10. Paid up to 1,000,000.
firstName / lastName	string	No	Individual provider name.
organizationName	string	No	NPI-2 organization name.
number	string	No	Exact 10-digit NPI lookup.
taxonomyDescription	string	No	Specialty such as `Cardiology` or `Pharmacist`.
city / state / postalCode	string	No	Practice location.
enumerationType	enum	No	NPI-1 individual or NPI-2 organization.

Example 1. California dentists.

{ "taxonomyDescription": "Dentist", "state": "CA", "maxItems": 50 }

Example 2. Exact NPI lookup.

{ "number": "1234567893" }

⚠️ Good to Know: NPPES caps a single query at 1,200 results. Narrow your filters to get the rows you want.

📊 Output

Field	Type	Description
🆔 npi	string	10-digit NPI.
🏷️ enumerationType	string	NPI-1 or NPI-2.
👤 name	string	Provider or organization name.
🎓 credential	string	Credential text.
⚧ gender	string	M or F (individuals).
🪪 soleProprietor	string	Sole proprietor flag.
🩺 taxonomy	string	Primary taxonomy description.
🔢 taxonomyCode	string	Primary taxonomy code.
🏛️ taxonomyState	string	State of primary license.
🪪 taxonomyLicense	string	License number.
📍 address	string	Primary location address.
📞 phone	string	Primary phone.
📠 fax	string	Primary fax.
📅 enumerationDate	string	When NPI was issued.
🕒 lastUpdated	string	Latest NPPES update.
✅ status	string	Active or deactivated.
📍 addresses	array	Full address array.
🩺 taxonomies	array	Full taxonomy array.
🆔 identifiers	array	Other identifiers.
🕒 scrapedAt	string	When this row was fetched.
❌ error	string	Set on upstream error.

{
  "npi": "1234567893",
  "name": "Jane Doe",
  "credential": "MD",
  "taxonomy": "Internal Medicine",
  "address": "123 Main St, Sacramento, CA, 95814",
  "phone": "916-555-0100",
  "scrapedAt": "2026-06-05T12:00:00.000Z",
  "error": null
}

✨ Why choose this Actor

| 🆓 | Public CMS endpoint, no key required. | | 🩺 | Primary location and taxonomy already flattened. | | 🔎 | Every NPPES filter exposed. | | 🛟 | Clean diagnostic records on errors. | | 💾 | Push to dataset for instant export. |

📈 How it compares to alternatives

Approach	Setup	Filters	Flattening	Auto export
NPPES website	manual	manual	manual	❌
Roll your own fetch	30 min +	manual	manual	manual
This Actor	5 sec	✅	✅	✅

🚀 How to use

1. Click Try for free.
2. Provide at least one filter (name, NPI, taxonomy, or address).
3. Click Start and download the dataset.

💼 Business use cases

🏥 Outreach lists. Build a targeted prospect list of cardiologists in the Northeast.

💊 Pharma territory mapping. Cross-reference NPI density against sales rep coverage.

🛡️ Claims compliance. Validate billing NPIs before submission.

📊 Workforce analytics. Snapshot specialty supply by state.

🔌 Automating NPI Registry Scraper

• Make and Zapier trigger this actor on schedule or on demand.
• Cron keeps your mirror fresh.
• Webhooks notify on completion.
• Pipe to BigQuery, Snowflake, or Postgres with native integrations.

🌟 Beyond business use cases

🎓 Education. Teach health-IT classes with real NPI data.

🧪 Personal research. Look up a clinician's credentials.

🤝 Non-profit and open data. Publish provider-density dashboards.

🧰 Tinkering. Spot-check a single NPI.

🤖 Ask an AI assistant about this scraper

Pop this README into ChatGPT, Claude, or any AI assistant and ask it to map your specific workflow to the actor's inputs.

❓ Frequently Asked Questions

❓ Need an API key? No.

❓ Source? Official NPPES API hosted by CMS.

❓ Schedule runs? Yes.

❓ Rate limits? NPPES caps a single query at 1,200 rows; narrow filters to paginate beyond that.

❓ API or scraping? API.

❓ Schema stability? Stable.

❓ Maximum run? 1,000,000 records on paid plans.

❓ Both NPI-1 and NPI-2? Yes.

❓ Taxonomy detail? Primary flattened plus full array.

❓ Download formats? Any Apify dataset format.

🔌 Integrate with any app

Apify ships native integrations with Make, Zapier, Slack, Discord, Google Drive, Google Sheets, Gmail, Airbyte, Keboola, Telegram, GitHub, and any REST API or webhook endpoint.

🔗 Recommended Actors

Actor	What it does
ParseForge ChEMBL Targets Scraper	Drug-target metadata.
ParseForge ChEMBL Assays Scraper	Bioactivity assay metadata.
ParseForge Alpha Vantage Scraper	Public market data.
ParseForge OurAirports Scraper	Global airport database.

💡 Pro Tip: browse the complete ParseForge collection for 900+ production-grade scrapers.

---

Disclaimer. This actor scrapes only publicly available data. ParseForge is not affiliated with, endorsed by, or sponsored by the Centers for Medicare and Medicaid Services. Users are responsible for complying with the target site's terms of service and applicable law. Create a free account w/ $5 credit.