US CMS NPI Healthcare Provider & Medical Practice Enricher

Query the official US CMS National Plan and Provider Enumeration System (NPI Registry v2.1 API) by specialty, city, and state to extract medical practices, NPI numbers, authorized officials, and practice phones.

Built for Clay.com, n8n, Make.com, and AI Agents (MCP) with guaranteed structured JSON output, live DNS-over-HTTPS MX email verification, and Pay-Per-Result ($0 on Empty) billing—you never pay for empty or unverified records.

---

Why Choose coherent_edelweiss/us-npi-healthcare-enricher?

Feature	Legacy Scrapers ($30–$49/mo Rental)	coherent_edelweiss/us-npi-healthcare-enricher
Pricing Model	Upfront monthly subscription even on empty runs	Pay-Per-Event ($0.002–$0.007/record) — $0 on empty results
Official CMS NPI v2.1 Live Query	Outdated static NPI dumps	Queries the live US CMS NPI Registry API in real time with E.164 phone normalization & medical sales briefs
Contact & Domain Verification	Unverified regex text dumps	Live DNS-over-HTTPS MX Verification + Mail Gateway Classification (Google Workspace, Microsoft 365)
Execution Speed	60–180s browser spin-up	3–6 seconds with zero headless browser overhead
UK / EU GDPR Compliance	Scrapes personal data indiscriminately	Built-in gdprSafeMode (auto | strict | off) for UK/EEA corporate role-only filtering

---

Transparent Pay-Per-Event Pricing (Zero-Charge on Empty)

• result-scraped ($0.002): Charged only when a valid primary record is extracted.
• verified-contact-enriched ($0.003): Charged only when DNS MX verification confirms active mail routing or enriched domain contacts.
• ai-structured-summary ($0.002): Charged only when a structured B2B intelligence pitch/summary is generated.

---

1-Click Integrations: Clay.com, n8n & Make.com

Clay.com ("HTTP API" Enrichment Column)

• Method: POST
• URL: https://api.apify.com/v2/acts/coherent_edelweiss~us-npi-healthcare-enricher/run-sync-get-dataset-items?token=YOUR_APIFY_TOKEN
• Headers: Content-Type: application/json
• Body:

{
  "taxonomyDescription": "Clinic",
  "city": "Austin",
  "state": "TX",
  "maxProviders": 3,
  "includeAiPitch": true,
  "gdprSafeMode": "auto"
}

cURL / n8n / Make.com Quickstart

curl -X POST "https://api.apify.com/v2/acts/coherent_edelweiss~us-npi-healthcare-enricher/run-sync-get-dataset-items?token=YOUR_APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "taxonomyDescription": "Clinic",
  "city": "Austin",
  "state": "TX",
  "maxProviders": 3,
  "includeAiPitch": true,
  "gdprSafeMode": "auto"
}'

Python (apify-client)

from apify_client import ApifyClient

client = ApifyClient("YOUR_APIFY_TOKEN")
run = client.actor("coherent_edelweiss/us-npi-healthcare-enricher").call(run_input={
  "taxonomyDescription": "Clinic",
  "city": "Austin",
  "state": "TX",
  "maxProviders": 3,
  "includeAiPitch": true,
  "gdprSafeMode": "auto"
})
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

---

Sample Enriched Output

{
  "npi_number": "1043218901",
  "enumeration_type": "NPI-2",
  "provider_or_org_name": "Austin Regional Clinic",
  "primary_taxonomy": "Clinic/Center",
  "taxonomy_code": "261Q00000X",
  "authorized_official": "Chief Medical Officer",
  "address": "811 Barton Springs Rd, Austin, TX 78704",
  "city": "Austin",
  "state": "TX",
  "postal_code": "78704",
  "practice_phone_e164": "+15122724636",
  "status": "Active",
  "ai_medical_sales_pitch": "Austin Regional Clinic (NPI #1043218901, Clinic/Center) in Austin, TX is an active healthcare provider; verified practice line +15122724636 for EHR, RCM billing, or medical device outreach."
}

---

Connect to Claude Desktop, Cursor & AI Agents (MCP)

You can call this Actor directly from Claude Desktop, Cursor, or any Model Context Protocol (MCP) client:

{
  "mcpServers": {
    "us-npi-healthcare-enricher": {
      "command": "npx",
      "args": [
        "-y",
        "@apify/actors-mcp-server",
        "--actors",
        "coherent_edelweiss/us-npi-healthcare-enricher"
      ],
      "env": {
        "APIFY_TOKEN": "YOUR_APIFY_TOKEN"
      }
    }
  }
}

---

UK GDPR, EU GDPR & PECR Compliance Notice (Safe-by-Design)

• Stateless On-Demand Processor: This Actor is an ephemeral, on-demand software utility that executes within the user's isolated Apify container. The Actor developer does not store, aggregate, or resell any scraped datasets or personal data.
• Built-in gdprSafeMode (auto | strict | off): By default (auto), when a UK or EEA domain (.uk, .co.uk, .eu, .de, .fr, etc.) is detected, the Actor automatically filters out named personal emails (firstname.lastname@) and personal LinkedIn profile URLs (/in/), returning only non-personal corporate role endpoints (info@, sales@, contact@, enquiries@), corporate /company/ links, and website technology stack metadata.
• Controller Responsibility: Users disabling gdprSafeMode act as Data Controllers and are solely responsible for establishing a valid lawful basis (such as UK GDPR Article 6(1)(f) Legitimate Interests for corporate subscribers) and complying with UK PECR / EU ePrivacy rules.