🩺 Medicare Doctors & Clinicians Scraper

Search the official CMS Doctors and Clinicians dataset (the National Downloadable File) for US Medicare providers, with no login and no key of your own to manage. Filter by specialty, state, city, ZIP, name, credential or medical school, or look up exact providers by NPI, and get back the full practice profile: credential, medical school, specialty, group practice, address, phone and Medicare assignment status.

🎯 Who uses it?

🏥 Healthcare credentialing and network teams

Verify a provider's specialty, credential and medical school, and confirm which of their group affiliations actually accept Medicare assignment.

📇 Healthcare sales and lead generation

Build targeted lists of clinicians by specialty and location, with phone and practice details ready for outreach.

🔬 Health services researchers

Study provider distribution, specialty mix and group affiliation patterns across states, cities or medical schools.

💼 Payers and referral networks

Find in-network-eligible providers by specialty and location, filtered to those actually accepting Medicare assignment.

✨ What it does

• Search by specialty, state, city, ZIP, last/first name, credential, medical school or group name, any combination.
• Look up exact providers by their 10-digit NPI.
• One row per provider: turn on provider-level grouping to collapse every practice location a clinician has into a single record, instead of one line per enrollment.
• Medicare assignment, tracked separately: a provider's own assignment status and their group's status are reported independently, since they can differ.
• Graduation-year range: filter to clinicians who graduated between two years, not just after one.

Missing source values are returned as null, never invented.

Why this scraper

• One provider, one row, if you want it. A clinician enrolled at several practices normally comes back as several separate lines; this can combine them into one record with every location nested underneath.
• Every secondary specialty, not just the first. The source can list several; all of them are captured.
• Individual and group Medicare assignment, both exposed. These are genuinely different statuses in the source data and are kept that way here.
• A real graduation-year range, not a one-sided cutoff.
• CMS's own address key included, so locations can be grouped or matched without parsing address text.

How it compares

Capability	This actor	Other CMS Doctors & Clinicians actors
Specialty, state, city, ZIP, name, credential, medical school, group filters	yes	yes
One row per provider (all locations combined)	yes	no
All secondary specialties, not just one	yes	not documented
Individual vs group Medicare assignment tracked separately	yes	single combined flag
Graduation-year range (both bounds)	yes	one-sided only
NPI lookup	yes	yes

📦 What data you get

Entity	Useful fields
Provider	NPI, name, credential, gender, medical school, graduation year, primary and all secondary specialties.
Enrollment	Individual PAC ID, enrollment ID, telehealth flag.
Practice location	Group name, group PAC ID, group size, full address, phone, individual and group Medicare assignment, CMS's own address ID.
Aggregated view	Every practice location for a provider, nested under one record, with a location count.

Every record includes observedAt (UTC) and a link to the NPI registry entry. Download your dataset from Apify as CSV, JSON, Excel, or XML.

💡 Use cases

🏥 Every dermatologist in California

{ "specialties": ["DERMATOLOGY"], "states": ["CA"], "maxProviders": 200 }

📇 One row per provider, for a specialty and state

{ "specialties": ["CARDIOLOGY"], "states": ["NY"], "aggregateByProvider": true, "maxProviders": 100 }

🔎 Look up a specific provider

{ "npiNumbers": ["1023570041"] }

⚙️ How the input is organised

Maximum providers sits at the very top, since it applies no matter what you're doing. Below it, the form is split into three numbered sections:

Section	What it's for
1 · Look up specific providers	NPI numbers, when you already know exactly who you want.
2 · Or search by filters	Specialty, location, name, credential, medical school, group and graduation-year filters.
3 · Refine (optional)	Phone-published, Medicare assignment, and the one-row-per-provider option.

Apify Free plan: every run is limited to a fixed 10-row sample. Upgrade your Apify plan to run your own settings.

🛡️ Limits & responsible use

This Actor reads only publicly available CMS provider data. It never signs in and never accesses anything gated behind an account.

This is business and professional-credential data (a Medicare provider's practice information), not personal patient data. Use it for legitimate business, research or credentialing purposes.

If a search matches nothing, the run writes a single row with an error field instead of failing silently.

📧 Contact

Need a scraper for a different site, or found something wrong with this one? norm.data.scrapers@gmail.com

Local development

bun install
bun test                # offline: normalization and input parsing, against real fixtures
bun run src/main.ts     # reads storage/key_value_stores/default/INPUT.json