# US Doctor & Healthcare Provider Lead Generator (NPI Registry) (`automation_studio/us-doctor-healthcare-npi-lead-generator`) Actor

Extract verified US doctors, dentists, surgeons, clinics, direct practice addresses, phone numbers, and active medical licenses directly from the official CMS NPI registry.

- **URL**: https://apify.com/automation\_studio/us-doctor-healthcare-npi-lead-generator.md
- **Developed by:** [Automation Studio](https://apify.com/automation_studio) (community)
- **Categories:** Lead generation
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $3.00 / 1,000 verified doctor & clinic leads

This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
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.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — 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

## 🩺 US Doctor & Healthcare Provider Lead Generator (NPI Registry)

Extract **verified US medical doctors, dentists, surgeons, chiropractors, clinics, and healthcare practices** directly from the official **US Centers for Medicare & Medicaid Services (CMS) NPPES federal registry**.

Acquire direct practice street addresses, verified office phone numbers, fax numbers, active state medical licenses, and taxonomy specialties with **zero proxy costs and instantaneous API speeds**.

***

### 🎯 Why Use This Actor for B2B Healthcare Lead Generation?

Selling to healthcare professionals and medical clinics is one of the highest-value B2B markets in the world. Enterprise data vendors (Definitive Healthcare, ZoomInfo, IQVIA) charge **$5,000 to $25,000+ per year** for doctor databases.

This Actor lets you prospect directly from the **official federal source of truth** for a fraction of a cent per verified lead ($0.003 / lead).

#### Ideal For:

- **Medical & Dental SaaS**: Selling EHR/EMR platforms, patient scheduling, practice management, and HIPAA communication software.
- **Medical Supplies & Equipment**: Dental handpieces, implants, surgical consumables, diagnostic instruments, and PPE.
- **Pharmaceutical & Biotech**: Physician outreach, key opinion leader (KOL) discovery, and clinical trial investigator recruiting.
- **Healthcare Staffing & Recruiters**: Locum tenens agencies hiring travel nurses, physician assistants, and specialized MDs.
- **Financial & Professional Services**: Medical malpractice insurance brokers, healthcare CPAs, and revenue cycle management (RCM) billing agencies.

***

### ⚡ The Ultimate Competitive Advantage

| Feature | Definitive Healthcare / ZoomInfo | Standard Web Scrapers | **US Doctor NPI Lead Generator** |
| :--- | :---: | :---: | :---: |
| **Annual Contract Required** | ❌ $10k – $25k / year | ❌ No, but proxy bills add up | ✅ **Pay-As-You-Go ($0.003 / lead)** |
| **Data Authority** | ⚠️ Aggregated / Third-party | ⚠️ Scraped HTML / Outdated | 🏛️ **Official Federal US Gov Registry (CMS)** |
| **Direct Practice Phone Numbers** | ⚠️ Frequently personal or gated | ⚠️ Hit-or-miss | ✅ **Verified Clinical Practice Telephones** |
| **Active Medical Licenses** | ❌ Rarely included | ❌ No | ✅ **State Medical Licenses & States** |
| **Execution Speed** | Slow export | 1–3s / page | ⚡ **Up to 200 records / second** |
| **Proxy / CAPTCHA Costs** | High | Heavy residential proxies | 🛡️ **Zero Proxy Needed (100% Free Federal API)** |
| **Reliability & Success Rate** | N/A | 80% – 90% (DOM breakages) | 🌟 **Guaranteed 100.0% Success Rate** |

***

### 📋 Comprehensive Extracted Data Fields

Every lead pushed to your dataset includes rich clinical, credentialing, and contact intelligence:

| Field Name | Description | Example |
| :--- | :--- | :--- |
| `npi` | 10-digit National Provider Identifier | `"1952894784"` |
| `entityType` | Individual Practitioner vs. Medical Organization | `"Individual Practitioner (Type 1)"` |
| `providerName` | Full title, practitioner name, and credentials | `"Dr. Michael Alexander Aaro, DMD"` |
| `firstName` | Practitioner first name | `"Michael"` |
| `lastName` | Practitioner last name | `"Aaro"` |
| `credential` | Medical degree or designation | `"MD"`, `"DO"`, `"DMD"`, `"DDS"`, `"NP"`, `"PA"` |
| `primarySpecialty` | Primary medical specialty & clinical taxonomy | `"Dentist, Orthodontics and Dentofacial Orthopedics"` |
| `taxonomyCode` | Official Healthcare Provider Taxonomy Code (HPTC) | `"1223X0400X"` |
| `stateLicenses` | Active medical licenses and issuing states | `["DN23583 (FL)"]` |
| `practiceName` | Clinic, surgery center, or practice name | `"Aaro Healthcare Practice"` |
| `fullPracticeAddress` | Direct physical practice street, city, state, zip | `"1840 Dunn Ave Ste 3, Jacksonville, FL 32218"` |
| `directPhone` | Formatted clinical telephone number for appointments | `"(904) 224-0046"` |
| `faxNumber` | Direct office fax line | `"(904) 339-9066"` |
| `yearsInPractice` | Years active since official CMS registration | `8` |
| `status` | Registration status in CMS federal database | `"Active (Verified Federal CMS NPI)"` |
| `leadIntent` | B2B Prospecting Intent Score | `"⭐ Prime Growth Practice (Active B2B Buyer)"` |

***

### 🛠️ Input Parameters & Configuration

```json
{
  "specialty": "Dentist",
  "state": "FL",
  "city": "Miami",
  "entityType": "NPI-1",
  "requirePhone": true,
  "maxResults": 100
}
```

#### Supported Medical Specialties:

- 🦷 **Dentistry & Dental Specialists** (General Dentistry, Orthodontics, Periodontics, Endodontics, Oral Surgery)
- ✨ **Dermatology & Cosmetic Skin Care**
- 🩺 **Family Medicine & General Practice**
- 🏥 **Internal Medicine Specialists**
- 👶 **Pediatrics & Adolescent Medicine**
- 🦴 **Orthopedic Surgery & Sports Medicine**
- 💆 **Chiropractic & Spine Care**
- 💉 **Plastic Surgery & Aesthetics**
- ❤️ **Cardiology & Cardiovascular Disease**
- 🧠 **Psychiatry & Behavioral Health**
- 🤰 **Obstetrics & Gynecology (OB/GYN)**
- 🏃 **Physical Therapy & Rehabilitation**
- 👁️ **Ophthalmology & Eye Surgery**
- 🦶 **Podiatry (Foot & Ankle Specialists)**
- ⚡ **Neurology & Brain Health**
- 🔬 **Gastroenterology & Digestive Care**
- 🚑 **Urgent Care & Emergency Medicine**
- 📋 **Nurse Practitioners (NP) & Physician Assistants (PA)**
- 🔍 **Custom Specialty / Free-Text Keyword** (e.g., *"Acupuncture"*, *"Sleep Medicine"*, *"Pediatric Oncology"*)

***

### 💰 Pay-Per-Event (PPE) Pricing

- **Actor Start**: `$0.003`
- **Per Verified Healthcare Lead**: `$0.003` ($3.00 per 1,000 verified leads)
- Enjoy transparent, usage-based billing with no subscription locks or surprise bills.

***

### 🔒 Compliance & Legal Notice

All data extracted by this Actor is public domain information published by the **United States Department of Health and Human Services (HHS)** and the **Centers for Medicare & Medicaid Services (CMS)** under the Freedom of Information Act (FOIA) and the Health Insurance Portability and Accountability Act (HIPAA) Administrative Simplification provisions. NPI numbers, clinical practice locations, and business telephone numbers are public records intended for identification and public healthcare directory verification.

# Actor input Schema

## `specialty` (type: `string`):

Select the primary specialty or medical trade of doctors and clinics to extract.

## `customTaxonomy` (type: `string`):

Optional keyword or exact taxonomy name if you selected 'Custom Specialty' above (e.g. 'Pediatric Dentistry', 'Acupuncture', 'Hand Surgery', 'Radiology', 'Oncology').

## `state` (type: `string`):

Target US State (2-letter abbreviation).

## `city` (type: `string`):

Target city name (e.g. Miami, Los Angeles, Chicago, Dallas, Austin). Leave empty to query the entire state.

## `postalCode` (type: `string`):

Specific 5-digit US ZIP code (e.g. 33101, 90210). Leave empty to search the city or state.

## `entityType` (type: `string`):

Filter by individual medical doctors/practitioners vs. healthcare organizations/practices.

## `providerName` (type: `string`):

Optional search term for specific doctor last name or clinic practice title.

## `requirePhone` (type: `boolean`):

If enabled, only leads with a verified direct practice telephone number will be extracted.

## `maxResults` (type: `integer`):

Total number of verified healthcare provider leads to output.

## Actor input object example

```json
{
  "specialty": "Dentist",
  "customTaxonomy": "",
  "state": "FL",
  "city": "Miami",
  "postalCode": "",
  "entityType": "NPI-1",
  "providerName": "",
  "requirePhone": true,
  "maxResults": 50
}
```

# Actor output Schema

## `dataset` (type: `string`):

Dataset containing verified medical practitioners, specialties, direct practice addresses, and phone numbers.

# 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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {};

// Run the Actor and wait for it to finish
const run = await client.actor("automation_studio/us-doctor-healthcare-npi-lead-generator").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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {}

# Run the Actor and wait for it to finish
run = client.actor("automation_studio/us-doctor-healthcare-npi-lead-generator").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{}' |
apify call automation_studio/us-doctor-healthcare-npi-lead-generator --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,automation_studio/us-doctor-healthcare-npi-lead-generator"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/yPXVPj0nFjOSeYGcx/builds/6YlROK7fofNnIuGNv/openapi.json