CMS Medicare Provider Utilization & Payment Crawler
CMS Medicare Provider Utilization & Payment Data Crawler
Extract Medicare provider records from the CMS Provider Data API. Four dataset modes in one actor: clinician directory with 2.8M provider records, procedure utilization data, MIPS quality scores, and office visit costs by specialty and ZIP code. No authentication, no proxies, no scraping — pure JSON API.
CMS Medicare Provider Crawler Features
- Pull from four CMS datasets in a single actor: clinician directory, utilization, MIPS performance, and office visit costs
- Clinician directory covers 2.8M+ Medicare providers with credentials (MD, DO, NP, PA), specialties, practice addresses, and phone numbers
- Filter clinician records by state, primary specialty, and provider last name — filters applied server-side where the API supports it
- MIPS performance data for 541K+ clinicians including final composite score, quality, cost, and promoting interoperability components
- Office visit cost data broken out by specialty (55 specialties covered) and ZIP code — min/max Medicare pricing and copay ranges for new and established patients
- Utilization data shows procedure category and volume range per provider across 314K+ records
- Reads CMS's structured JSON API directly — 500 records per page, no HTML parsing, no rate-limit issues
- Pay-per-event pricing at roughly $0.001 per record
Who Uses CMS Medicare Provider Data?
- Healthcare recruiters and staffing firms — build targeted contact lists of physicians, NPs, and PAs filtered by specialty and state, with formatted phone numbers ready to import
- Medical device and pharma sales teams — identify high-volume providers in target specialties by cross-referencing clinician directory and utilization data
- Health plan and network analysts — audit Medicare assignment acceptance across states and specialties, or assess telehealth adoption by region
- Revenue cycle and consulting firms — benchmark office visit costs against Medicare rates by specialty and ZIP code for contract negotiation or patient cost estimation
- Policy researchers and academics — analyze MIPS performance score distributions by specialty or geography for quality measurement research
- Healthcare marketplaces and directories — seed or refresh provider databases with verified NPI, credential, address, and contact data from the authoritative government source
How CMS Medicare Provider Crawler Works
- You select a dataset type and optionally set filters: one or more states, a primary specialty, or a provider last name.
- For clinician, utilization, and MIPS datasets, the crawler paginates through the CMS API at 500 records per request with a 150ms delay between calls. State filters generate parallel queries — one per state — which run sequentially.
- For office visit costs, the specialty selection maps to one of 55 specialty-specific CMS datasets. The crawler fetches that dataset in full.
- Records are normalized into a consistent output schema regardless of which dataset you ran.
Input
Clinician directory: all cardiologists in Texas and Florida
{
"datasetType": "clinician",
"states": ["TX", "FL"],
"specialty": "Cardiology",
"maxItems": 500,
"sp_intended_usage": "Lead generation for a medical device company",
"sp_improvement_suggestions": "none"
}
MIPS performance: national run, no filters
{
"datasetType": "mips_performance",
"maxItems": 1000,
"sp_intended_usage": "Quality score benchmarking study",
"sp_improvement_suggestions": "none"
}
Office visit costs: Internal Medicine pricing by ZIP
{
"datasetType": "office_visit_costs",
"specialty": "Internal Medicine",
"maxItems": 500,
"sp_intended_usage": "Patient cost estimation tool",
"sp_improvement_suggestions": "none"
}
Input Parameters
| Field | Type | Default | Description |
|---|---|---|---|
| datasetType | string | clinician |
Dataset to query: clinician, utilization, mips_performance, or office_visit_costs |
| states | string[] | [] (all states) |
One or more U.S. state abbreviations. Applies to clinician and MIPS datasets. |
| specialty | string | "" (all) |
Primary specialty filter. For office visit costs, selects the specialty-specific dataset. |
| providerName | string | "" |
Filter by provider last name. Case-insensitive partial match. Applies to clinician and utilization datasets. |
| maxItems | integer | 100 |
Maximum number of records to return. |
| proxyConfiguration | object | disabled | Proxy settings. Not required — the CMS API is a public government service. |
| sp_intended_usage | string | — | Required. Describe how you plan to use this data. |
| sp_improvement_suggestions | string | — | Required. Feedback or suggestions for this actor. |
CMS Medicare Provider Crawler Output Fields
Output fields are shared across all four datasets. A given record will only have fields populated that apply to its dataset type. The dataset_type field always indicates which mode produced the record.
Clinician Directory Output
{
"npi": "1234567890",
"provider_name": "SMITH, JENNIFER",
"provider_credentials": "MD",
"provider_gender": "F",
"provider_specialty": "CARDIOLOGY",
"provider_secondary_specialties": "INTERNAL MEDICINE",
"facility_name": "Houston Heart Center",
"provider_street_address": "1200 Binz St, Suite 400",
"provider_city": "HOUSTON",
"provider_state": "TX",
"provider_zip": "77004-6832",
"provider_phone": "(713) 555-0192",
"medicare_assignment": "Y",
"telehealth": "Y",
"dataset_type": "clinician"
}
| Field | Description |
|---|---|
| npi | National Provider Identifier — the 10-digit unique provider ID |
| provider_name | Provider full name formatted as LAST, FIRST |
| provider_credentials | Professional credentials (MD, DO, NP, PA, etc.) |
| provider_gender | Provider gender (M or F) |
| provider_specialty | Primary specialty as listed in CMS |
| provider_secondary_specialties | Secondary specialties, comma-separated |
| facility_name | Facility or organization name |
| provider_street_address | Street address (may include suite) |
| provider_city | City |
| provider_state | Two-letter state abbreviation |
| provider_zip | ZIP code formatted as XXXXX or XXXXX-XXXX |
| provider_phone | Phone number formatted as (XXX) XXX-XXXX |
| medicare_assignment | Whether provider accepts Medicare assignment (Y/N) |
| telehealth | Whether provider offers telehealth services (Y/N) |
| dataset_type | Always clinician for this mode |
Utilization Data Output
{
"npi": "1234567890",
"provider_name": "JONES, MICHAEL",
"procedure_category": "Major Joint Replacement or Reattachment of Lower Extremity",
"procedure_count": "51-100",
"dataset_type": "utilization"
}
| Field | Description |
|---|---|
| npi | National Provider Identifier |
| provider_name | Provider full name formatted as LAST, FIRST |
| procedure_category | Procedure category name |
| procedure_count | Procedure volume range (e.g. 1-10, 11-20, 51-100) |
| dataset_type | Always utilization for this mode |
MIPS Performance Output
{
"npi": "1234567890",
"provider_name": "PATEL, ANITA",
"mips_final_score": 87.4,
"quality_score": 45.0,
"cost_score": 18.2,
"pi_score": 25.0,
"ia_score": 0.0,
"dataset_type": "mips_performance"
}
| Field | Description |
|---|---|
| npi | National Provider Identifier |
| provider_name | Provider full name formatted as LAST, FIRST |
| mips_final_score | MIPS composite score (0–100) for performance year 2023 |
| quality_score | Quality performance category score |
| cost_score | Cost performance category score |
| pi_score | Promoting interoperability category score |
| ia_score | Improvement activities category score |
| dataset_type | Always mips_performance for this mode |
Office Visit Costs Output
{
"specialty": "Internal Medicine",
"zip_code": "77004",
"new_patient_cost_min": 112.50,
"new_patient_cost_max": 209.75,
"established_patient_cost_min": 68.30,
"established_patient_cost_max": 154.00,
"new_patient_copay_min": 28.13,
"new_patient_copay_max": 52.44,
"established_patient_copay_min": 17.08,
"established_patient_copay_max": 38.50,
"dataset_type": "office_visit_costs"
}
| Field | Description |
|---|---|
| specialty | Specialty name as used by CMS |
| zip_code | ZIP code for this pricing row |
| new_patient_cost_min | Minimum Medicare pricing for a new patient office visit (USD) |
| new_patient_cost_max | Maximum Medicare pricing for a new patient office visit (USD) |
| established_patient_cost_min | Minimum Medicare pricing for an established patient office visit (USD) |
| established_patient_cost_max | Maximum Medicare pricing for an established patient office visit (USD) |
| new_patient_copay_min | Minimum patient copay for a new patient office visit (USD) |
| new_patient_copay_max | Maximum patient copay for a new patient office visit (USD) |
| established_patient_copay_min | Minimum patient copay for an established patient office visit (USD) |
| established_patient_copay_max | Maximum patient copay for an established patient office visit (USD) |
| dataset_type | Always office_visit_costs for this mode |
FAQ
How many providers does the CMS clinician directory cover? The CMS National Downloadable File contains 2.8 million Medicare provider records — every clinician enrolled in Medicare, including physicians, nurse practitioners, physician assistants, dentists, and other practitioners.
Can I get the full dataset without filters?
Yes. Leave states and specialty empty and the actor will paginate through the entire dataset up to your maxItems limit. A full national clinician pull at 2.8M records will take several hours. Use state or specialty filters if you only need a subset.
Do I need proxies to run this actor? No. The CMS Provider Data API is a U.S. government public service that requires no authentication and imposes no strict rate limits. The actor runs proxy-disabled by default and adds a 150ms delay between requests as a courtesy.
What is the difference between utilization and clinician data? The clinician dataset contains contact and credential information — who providers are, where they practice, and whether they accept Medicare. The utilization dataset shows what procedures they perform and in what volume. Both records carry the NPI key, so you can join them if needed.
Which specialties are available for office visit costs? 55 specialties are covered, including Internal Medicine, Family Practice, Cardiology, Orthopedic Surgery, Neurology, Psychiatry, Nurse Practitioner, Physician Assistant, and others. The specialty filter maps directly to a specialty-specific CMS dataset. If a specialty is not in the dropdown, it is not available in the underlying CMS data.
What performance year does MIPS data cover? The MIPS performance dataset covers performance year 2023 (PY 2023) — the most recent CMS public reporting data at time of build.
Can I filter utilization or MIPS data by state? State filtering applies to the clinician dataset only. The CMS API exposes a state field on that dataset but not on utilization or MIPS schemas. For those modes, filter by provider last name or run the full national dataset and post-filter on your side.
Need More Features?
Need a specialty not in the list, a different filter combination, or a scheduled run that refreshes on CMS update cycles? File an issue or get in touch.
Why Use CMS Medicare Provider Crawler?
- Four datasets, one actor — Clinician directory, utilization, MIPS performance, and office visit costs are all accessible from a single configured run, not four separate tools to manage and pay for separately.
- Government source, no intermediary — Data comes directly from the CMS Provider Data API, the same source that powers Medicare's official provider search tools. No reseller markup, no stale cache.
- Priced per record — A targeted state-specialty filter returning 2,000 cardiologists in Texas costs a fraction of a full national pull. Both are priced per event, not per subscription seat.