# NPPES NPI Provider Scraper (`scrapers_lat/nppes-npi-scraper`) Actor
Scrape US healthcare provider records from the official NPPES NPI Registry. Search by name, organization, specialty, city, state, ZIP or NPI number. Export to JSON, CSV, Excel.
- **URL**: https://apify.com/scrapers\_lat/nppes-npi-scraper.md
- **Developed by:** [Michael Flores](https://apify.com/scrapers_lat) (community)
- **Categories:** Business, Lead generation, Automation
- **Stats:** 2 total users, 0 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet
## Pricing
from $8.00 / 1,000 results
This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
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
## NPPES NPI Provider Scraper
> Extract US healthcare provider records from the official NPPES NPI Registry, covering every individual clinician and organization across all 50 states and US territories
35 fields per record
US + territories coverage
JSON / CSV / Excel output formats
Updated 2026-06-22
### What you get
Each record is one healthcare provider from the National Plan and Provider Enumeration System (NPPES), the official US registry behind every NPI number. You can search by name, organization, specialty, city, state, ZIP or look up exact NPI numbers, then export the full record set.
- **npi**: the provider's 10-digit National Provider Identifier
- **enumerationType**: NPI-1 for an individual clinician, NPI-2 for an organization
- **status**: Active or Deactivated
- **organizationName**: legal name for organization (NPI-2) providers
- **firstName**: individual provider first name
- **lastName**: individual provider last name
- **middleName**: individual provider middle name
- **namePrefix**: individual name prefix such as Dr. or Mrs.
- **nameSuffix**: individual name suffix such as Jr.
- **credential**: individual credentials such as MD, DDS, RN
- **gender**: Male or Female for individual providers
- **soleProprietor**: whether an individual provider is a sole proprietor
- **authorizedOfficialName**: the authorized official for an organization
- **authorizedOfficialTitle**: that official's role such as Owner or Director
- **authorizedOfficialPhone**: that official's contact phone
- **primaryTaxonomyCode**: NUCC taxonomy code for the primary specialty
- **primaryTaxonomyDesc**: primary specialty description such as Dentist or Pharmacy
- **primaryTaxonomyLicense**: state license number tied to the primary specialty
- **primaryTaxonomyState**: state that issued the primary license
- **practiceAddress**: practice location street address
- **practiceCity**: practice location city
- **practiceState**: practice location state
- **practiceZip**: practice location ZIP code
- **practicePhone**: practice location phone
- **practiceFax**: practice location fax
- **mailingAddress**: mailing street address
- **mailingCity**: mailing city
- **mailingState**: mailing state
- **mailingZip**: mailing ZIP code
- **mailingPhone**: mailing phone
- **enumerationDate**: date the NPI was first issued
- **lastUpdated**: date the registry record was last updated
- **allTaxonomies**: full list of taxonomies with code, description, license and state
- **otherNames**: other or doing-business-as names for the provider
- **otherIdentifiers**: other provider IDs such as Medicaid and payer-issued numbers, each with its type, code, state and issuer
- **endpoints**: secure health-data exchange endpoints (FHIR and Direct messaging addresses) with type, use, content type and affiliation
- **observedAt**: when this record was collected by the scraper
### Who is it for
| Use case | Who benefits |
|---|---|
| Build targeted provider mailing and call lists by specialty and state | Healthcare sales and lead generation teams |
| Verify NPI numbers, licenses and active status in bulk | Medical billing and credentialing teams |
| Enrich CRM and EHR records with clean practice and contact data | Health-tech and revenue-cycle vendors |
| Map provider density by specialty, city or ZIP | Market researchers and health economists |
| Recruit clinicians by specialty and location | Healthcare staffing and recruiting agencies |
### Frequently Asked Questions
**Does this cover the whole United States?**
Yes. The NPPES NPI Registry is the national US registry, so the actor reaches every individual provider and organization across all 50 states, the District of Columbia and US territories including Puerto Rico, Guam and the Virgin Islands. Filter by the two-letter state code to narrow results.
**How many providers can one search return?**
The official NPPES API caps a single search query at roughly 1200 matching records. For larger pulls, split your search into narrower queries, for example by adding a city, postal code or a specific taxonomy, and run them separately. Looking up exact NPI numbers has no such cap.
**Can I search by medical specialty?**
Yes. Use the Taxonomy / Specialty field with a description such as Dentist, Pharmacy, Internal Medicine or Chiropractor. You can combine it with a state, city or ZIP code, and restrict to individuals or organizations.
**Can I look up specific providers by NPI?**
Yes. Paste a list of 10-digit NPI numbers into the NPI Numbers field and the actor fetches each provider directly, ignoring the search filters. Invalid or missing NPIs are reported in the output rather than silently dropped.
**What happens when a field has no value?**
Fields that do not apply are returned as null and are never invented. Individual-only fields such as gender and credential are null for organizations, and organization-only fields such as authorized official are null for individuals.
### Related scrapers
Need data from the same space? Here are other scrapers we build and maintain:
- [USAspending Federal Award Scraper](https://apify.com/scrapers_lat/usaspending-awards-scraper): Scrape US federal prime awards from USAspending.gov. Get recipient, UEI, award amount, awarding...
- [Grants.gov Opportunity Scraper](https://apify.com/scrapers_lat/grants-gov-scraper): Extract U.S. federal grant opportunities from the official Grants.gov API. Scrape title, agency...
- [BizQuest Businesses-for-Sale Listings Scraper](https://apify.com/scrapers_lat/bizquest-scraper): Extract US businesses-for-sale listings from BizQuest with the broker or seller contact (name...
- [California CSLB Contractor License Scraper](https://apify.com/scrapers_lat/california-cslb-scraper): Extract licensed California contractor records from the CSLB public data portal by classification...
- [Florida Professional License Scraper](https://apify.com/scrapers_lat/florida-dbpr-scraper): Scrape Florida DBPR professional license records by name, business, or license number. Get licensee...
- [New York Business Entity Scraper](https://apify.com/scrapers_lat/ny-dos-business-scraper): Search and extract New York business entity records (corporations, LLCs, limited partnerships) from...
### More scrapers at scrapers.lat
This actor is built and maintained by [scrapers.lat](https://scrapers.lat), where we publish scrapers for Latin American and US public platforms: real estate, jobs, e-commerce, company registries and government data. Browse the full catalog, see live sample output for each one, or ask us for a custom scraper at [scrapers.lat](https://scrapers.lat).
---
> This actor is an independent tool and has no affiliation with the Centers for Medicare and Medicaid Services or NPPES. It accesses only the NPI Registry data that CMS publishes as a public record under federal law. NPI data is intentionally public, but provider names, practice locations and contact details are personal and practice information about real people. Use this data lawfully and responsibly: respect the NPPES terms of use, applicable privacy and anti-spam laws, and GDPR-style data-protection principles where they apply. Do not use it to harass providers or for any purpose prohibited by law.
# Actor input Schema
## `maxItems` (type: `integer`):
Maximum number of provider records to collect across all pages. Optional. The NPPES API returns at most around 1200 records per single search query, so for larger pulls narrow your filters (for example add a city or taxonomy).
## `npiNumbers` (type: `array`):
Look up specific providers by their 10-digit NPI number. When this list is filled, the search filters below are ignored and each NPI is fetched directly. One NPI per line.
## `enumerationType` (type: `string`):
Restrict the search to individual providers (NPI-1) or organizations (NPI-2). Leave as Any to return both.
## `firstName` (type: `string`):
Individual provider first name. Supports a trailing wildcard, for example john*.
## `lastName` (type: `string`):
Individual provider last name. Supports a trailing wildcard, for example sm*.
## `organizationName` (type: `string`):
Organization (NPI-2) name. Supports a trailing wildcard, for example dental*.
## `taxonomyDescription` (type: `string`):
Provider taxonomy description, that is the medical specialty, for example Dentist, Pharmacy, Internal Medicine, Chiropractor.
## `city` (type: `string`):
City of the provider address.
## `state` (type: `string`):
Two-letter US state or territory code, for example CA, NY, TX, PR.
## `postalCode` (type: `string`):
US ZIP code. Supports a trailing wildcard, for example 902*.
## `proxyConfiguration` (type: `object`):
Optional. The NPPES NPI Registry is a public, open API and does not require a proxy. Leave disabled unless you specifically need to route requests through a proxy.
## Actor input object example
```json
{
"maxItems": 50,
"enumerationType": "",
"state": "",
"proxyConfiguration": {
"useApifyProxy": false
}
}
````
# Actor output Schema
## `results` (type: `string`):
No description
# 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 = {
"maxItems": 50
};
// Run the Actor and wait for it to finish
const run = await client.actor("scrapers_lat/nppes-npi-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 = { "maxItems": 50 }
# Run the Actor and wait for it to finish
run = client.actor("scrapers_lat/nppes-npi-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 '{
"maxItems": 50
}' |
apify call scrapers_lat/nppes-npi-scraper --silent --output-dataset
```
## MCP server setup
```json
{
"mcpServers": {
"apify": {
"command": "npx",
"args": [
"mcp-remote",
"https://mcp.apify.com/?tools=scrapers_lat/nppes-npi-scraper",
"--header",
"Authorization: Bearer "
]
}
}
}
```
## OpenAPI specification
```json
{
"openapi": "3.0.1",
"info": {
"title": "NPPES NPI Provider Scraper",
"description": "Scrape US healthcare provider records from the official NPPES NPI Registry. Search by name, organization, specialty, city, state, ZIP or NPI number. Export to JSON, CSV, Excel.",
"version": "0.1",
"x-build-id": "SGVfXwsily2IMbrUk"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/scrapers_lat~nppes-npi-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-scrapers_lat-nppes-npi-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/scrapers_lat~nppes-npi-scraper/runs": {
"post": {
"operationId": "runs-sync-scrapers_lat-nppes-npi-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/scrapers_lat~nppes-npi-scraper/run-sync": {
"post": {
"operationId": "run-sync-scrapers_lat-nppes-npi-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",
"properties": {
"maxItems": {
"title": "Max Items",
"minimum": 1,
"maximum": 1000000,
"type": "integer",
"description": "Maximum number of provider records to collect across all pages. Optional. The NPPES API returns at most around 1200 records per single search query, so for larger pulls narrow your filters (for example add a city or taxonomy)."
},
"npiNumbers": {
"title": "NPI Numbers",
"type": "array",
"description": "Look up specific providers by their 10-digit NPI number. When this list is filled, the search filters below are ignored and each NPI is fetched directly. One NPI per line.",
"items": {
"type": "string"
}
},
"enumerationType": {
"title": "Provider Type",
"enum": [
"",
"NPI-1",
"NPI-2"
],
"type": "string",
"description": "Restrict the search to individual providers (NPI-1) or organizations (NPI-2). Leave as Any to return both.",
"default": ""
},
"firstName": {
"title": "First Name",
"type": "string",
"description": "Individual provider first name. Supports a trailing wildcard, for example john*."
},
"lastName": {
"title": "Last Name",
"type": "string",
"description": "Individual provider last name. Supports a trailing wildcard, for example sm*."
},
"organizationName": {
"title": "Organization Name",
"type": "string",
"description": "Organization (NPI-2) name. Supports a trailing wildcard, for example dental*."
},
"taxonomyDescription": {
"title": "Taxonomy / Specialty",
"type": "string",
"description": "Provider taxonomy description, that is the medical specialty, for example Dentist, Pharmacy, Internal Medicine, Chiropractor."
},
"city": {
"title": "City",
"type": "string",
"description": "City of the provider address."
},
"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",
"RI",
"SC",
"SD",
"TN",
"TX",
"UT",
"VT",
"VA",
"WA",
"WV",
"WI",
"WY",
"AS",
"GU",
"MP",
"PR",
"VI"
],
"type": "string",
"description": "Two-letter US state or territory code, for example CA, NY, TX, PR.",
"default": ""
},
"postalCode": {
"title": "Postal Code",
"type": "string",
"description": "US ZIP code. Supports a trailing wildcard, for example 902*."
},
"proxyConfiguration": {
"title": "Proxy Configuration",
"type": "object",
"description": "Optional. The NPPES NPI Registry is a public, open API and does not require a proxy. Leave disabled unless you specifically need to route requests through a proxy.",
"default": {
"useApifyProxy": false
}
}
}
},
"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
}
}
}
}
}
}
}
}
}
}
```