NPI Registry - Healthcare Provider Search

Search the NPPES NPI Registry for healthcare providers, physicians, and organizations. Look up by NPI number, name, specialty, location, or organization. Perfect for healthcare marketing, provider verification, and medical data enrichment.

Features

Provider Search

• Search Providers - Find individual healthcare providers by name, specialty, location
• Lookup NPI - Get details for a specific NPI number
• Search Organizations - Find healthcare organizations, hospitals, clinics
• Search by Specialty - Find providers by taxonomy/specialty
• Search by Location - Find providers in a specific city, state, or ZIP
• Batch Lookup - Look up multiple NPI numbers at once

Data Available

• Provider name and credentials
• Practice address and phone
• Mailing address
• Taxonomy codes (specialties)
• License information
• Authorized official (for organizations)
• Other identifiers
• Enumeration date

Quick Start

{
  "input": "your input here"
}

Demo Mode

Set demoMode: true to test with sample data (no charges). When you're ready for real results, set demoMode: false or omit it.

{
  "demoMode": true,
  ...
}

Input Parameters

Parameter	Type	Required	Description
task	string	Yes	Operation to perform
npiNumber	string	No	Exact 10-digit NPI number
firstName	string	No	Provider first name
lastName	string	No	Provider last name
organizationName	string	No	Organization name
taxonomyDescription	string	No	Specialty/taxonomy text
city	string	No	City for location search
state	string	No	Two-letter state code
postalCode	string	No	ZIP code
enumerationType	string	No	NPI-1 (individual) or NPI-2 (organization)
npiNumbers	array	No	Array of NPIs for batch lookup
limit	integer	No	Max results (default: 50, max: 200)
skip	integer	No	Results to skip for pagination
webhookUrl	string	No	URL to send results
demoMode	boolean	No	Run with sample data (default: true)

Output Format

Results are saved to the default dataset:

Provider Search Results

{
  "task": "search_providers",
  "success": true,
  "result_count": 15,
  "providers": [
    {
      "number": 1234567890,
      "enumeration_type": "NPI-1",
      "basic": {
        "first_name": "JOHN",
        "last_name": "SMITH",
        "credential": "MD",
        "gender": "M",
        "enumeration_date": "2007-05-23",
        "last_updated": "2024-11-15",
        "status": "A"
      },
      "addresses": [
        {
          "address_purpose": "LOCATION",
          "address_1": "123 Medical Plaza",
          "city": "Los Angeles",
          "state": "CA",
          "postal_code": "90210",
          "telephone_number": "310-555-0100"
        }
      ],
      "taxonomies": [
        {
          "code": "207R00000X",
          "desc": "Internal Medicine",
          "primary": true,
          "state": "CA",
          "license": "A123456"
        }
      ]
    }
  ]
}

Pricing

This actor uses pay-per-event billing: Pay-per-result pricing:

Operation	Cost
Search providers	$0.02
Lookup NPI	$0.01
Search organizations	$0.02
Search by specialty	$0.02
Search by location	$0.02
Batch lookup (per NPI)	$0.01

Use Cases

Healthcare Marketing

• Build targeted provider lists
• Verify provider information
• Enrich CRM data with NPI details

Credentialing

• Verify provider credentials
• Confirm NPI numbers
• Check specialty information

Healthcare Analytics

• Analyze provider distribution
• Track specialty trends
• Geographic analysis

Referral Networks

• Find specialists in an area
• Build referral databases
• Provider directory updates

---

Common Problems & Solutions

"Invalid API key" error

Cause: Your API key is wrong, expired, or doesn't have the right permissions. Fix: Double-check your API key. Make sure you copied it exactly without extra spaces.

"Rate limit exceeded" error

Cause: You've hit the API's rate limits. Fix: Wait a few minutes, then try again. Consider reducing the number of concurrent requests.

Empty or incomplete results

Cause: The target may have anti-scraping protection or the data doesn't exist. Fix:

• Check if the URL/search query is correct
• Try with different parameters
• Some sites may block automated access

Demo data showing instead of real results

Cause: demoMode is still set to true. Fix: Set demoMode: false and provide your API key(s).

---

Built by John Rippy | Actor Arsenal