Medicare Provider Scraper

Search and retrieve detailed information on Medicare healthcare providers from the NPPES NPI Registry and CMS Provider Data. Find doctors, hospitals, clinics, and other providers by name, specialty, NPI number, or location across all 50 US states.

Features

• Search by multiple criteria -- Find providers by name, specialty, location, NPI, or organization
• NPI lookup -- Get comprehensive details for any provider by their 10-digit NPI number
• CMS data enrichment -- Optionally enrich results with Medicare-specific data (medical school, telehealth, group practice info)
• Dual data sources -- Combines NPPES NPI Registry (primary) with CMS Provider Data (supplemental)
• Wildcard search -- Supports trailing wildcards for name searches (e.g., "Smi*")
• Provider type filtering -- Filter by Individual (NPI-1) or Organization (NPI-2)
• Automatic pagination -- Handles large result sets with rate-limited pagination
• Deduplication -- Automatically deduplicates providers across NPPES and CMS sources

Input Parameters

Parameter	Type	Default	Description
mode	string	"search"	search to find providers, details for NPI lookup
searchQuery	string	""	Provider name (parsed as first/last name automatically)
npi	string	""	10-digit National Provider Identifier
specialty	string	""	Specialty or taxonomy (e.g., "Cardiology", "Family Medicine")
firstName	string	""	Provider first name (supports trailing wildcard)
lastName	string	""	Provider last name (supports trailing wildcard)
organizationName	string	""	Organization name (hospitals, clinics, group practices)
city	string	""	City to search in
state	string	""	Two-letter state code (e.g., "CA", "NY")
zipCode	string	""	5-digit ZIP code
enumerationType	string	""	Provider type: NPI-1 (Individual) or NPI-2 (Organization)
limit	integer	200	Maximum results (0 for all, max 10000)
enrichWithCMS	boolean	false	Enrich results with CMS Provider Data (adds extra API calls)

Example Inputs

Find cardiologists in New York:

{
  "mode": "search",
  "specialty": "Cardiology",
  "state": "NY",
  "city": "New York",
  "limit": 100
}

Look up a specific provider by NPI:

{
  "mode": "details",
  "npi": "1234567890"
}

Search for a provider by name with CMS enrichment:

{
  "mode": "search",
  "firstName": "John",
  "lastName": "Smith",
  "state": "CA",
  "enrichWithCMS": true,
  "limit": 50
}

Find hospitals in a ZIP code:

{
  "mode": "search",
  "enumerationType": "NPI-2",
  "zipCode": "90210",
  "limit": 200
}

Output Fields

Field	Type	Description
npi	string	10-digit National Provider Identifier
providerName	string	Full provider name
credential	string	Credentials (MD, DO, RN, etc.)
providerType	string	"Individual" or "Organization"
enumerationType	string	NPI-1 or NPI-2
gender	string	Male, Female, or null
primarySpecialty	string	Primary taxonomy description
primaryTaxonomyCode	string	Primary taxonomy code
allSpecialties	array	All specialties with codes, licenses, and state
practiceAddress	string	Practice location address
city	string	Practice city
state	string	Practice state
zipCode	string	5-digit ZIP code
phone	string	Practice phone number
fax	string	Fax number
organizationName	string	Organization name (for group/hospital)
authorizedOfficial	string	Authorized official name (organizations)
firstName	string	Individual first name
lastName	string	Individual last name
enumerationDate	string	NPI enumeration date
lastUpdated	string	Last NPI record update
otherIdentifiers	array	State license numbers and other IDs
endpoints	array	Health information exchange endpoints
nppesUrl	string	NPPES registry URL
dataSource	string	Data source: "NPPES", "CMS Provider Data", or "NPPES + CMS"

CMS Enrichment Fields (when enrichWithCMS is enabled)

Field	Type	Description
cms_medicalSchool	string	Medical school attended
cms_graduationYear	string	Graduation year
cms_primarySpecialty	string	CMS primary specialty
cms_secondarySpecialties	array	Additional specialties from CMS
cms_facilityNames	array	Associated facility names
cms_acceptsMedicareAssignment	boolean	Accepts Medicare assignment
cms_telehealth	boolean	Offers telehealth services
cms_orgMemberCount	number	Number of members in group practice

Use Cases

• Credentialing -- Verify provider NPI numbers, specialties, and license information
• Healthcare staffing -- Find providers by specialty and location for recruitment
• Provider directories -- Build or update healthcare provider directories
• Network adequacy -- Analyze provider availability by specialty and geography
• Referral research -- Find specialists in a specific area for patient referrals
• Compliance verification -- Confirm active NPI status and Medicare enrollment

Data Sources

• NPPES NPI Registry -- Free, no authentication required
• CMS Provider Data -- Free, no authentication required

---

Run on Apify

This scraper runs on the Apify platform -- a full-stack web scraping and automation cloud. Sign up for a free account to get started with 30-day trial of all features.

Try Apify free ->