# Healthcare Provider Intelligence - Free NPI API (`ntriqpro/healthcare-provider-intelligence`) Actor Free healthcare provider API for hospitals, physicians, clinics. Get CMS quality ratings, NPI profiles, compare provider credentials and patient outcomes without subscription. Replace Definitive Healthcare ($50K/yr). No API keys required, pay-per-use. - **URL**: https://apify.com/ntriqpro/healthcare-provider-intelligence.md - **Developed by:** [daehwan kim](https://apify.com/ntriqpro) (community) - **Categories:** AI, Business - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing $100.00 / 1,000 charged when a healthcare provider data scan is sus This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. 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. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use 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 ## Healthcare Provider Intelligence - CMS & NPI Search hospitals and doctors, compare quality ratings, and analyze provider statistics using free CMS Provider Data and NPI Registry APIs. No API key required. Covers hospitals, physicians, quality scores, and state-level market dashboards. ### Features - Search hospitals by name or location using CMS Provider of Services data - Look up doctors and specialists by name, specialty, and state via NPI Registry - Compare hospital quality ratings including star ratings and patient outcome metrics - Analyze state-level healthcare market statistics and provider distribution - Generate provider dashboards with quality benchmarks and peer comparisons ### Input Parameters | Parameter | Type | Description | Default | |-----------|------|-------------|---------| | `mode` | string | Analysis mode: `hospital_search`, `doctor_search`, `quality_comparison`, `state_market`, `provider_dashboard` | `hospital_search` | | `query` | string | Hospital or provider name to search (e.g., 'Johns Hopkins', 'Mayo Clinic') | `Johns Hopkins` | | `state` | string | US state abbreviation to filter results (e.g., 'CA', 'MD', 'NY') | `MD` | | `specialty` | string | Medical specialty to filter doctors (e.g., 'Cardiology', 'Internal Medicine', 'Pediatrics') | — | | `firstName` | string | First name of the doctor to search for (doctor_search mode) | — | | `lastName` | string | Last name of the doctor to search for (doctor_search mode) | — | | `limit` | integer | Maximum number of records to return | `20` | ### Output The actor returns structured JSON data with provider profiles, quality scores, patient outcome metrics, and market statistics. ### Pricing This actor uses pay-per-event pricing at $0.05 per successful analysis. ### Usage 1. Set your input parameters 2. Run the actor 3. Get results from the dataset ### API Integration ```javascript import { ApifyClient } from 'apify-client'; const client = new ApifyClient({ token: 'YOUR_TOKEN' }); const run = await client.actor('ntriqpro/healthcare-provider-intelligence').call({ mode: 'hospital_search', query: 'Mayo Clinic', state: 'MN', }); const { items } = await client.dataset(run.defaultDatasetId).listItems(); ```` # Actor input Schema ## `mode` (type: `string`): Select the type of healthcare data to retrieve ## `query` (type: `string`): Hospital or provider name to search for (e.g., 'Johns Hopkins', 'Mayo Clinic'). Used in hospital\_search and hospital\_quality modes. ## `state` (type: `string`): US state abbreviation to filter results (e.g., 'CA', 'MD', 'NY'). Used in all modes. ## `specialty` (type: `string`): Medical specialty to filter doctors (e.g., 'Cardiology', 'Internal Medicine', 'Pediatrics'). Used in doctor\_search mode. ## `firstName` (type: `string`): First name of the doctor to search for. Used in doctor\_search mode. ## `lastName` (type: `string`): Last name of the doctor to search for. Used in doctor\_search mode. ## `limit` (type: `integer`): Maximum number of records to return. ## Actor input object example ```json { "mode": "hospital_search", "query": "Johns Hopkins", "state": "MD", "limit": 20 } ``` # Actor output Schema ## `results` (type: `string`): No description # 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 '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = {}; // Run the Actor and wait for it to finish const run = await client.actor("ntriqpro/healthcare-provider-intelligence").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 '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = {} # Run the Actor and wait for it to finish run = client.actor("ntriqpro/healthcare-provider-intelligence").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).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 ntriqpro/healthcare-provider-intelligence --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=ntriqpro/healthcare-provider-intelligence", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Healthcare Provider Intelligence - Free NPI API", "description": "Free healthcare provider API for hospitals, physicians, clinics. Get CMS quality ratings, NPI profiles, compare provider credentials and patient outcomes without subscription. Replace Definitive Healthcare ($50K/yr). No API keys required, pay-per-use.", "version": "1.0", "x-build-id": "kYMixOQb76sjwc1hV" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/ntriqpro~healthcare-provider-intelligence/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-ntriqpro-healthcare-provider-intelligence", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/ntriqpro~healthcare-provider-intelligence/runs": { "post": { "operationId": "runs-sync-ntriqpro-healthcare-provider-intelligence", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/ntriqpro~healthcare-provider-intelligence/run-sync": { "post": { "operationId": "run-sync-ntriqpro-healthcare-provider-intelligence", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "mode" ], "properties": { "mode": { "title": "Analysis Mode", "enum": [ "hospital_search", "doctor_search", "hospital_quality", "provider_statistics", "healthcare_overview" ], "type": "string", "description": "Select the type of healthcare data to retrieve", "default": "hospital_search" }, "query": { "title": "Search Keyword", "type": "string", "description": "Hospital or provider name to search for (e.g., 'Johns Hopkins', 'Mayo Clinic'). Used in hospital_search and hospital_quality modes.", "default": "Johns Hopkins" }, "state": { "title": "State Abbreviation", "type": "string", "description": "US state abbreviation to filter results (e.g., 'CA', 'MD', 'NY'). Used in all modes.", "default": "MD" }, "specialty": { "title": "Medical Specialty", "type": "string", "description": "Medical specialty to filter doctors (e.g., 'Cardiology', 'Internal Medicine', 'Pediatrics'). Used in doctor_search mode." }, "firstName": { "title": "Doctor First Name", "type": "string", "description": "First name of the doctor to search for. Used in doctor_search mode." }, "lastName": { "title": "Doctor Last Name", "type": "string", "description": "Last name of the doctor to search for. Used in doctor_search mode." }, "limit": { "title": "Result Limit", "minimum": 1, "maximum": 200, "type": "integer", "description": "Maximum number of records to return.", "default": 20 } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```