NPPES US Provider Directory Scraper

Extract public US healthcare provider records from the official CMS NPI Registry API. Search doctors, organizations, NPIs, locations, credentials, and registry details for lead generation, compliance checks, enrichment, healthcare analytics, and provider directory workflows.

🚀 Use Cases

• Healthcare Provider Directory Enrichment: Update your database with official NPI data.
• NPI Lookup & Validation: Instantly verify National Provider Identifiers.
• Provider Lead Generation: Identify healthcare providers by specialty or location.
• Credential & Location Research: Research provider credentials and practice addresses.
• Healthcare Market Research: Analyze provider distribution across regions.
• CRM Enrichment: Automate the addition of professional details to your CRM.
• Compliance & Data QA: Ensure provider data matches the official registry.

🛠 What it Does

This actor provides a streamlined interface to the CMS NPI Registry API, handling the technical complexities of request formatting, pagination, and data normalization.

• Search Providers: Filter by name, organization, city, state, ZIP, taxonomy, or entity type.
• Lookup by NPI: Retrieve the full record for a specific National Provider Identifier.
• Probe API: Quickly verify the connectivity and status of the official registry.
• Normalized Output: Receive clean, structured data ready for export or integration.
• Run Summary: Get a concise summary of processed records and status in the Key-Value Store.

📥 Inputs

Field	Type	Description
operation	string	Required. Operation to perform: probe, search, or item.
npi	string	Exact 10-digit NPI (for item operation).
first_name	string	Exact first name (for search operation).
last_name	string	Exact last name (for search operation).
organization_name	string	Exact organization name (for search operation).
city	string	Exact city (for search operation).
state	string	Exact 2-letter state code (for search operation).
zip_code	string	Exact 5-digit ZIP code (for search operation).
entity_type	string	Entity type: I (Individual) or O (Organization).
taxonomy_code	string	Exact taxonomy code (for search operation).
page	integer	Page number (default: 1, minimum: 1).
limit	integer	Results per page (default: 10, minimum: 1, maximum: 200).

📤 Outputs

Dataset (Provider Records)

Each item in the dataset represents a normalized provider record:

• npi: National Provider Identifier
• first_name, last_name, middle_name: Provider's full name
• organization_name: Name of the organization
• credential: Professional credential (e.g., MD, DO, NP)
• provider_gender: Provider gender (M/F)
• address_1, city, state, postal_code: Primary practice location
• enumeration_type: Registry enumeration type
• last_update_date: Last record update date
• is_sole_proprietor: Sole proprietor indicator
• taxonomy_primary_code: Primary specialty code
• taxonomies: Full list of specialties and licenses
• other_names: Alternative names
• practice_locations: All registered addresses
• endpoints: EHR endpoints
• raw_record: The complete original response from CMS API

Key-Value Store (Run Summary)

The OUTPUT key contains a summary of the run:

• status: Run status (e.g., success, not_found, error)
• total: Total matching records in registry (search)
• processed: Records exported to dataset (search)
• npi: The specific NPI looked up (item)
• api_available: Boolean indicating API connectivity (probe)

💡 Examples

Exact NPI Lookup

{
  "operation": "item",
  "npi": "1003979261"
}

Search Providers in New York

{
  "operation": "search",
  "first_name": "Michael",
  "city": "NEW YORK",
  "limit": 5
}

Check API Status

{
  "operation": "probe"
}

📉 Limits & Performance

• Maximum Results: 200 records per page.
• Pagination: Use the page parameter to retrieve subsequent results.
• Rate Limiting: The actor adheres to public API guidelines to ensure reliability.
• No Proxy Required: Works directly with the official public API.

⚖️ Data Source & Disclaimers

Data Source: This actor extracts data from the official CMS NPI Registry API.

• Public Data: All information is public registry data.
• No Affiliation: This actor is not affiliated with, endorsed by, or connected to CMS, HHS, or NPPES.
• No Medical Advice: This tool provides directory information and does not constitute medical advice or recommendations.
• Lawful Use: Users are responsible for the lawful use of the extracted data.
• Freshness: Data freshness depends entirely on the official CMS registry updates.

💰 Value Proposition

Built for reliable, repeatable provider data extraction without the need to maintain your own NPI API wrapper or handle raw JSON parsing.