NPI Registry API — Healthcare Provider Lookup & Enrichment

Search the U.S. NPI Registry (6M+ healthcare providers) and optionally enrich each provider with Google data: website, LinkedIn, social profiles, and secondary emails harvested from the provider's homepage.

📤 Output fields

• NPI # and enumeration type (individual / organization)
• Provider name (first + last + credential) or organization name
• Authorized official (CEO / Medical Director name, title, phone)
• Primary taxonomy (specialty code + description + license)
• Location address (line, city, state, ZIP, phone, fax)
• Mailing address
• Status, enumeration date, last updated
• Google enrichment (optional, +2-4s/record): website, LinkedIn company page, Facebook page, secondary emails parsed from the website

Field	Type	Description
npi	string	10-digit NPI number (unique identifier)
enumerationType	string	NPI-1 (individual) or NPI-2 (organization)
organizationName	string	Legal business name (NPI-2 only)
firstName / lastName / credential	string	Individual provider name (NPI-1 only)
authorizedOfficial	object	{firstName, lastName, title, phone} for organization contact
primaryTaxonomy	object	{code, description, license, state} — provider specialty
locationAddress	object	{line1, line2, city, state, postalCode, phone, fax}
mailingAddress	object	Same structure as locationAddress
status	string	A (active) or D (deactivated)
enumerationDate	string	ISO date the NPI was first issued
lastUpdated	string	ISO date of last record change at CMS
enrichment.website	string	Provider website (when Google enrichment is on)
enrichment.linkedinUrl	string	LinkedIn company page URL
enrichment.facebookUrl	string	Facebook page URL
enrichment.secondaryEmails	array	Emails parsed from the provider's homepage

📥 Input

1. Free-text search — by city, state, ZIP, name, specialty (taxonomy).
2. By NPI # — look up specific 10-digit NPI numbers (bulk).

💻 Code examples

{
  "searchMode": "search",
  "state": "TX",
  "city": "Dallas",
  "taxonomyDescription": "Dentist",
  "maxResults": 100,
  "enrichWithGoogle": true,
  "enrichLimit": 25
}

{
  "npi": "1487344586",
  "enumerationType": "NPI-2",
  "organizationName": "1 FAMILY CLINIC INC",
  "authorizedOfficial": {
    "firstName": "MANEESH",
    "lastName": "SINGHAL",
    "title": "CEO/ Medical Director",
    "phone": "2132639095"
  },
  "primaryTaxonomy": {
    "code": "207QG0300X",
    "description": "Family Medicine, Geriatric Medicine"
  },
  "locationAddress": {
    "line1": "701 N ALVARADO ST STE B",
    "city": "LOS ANGELES",
    "state": "CA",
    "postalCode": "900264005",
    "phone": "213-263-9095"
  },
  "enrichment": {
    "website": "https://1familyclinic.com",
    "linkedinUrl": "https://www.linkedin.com/company/1-family-clinic",
    "secondaryEmails": ["info@1familyclinic.com"]
  }
}

💵 Pricing

Pay-per-result. The free NPI Registry lookup is included; the Google enrichment step is charged per enriched record (each enrichment runs one SERP search + one website fetch).

🎯 Use cases

• MedTech and pharma B2B prospecting
• Healthcare staffing and locum tenens recruitment
• Insurance network discovery
• Telehealth platform onboarding
• Medical SaaS sales (EHR, RCM, scheduling)
• Provider directory enrichment and verification
• Local-SEO and reputation management for clinics

Data source

This actor wraps the public NPI Registry API maintained by CMS (Centers for Medicare & Medicaid Services). Data is public-domain federal data. Optional enrichment uses publicly accessible search engine results and the provider's own public website.