# NPI Registry Scraper (`crawlerbros/npi-registry-scraper`) Actor Scrape the CMS National Provider Identifier (NPI) Registry, the official database of all US healthcare providers. Search by name, state, specialty, or organization, or look up a specific provider by NPI number. - **URL**: https://apify.com/crawlerbros/npi-registry-scraper.md - **Developed by:** [Crawler Bros](https://apify.com/crawlerbros) (community) - **Categories:** Developer tools, Automation, Other - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 4 bookmarks - **User rating**: 5.00 out of 5 stars ## 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 ## NPI Registry Scraper Search and extract US healthcare provider data from the [CMS NPI Registry](https://npiregistry.cms.hhs.gov/) — the official federal database of all licensed healthcare providers in the United States. ### What is the NPI Registry? The National Provider Identifier (NPI) Registry is maintained by the Centers for Medicare & Medicaid Services (CMS). It contains over **8 million healthcare providers** — doctors, nurses, hospitals, pharmacies, and other organizations — all registered under the U.S. HIPAA system. ### What does this scraper extract? Each record includes: | Field | Description | |-------|-------------| | `npi` | 10-digit National Provider Identifier | | `entityType` | `individual` or `organization` | | `firstName` | Provider first name (individuals) | | `lastName` | Provider last name (individuals) | | `organizationName` | Organization name (organizations) | | `credential` | Professional credential, e.g., MD, DO, NP | | `gender` | M / F (individuals) | | `primarySpecialty` | Primary taxonomy / specialty | | `specialties` | All specialties (list) | | `practiceAddress` | Practice street address | | `practiceCity` | Practice city | | `practiceState` | Practice state (2-letter code) | | `practiceZip` | Practice ZIP code | | `practicePhone` | Practice phone number | | `mailingAddress` | Mailing street address | | `mailingCity` | Mailing city | | `mailingState` | Mailing state | | `enumerationDate` | Date NPI was issued | | `certificationDate` | Last certification / update date | | `status` | `A` = Active, `D` = Deactivated | | `url` | Direct NPI Registry profile URL | | `scrapedAt` | Extraction timestamp (ISO 8601) | ### Modes #### 1. Search providers (`searchProviders`) — Default Search by provider name and/or state. Works for individual healthcare providers. **Input:** ```json { "mode": "searchProviders", "firstName": "John", "lastName": "Smith", "state": "CA", "maxItems": 50 } ```` #### 2. Lookup by NPI number (`lookupByNPI`) Fetch the exact record for a known NPI number. **Input:** ```json { "mode": "lookupByNPI", "npiNumber": "1234567890" } ``` #### 3. Search by specialty (`searchBySpecialty`) Filter providers by taxonomy description or medical specialty. **Input:** ```json { "mode": "searchBySpecialty", "specialtyDescription": "Cardiology", "state": "NY", "maxItems": 100 } ``` #### 4. Search organizations (`searchByOrganization`) Search for hospitals, clinics, group practices, pharmacies, etc. **Input:** ```json { "mode": "searchByOrganization", "organizationName": "Mayo Clinic", "state": "MN" } ``` ### Sample Output ```json { "npi": "1234567890", "entityType": "individual", "firstName": "John", "lastName": "Smith", "credential": "MD", "gender": "M", "primarySpecialty": "Internal Medicine", "specialties": ["Internal Medicine"], "practiceAddress": "123 Medical Center Dr", "practiceCity": "Los Angeles", "practiceState": "CA", "practiceZip": "90001", "practicePhone": "310-555-0100", "enumerationDate": "2005-06-15", "certificationDate": "2024-01-01", "status": "A", "url": "https://npiregistry.cms.hhs.gov/provider-view/1234567890", "scrapedAt": "2026-05-23T10:00:00+00:00" } ``` ### Use Cases - **Lead generation for healthcare** — Find doctors, specialists, or organizations by state and specialty - **Provider directories** — Build or update healthcare provider databases - **Credentialing** — Verify provider NPI numbers and license information - **Healthcare analytics** — Analyze provider distribution by specialty, state, or city - **Medical billing** — Validate NPI numbers for insurance claims processing - **Research** — Study provider demographics and specialty distribution ### Filters Available | Filter | Applies to modes | |--------|-----------------| | `firstName` | searchProviders, searchBySpecialty | | `lastName` | searchProviders, searchBySpecialty | | `organizationName` | searchByOrganization | | `state` | All except lookupByNPI | | `city` | All except lookupByNPI | | `postalCode` | All except lookupByNPI | | `specialtyDescription` | searchBySpecialty | ### Data Source The NPI Registry is a free public API maintained by CMS (Centers for Medicare & Medicaid Services). No API key, login, or proxy is required. **API documentation:** https://npiregistry.cms.hhs.gov/api-page ### FAQs **Q: Is this data free to use?** A: Yes. The NPI Registry is a public U.S. government database. Data is freely available under government open data policies. **Q: How many providers are in the registry?** A: Over 8 million individual providers and organizations are registered. **Q: What is an NPI number?** A: A National Provider Identifier (NPI) is a unique 10-digit identification number issued to healthcare providers in the U.S. It is required for all HIPAA-covered healthcare transactions. **Q: Can I search for hospitals and clinics?** A: Yes. Use `mode=searchByOrganization` to search for organizations, hospitals, group practices, pharmacies, and other health entities. **Q: What specialties can I search?** A: The NPI registry uses NUCC taxonomy codes. Common specialties: Internal Medicine, Family Practice, Cardiology, Pediatrics, Dermatology, Orthopedic Surgery, and 600+ more. **Q: Why might some fields be absent?** A: Not all providers complete every field. Older registrations may lack credentials, phone numbers, or mailing addresses. **Q: How current is the data?** A: The NPI Registry is updated weekly by CMS with new registrations and address changes. **Q: Can I search by ZIP code?** A: Yes. Use the `postalCode` input field with any 5-digit US ZIP code. # Actor input Schema ## `mode` (type: `string`): What to search in the NPI Registry. ## `firstName` (type: `string`): Provider first name (modes: searchProviders, searchBySpecialty). ## `lastName` (type: `string`): Provider last name (modes: searchProviders, searchBySpecialty). ## `organizationName` (type: `string`): Organization or group name (mode=searchByOrganization). ## `npiNumber` (type: `string`): 10-digit National Provider Identifier. ## `specialtyDescription` (type: `string`): Free-text taxonomy or specialty description to filter by, e.g. 'Internal Medicine', 'Family Practice', 'Cardiology'. ## `state` (type: `string`): US state abbreviation to filter providers. ## `city` (type: `string`): Filter results to providers in this city. ## `postalCode` (type: `string`): Filter results by 5-digit US ZIP code. ## `enumerationType` (type: `string`): Filter by provider type. NPI-1 = individual providers, NPI-2 = organizations. Leave blank for all. Applies to mode=searchProviders. ## `maxItems` (type: `integer`): Maximum number of provider records to return. ## Actor input object example ```json { "mode": "searchProviders", "firstName": "John", "lastName": "Smith", "state": "CA", "enumerationType": "", "maxItems": 50 } ``` # Actor output Schema ## `providers` (type: `string`): Dataset containing all scraped NPI Registry healthcare providers. # 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": "searchProviders", "firstName": "John", "lastName": "Smith", "state": "CA", "maxItems": 50 }; // Run the Actor and wait for it to finish const run = await client.actor("crawlerbros/npi-registry-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": "searchProviders", "firstName": "John", "lastName": "Smith", "state": "CA", "maxItems": 50, } # Run the Actor and wait for it to finish run = client.actor("crawlerbros/npi-registry-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": "searchProviders", "firstName": "John", "lastName": "Smith", "state": "CA", "maxItems": 50 }' | apify call crawlerbros/npi-registry-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=crawlerbros/npi-registry-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "NPI Registry Scraper", "description": "Scrape the CMS National Provider Identifier (NPI) Registry, the official database of all US healthcare providers. Search by name, state, specialty, or organization, or look up a specific provider by NPI number.", "version": "1.0", "x-build-id": "YtxJPB8IRdLTybVAu" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/crawlerbros~npi-registry-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-crawlerbros-npi-registry-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~npi-registry-scraper/runs": { "post": { "operationId": "runs-sync-crawlerbros-npi-registry-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~npi-registry-scraper/run-sync": { "post": { "operationId": "run-sync-crawlerbros-npi-registry-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": [ "searchProviders", "lookupByNPI", "searchBySpecialty", "searchByOrganization" ], "type": "string", "description": "What to search in the NPI Registry.", "default": "searchProviders" }, "firstName": { "title": "First name", "type": "string", "description": "Provider first name (modes: searchProviders, searchBySpecialty)." }, "lastName": { "title": "Last name", "type": "string", "description": "Provider last name (modes: searchProviders, searchBySpecialty)." }, "organizationName": { "title": "Organization name", "type": "string", "description": "Organization or group name (mode=searchByOrganization)." }, "npiNumber": { "title": "NPI number (mode=lookupByNPI)", "type": "string", "description": "10-digit National Provider Identifier." }, "specialtyDescription": { "title": "Specialty description", "type": "string", "description": "Free-text taxonomy or specialty description to filter by, e.g. 'Internal Medicine', 'Family Practice', 'Cardiology'." }, "state": { "title": "State", "enum": [ "", "AK", "AL", "AR", "AZ", "CA", "CO", "CT", "DC", "DE", "FL", "GA", "HI", "IA", "ID", "IL", "IN", "KS", "KY", "LA", "MA", "MD", "ME", "MI", "MN", "MO", "MS", "MT", "NC", "ND", "NE", "NH", "NJ", "NM", "NV", "NY", "OH", "OK", "OR", "PA", "RI", "SC", "SD", "TN", "TX", "UT", "VA", "VT", "WA", "WI", "WV", "WY" ], "type": "string", "description": "US state abbreviation to filter providers." }, "city": { "title": "City", "type": "string", "description": "Filter results to providers in this city." }, "postalCode": { "title": "Postal code (ZIP)", "type": "string", "description": "Filter results by 5-digit US ZIP code." }, "enumerationType": { "title": "Enumeration type (NPI type)", "enum": [ "", "NPI-1", "NPI-2" ], "type": "string", "description": "Filter by provider type. NPI-1 = individual providers, NPI-2 = organizations. Leave blank for all. Applies to mode=searchProviders.", "default": "" }, "maxItems": { "title": "Max items", "minimum": 1, "maximum": 2000, "type": "integer", "description": "Maximum number of provider records to return.", "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 } } } } } } } } } } ```