# CMS Physician Compare Scraper (`crawlerbros/cms-physician-compare-scraper`) Actor Search and extract Medicare physician and healthcare provider data from the CMS Physician Compare dataset. Search by name, specialty, state, or NPI number. Covers 2M+ providers. No API key required. - **URL**: https://apify.com/crawlerbros/cms-physician-compare-scraper.md - **Developed by:** [Crawler Bros](https://apify.com/crawlerbros) (community) - **Categories:** Automation, Lead generation, Developer tools - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $3.00 / 1,000 results This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## CMS Physician Compare Scraper Extract physician and healthcare provider data from the **CMS Physician Compare** dataset — the official Medicare provider database maintained by the Centers for Medicare & Medicaid Services. Search by name, specialty, state, or NPI number across 2 million+ providers. No API key or account required. Whether you are building provider directories, conducting healthcare market research, or verifying practitioner credentials, this actor delivers structured, export-ready data from CMS's public API. --- ### What You Can Scrape - **Physician profiles** — Name, specialty, credentials, graduation year, medical school - **Practice location** — Address, city, state, zip code, phone number - **Medicare participation** — Whether the provider accepts Medicare assignment - **Telehealth availability** — Providers offering telemedicine services - **Secondary specialties** — Additional board certifications beyond the primary specialty - **NPI lookup** — Direct lookup by 10-digit National Provider Identifier --- ### Key Features - Search by last name and/or first name - Filter by medical specialty (65+ specialties as dropdown) - Filter by US state or territory (all 50 states + DC, PR, GU, VI, AS, MP) - Filter by gender - Filter to providers accepting Medicare assignment - Direct NPI number lookup (getByNPI mode) - Browse all providers in a specialty (searchBySpecialty mode) - No authentication or API key required --- ### Input Parameters | Parameter | Type | Description | Default | |-----------|------|-------------|---------| | `mode` | Select | What to search: by name/filters, by NPI, or by specialty | `searchPhysicians` | | `lastName` | Text | Provider last name to search | — | | `firstName` | Text | Provider first name filter | — | | `specialty` | Select | Medical specialty (65+ options) | — | | `state` | Select | US state or territory (2-letter code) | — | | `npi` | Text | 10-digit NPI number (getByNPI mode) | — | | `gender` | Select | Provider gender: Any, Male, Female | — | | `acceptsMedicare` | Boolean | Only show providers accepting Medicare | `false` | | `maxItems` | Integer | Maximum records to return (1–200) | `50` | #### Supported Medical Specialties (sample) Addiction Medicine · Anesthesiology · Cardiac Surgery · Cardiovascular Disease (Cardiology) · Chiropractic · Clinical Psychologist · Dermatology · Emergency Medicine · Endocrinology · Family Practice · Gastroenterology · General Surgery · Hematology/Oncology · Infectious Disease · Internal Medicine · Nephrology · Neurology · Neurosurgery · Nurse Practitioner · Obstetrics/Gynecology · Ophthalmology · Orthopedic Surgery · Pain Management · Pediatric Medicine · Psychiatry · Pulmonary Disease · Radiation Oncology · Rheumatology · Urology · Vascular Surgery · and 35+ more --- ### Output Fields | Field | Type | Description | |-------|------|-------------| | `npi` | String | National Provider Identifier (10 digits) | | `lastName` | String | Provider last name | | `firstName` | String | Provider first name | | `middleName` | String | Provider middle name | | `suffix` | String | Name suffix (e.g. MD, DO) | | `credentials` | String | Professional credentials (e.g. MD, FACC) | | `gender` | String | Provider gender (Male / Female) | | `medicalSchool` | String | Medical school attended | | `graduationYear` | Integer | Year of graduation | | `specialty` | String | Primary medical specialty | | `secondarySpecialties` | Array | Additional specialties (when available) | | `offersTelemedicine` | Boolean | Whether the provider offers telemedicine | | `facilityName` | String | Practice facility or group name | | `address` | String | Street address | | `city` | String | City or town | | `state` | String | State code (e.g. CA, NY) | | `zipCode` | String | 5-digit ZIP code | | `phone` | String | Phone number (formatted as (XXX) XXX-XXXX) | | `acceptsMedicareAssignment` | Boolean | Individual Medicare assignment status | | `groupAcceptsMedicareAssignment` | Boolean | Group/practice Medicare assignment status | | `sourceUrl` | String | Link to provider profile on CMS Provider Data | | `recordType` | String | Always `physician` | | `scrapedAt` | String | ISO timestamp when the record was scraped | --- ### Example Use Cases 1. **Provider directory building** — Find all cardiologists in California by setting `specialty=CARDIOVASCULAR DISEASE (CARDIOLOGY)` and `state=CA`. 2. **Credential verification** — Look up a specific provider by NPI number to verify their specialty and Medicare participation status. 3. **Healthcare market research** — Count providers by specialty and state to analyze market density. 4. **Medicare network analysis** — Filter by `acceptsMedicare=true` to identify Medicare-participating providers in a region. 5. **Telehealth provider discovery** — Find telemedicine-capable providers in a specialty by combining `specialty` and `acceptsMedicare` filters. --- ### Data Source This actor uses the **CMS Provider Data Catalog** (Physician Compare dataset, resource ID `mj5m-pzi6`), maintained by the Centers for Medicare & Medicaid Services. Data covers Medicare-enrolled physicians and other eligible professionals. The dataset is updated regularly by CMS and is freely available without registration. --- ### Frequently Asked Questions **Do I need an API key or CMS account?** No. The CMS Provider Data Catalog is a public API that does not require authentication. **What is an NPI number?** The National Provider Identifier (NPI) is a unique 10-digit identification number for covered healthcare providers. It is required for electronic transactions and uniquely identifies each provider. **How many providers are in the database?** The Physician Compare dataset covers over 2 million Medicare-enrolled healthcare providers. **Can I filter by city?** The CMS API supports filtering by state and zip code, but not directly by city name. Use the `state` filter to narrow results geographically. **What does "accepts Medicare assignment" mean?** A provider who accepts Medicare assignment agrees to accept Medicare's approved payment amount as full payment. This means lower out-of-pocket costs for patients. **Are all doctor types included?** The dataset includes physicians and other eligible professionals: nurse practitioners, physician assistants, chiropractors, physical therapists, psychologists, and many other healthcare provider types. **Why might a provider not appear in results?** Providers who are not enrolled in Medicare or who have voluntarily opted out will not appear in this dataset. **Is name matching case-sensitive?** The actor automatically converts name input to uppercase to match the CMS database format. **Can I get providers in US territories?** Yes. Puerto Rico (PR), Guam (GU), Virgin Islands (VI), American Samoa (AS), and Northern Mariana Islands (MP) are included in the state filter. # Actor input Schema ## `mode` (type: `string`): What to search: physicians by name/specialty/location, by NPI number, or browse by specialty. ## `lastName` (type: `string`): Provider last name to search by (partial match supported). ## `firstName` (type: `string`): Provider first name to filter by (optional). ## `specialty` (type: `string`): Filter by primary medical specialty. ## `state` (type: `string`): Filter by US state or territory. ## `npi` (type: `string`): National Provider Identifier (10-digit NPI number) for a specific physician. Used in getByNPI mode. ## `gender` (type: `string`): Filter by provider gender (optional). ## `acceptsMedicare` (type: `boolean`): When enabled, only return providers who accept Medicare assignment. ## `maxItems` (type: `integer`): Maximum number of providers to return (1-200). ## Actor input object example ```json { "mode": "searchPhysicians", "lastName": "Smith", "specialty": "CARDIOVASCULAR DISEASE (CARDIOLOGY)", "npi": "1104481472", "acceptsMedicare": false, "maxItems": 20 } ```` # Actor output Schema ## `items` (type: `string`): Dataset containing all scraped physician/provider records. # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "mode": "searchPhysicians", "lastName": "Smith", "specialty": "CARDIOVASCULAR DISEASE (CARDIOLOGY)", "npi": "1104481472", "acceptsMedicare": false, "maxItems": 20 }; // Run the Actor and wait for it to finish const run = await client.actor("crawlerbros/cms-physician-compare-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "mode": "searchPhysicians", "lastName": "Smith", "specialty": "CARDIOVASCULAR DISEASE (CARDIOLOGY)", "npi": "1104481472", "acceptsMedicare": False, "maxItems": 20, } # Run the Actor and wait for it to finish run = client.actor("crawlerbros/cms-physician-compare-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "mode": "searchPhysicians", "lastName": "Smith", "specialty": "CARDIOVASCULAR DISEASE (CARDIOLOGY)", "npi": "1104481472", "acceptsMedicare": false, "maxItems": 20 }' | apify call crawlerbros/cms-physician-compare-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=crawlerbros/cms-physician-compare-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "CMS Physician Compare Scraper", "description": "Search and extract Medicare physician and healthcare provider data from the CMS Physician Compare dataset. Search by name, specialty, state, or NPI number. Covers 2M+ providers. No API key required.", "version": "1.0", "x-build-id": "d8HQvVLQue6gpA3aL" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/crawlerbros~cms-physician-compare-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-crawlerbros-cms-physician-compare-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/crawlerbros~cms-physician-compare-scraper/runs": { "post": { "operationId": "runs-sync-crawlerbros-cms-physician-compare-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/crawlerbros~cms-physician-compare-scraper/run-sync": { "post": { "operationId": "run-sync-crawlerbros-cms-physician-compare-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "mode" ], "properties": { "mode": { "title": "Mode", "enum": [ "searchPhysicians", "getByNPI", "searchBySpecialty" ], "type": "string", "description": "What to search: physicians by name/specialty/location, by NPI number, or browse by specialty.", "default": "searchPhysicians" }, "lastName": { "title": "Last name", "type": "string", "description": "Provider last name to search by (partial match supported)." }, "firstName": { "title": "First name", "type": "string", "description": "Provider first name to filter by (optional)." }, "specialty": { "title": "Medical specialty", "enum": [ "", "ADDICTION MEDICINE", "ADVANCED HEART FAILURE AND TRANSPLANT CARDIOLOGY", "ANESTHESIOLOGY", "CARDIAC ELECTROPHYSIOLOGY", "CARDIAC SURGERY", "CARDIOVASCULAR DISEASE (CARDIOLOGY)", "CERTIFIED CLINICAL NURSE SPECIALIST (CNS)", "CERTIFIED REGISTERED NURSE ANESTHETIST (CRNA)", "CHIROPRACTIC", "CLINICAL PSYCHOLOGIST", "CLINICAL SOCIAL WORKER", "COLORECTAL SURGERY (PROCTOLOGY)", "CRITICAL CARE (INTENSIVISTS)", "DENTIST", "DERMATOLOGY", "DIAGNOSTIC RADIOLOGY", "EMERGENCY MEDICINE", "ENDOCRINOLOGY", "FAMILY PRACTICE", "GASTROENTEROLOGY", "GENERAL PRACTICE", "GENERAL SURGERY", "GERIATRIC MEDICINE", "GYNECOLOGICAL ONCOLOGY", "HAND SURGERY", "HEMATOLOGY/ONCOLOGY", "HOSPICE/PALLIATIVE CARE", "HOSPITALIST", "INFECTIOUS DISEASE", "INTERNAL MEDICINE", "INTERVENTIONAL CARDIOLOGY", "INTERVENTIONAL RADIOLOGY", "MARRIAGE AND FAMILY THERAPIST", "MENTAL HEALTH COUNSELOR", "NEPHROLOGY", "NEUROLOGY", "NEUROSURGERY", "NUCLEAR MEDICINE", "NURSE PRACTITIONER", "OBSTETRICS/GYNECOLOGY", "OCCUPATIONAL THERAPIST IN PRIVATE PRACTICE", "OPHTHALMOLOGY", "OPTOMETRY", "ORTHOPEDIC SURGERY", "OSTEOPATHIC MANIPULATIVE MEDICINE", "OTOLARYNGOLOGY", "PAIN MANAGEMENT", "PATHOLOGY", "PEDIATRIC MEDICINE", "PHYSICAL MEDICINE AND REHABILITATION", "PHYSICAL THERAPIST IN PRIVATE PRACTICE", "PHYSICIAN ASSISTANT", "PLASTIC AND RECONSTRUCTIVE SURGERY", "PODIATRY", "PREVENTIVE MEDICINE", "PSYCHIATRY", "PULMONARY DISEASE", "QUALIFIED AUDIOLOGIST", "QUALIFIED SPEECH LANGUAGE PATHOLOGIST", "RADIATION ONCOLOGY", "REGISTERED DIETITIAN OR NUTRITION PROFESSIONAL", "RHEUMATOLOGY", "SPORTS MEDICINE", "SURGICAL ONCOLOGY", "UROLOGY", "VASCULAR SURGERY" ], "type": "string", "description": "Filter by primary medical specialty." }, "state": { "title": "State", "enum": [ "", "AL", "AK", "AZ", "AR", "CA", "CO", "CT", "DE", "DC", "FL", "GA", "HI", "ID", "IL", "IN", "IA", "KS", "KY", "LA", "ME", "MD", "MA", "MI", "MN", "MS", "MO", "MT", "NE", "NV", "NH", "NJ", "NM", "NY", "NC", "ND", "OH", "OK", "OR", "PA", "PR", "RI", "SC", "SD", "TN", "TX", "UT", "VT", "VA", "WA", "WV", "WI", "WY", "GU", "VI", "AS", "MP" ], "type": "string", "description": "Filter by US state or territory." }, "npi": { "title": "NPI number", "type": "string", "description": "National Provider Identifier (10-digit NPI number) for a specific physician. Used in getByNPI mode." }, "gender": { "title": "Gender", "enum": [ "", "M", "F" ], "type": "string", "description": "Filter by provider gender (optional)." }, "acceptsMedicare": { "title": "Accepts Medicare assignment", "type": "boolean", "description": "When enabled, only return providers who accept Medicare assignment.", "default": false }, "maxItems": { "title": "Max items", "minimum": 1, "maximum": 200, "type": "integer", "description": "Maximum number of providers to return (1-200).", "default": 50 } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```