hexadatalabs/us-healthcare-providers-npi-scraper
hexadatalabs--us-healthcare-providers-npi-scraperDestructive
This tool calls the Actor "hexadatalabs/us-healthcare-providers-npi-scraper" and retrieves its output results. Actor description: Use this when you need US healthcare organizations or practitioners from the official NPI Registry (NPPES): clinics, hospitals, pharmacies, dentists by specialty, city, state or ZIP, with address, phone, taxonomy and NPI. No key; large areas split automatically. Pay per result.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "hexadatalabs--us-healthcare-providers-npi-scraper"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| city | No | City of the practice location, e.g. "Austin". NPPES matches the city name as registered (usually upper case, exact word). Example values: "Austin" | |
| state | No | Two-letter US state or territory code of the practice location, e.g. TX. Must be combined with another filter. Example values: "TX" | |
| country | No | Two-letter country code of the practice location. NPPES is a US registry; a few providers abroad (e.g. MX, CA) are registered too. Example values: "US" | US |
| waitSecs | No | Max seconds (0–45, default 30) to cap the wait for the Actor run to reach terminal state. For long-running Actors the response returns at the cap with the current run status; follow `nextStep` to poll via get-actor-run. Set to 0 to fire-and-forget. | |
| includeRaw | No | Attach the original NPPES API record under "raw" (all addresses, identifiers, endpoints, practice locations). | |
| maxResults | No | Stop after this many providers. NPPES returns at most 1,200 per query; the Actor splits larger areas by ZIP prefix automatically, so a whole state is possible. Example values: 50 | |
| taxonomies | No | NPPES taxonomy descriptions, one per line, e.g. "Dentist", "Family Medicine", "Pharmacy", "Physical Therapist", "Clinic/Center". A wildcard * at the end matches sub-specialties ("Dent*" = Dentist, Dental Hygienist...; at least two characters before the *). Full list: https://taxonomy.nucc.org/ Example values: ["Dentist"] | |
| postalCodes | No | ZIP codes ("78701") or prefixes of at least two digits ("787" = all of Austin area, "78" = central Texas). Use prefixes to cover a region without naming every city. | |
| enumeratedFrom | No | Only providers whose NPI was issued on or after this date (YYYY-MM-DD), e.g. new clinics since 2026-01-01. Applied after download, so the run still scans the area. | |
| includeContacts | No | Add the organization's authorized official (name, title, phone) as published in NPPES. Off by default because it names an individual. | |
| organizationName | No | Filter by organization name, wildcard * at the end allowed, e.g. "Mayo*", "CVS*". Organizations only. | |
| includeIndividuals | No | Off: only organizations (NPI-2: clinics, hospitals, pharmacies, group practices). On: also individual practitioners (NPI-1: physicians, dentists, nurses), which are named persons; turn on only if you have a lawful basis to use their public practice data. | |
| proxyConfiguration | No | NPPES is an open API that does not need a proxy; leave it off. Example values: {"useApifyProxy":false} | |
| onlyNewSinceLastRun | No | Use this on a schedule: the Actor remembers the NPIs it delivered (shared store "hexadata-us-healthcare-providers-npi" in your account) and returns only providers it has not delivered before. The first run saves everything that matches. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| tip | No | Advisory guidance RAG Web Browser wrote to its key-value store under the reserved "TIP" key | |
| runId | Yes | Actor run ID | |
| stats | No | Run statistics | |
| status | Yes | Run status: READY | RUNNING | TIMING-OUT | TIMED-OUT | ABORTING | ABORTED | SUCCEEDED | FAILED | |
| actorId | Yes | Stable Apify Actor ID from the run record | |
| summary | Yes | Past-tense summary of the run state | |
| exitCode | No | Actor process exit code; populated for terminal states (especially FAILED) | |
| nextStep | Yes | One primary follow-up action with identifiers interpolated | |
| storages | Yes | Dataset and key-value store metadata, keyed by alias. "default" is always the primary entry. | |
| actorName | No | "username/actor-name" | |
| startedAt | No | ISO timestamp when the run started | |
| finishedAt | No | ISO timestamp when the run finished (terminal states only) | |
| statusMessage | No | Pass-through from Apify run.statusMessage | |
| apifyConsoleUrl | No | Personalized Apify Console link to the run; present only for Console sessions |