{ "openapi": "3.0.1", "info": { "title": "US Healthcare Providers — NPI Registry, Phones, Specialties", "description": "Search the US NPI registry by specialty, state, city, postal code, name or NPI number and export doctors, dentists, therapists, clinics and hospitals with their practice address, phone, fax, licence and specialties. Public-domain government data, no API key.", "version": "0.1", "x-build-id": "SeuurgQc00q9DfZdU" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/chorelet~npi-providers-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-chorelet-npi-providers-scraper", "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/chorelet~npi-providers-scraper/runs": { "post": { "operationId": "runs-sync-chorelet-npi-providers-scraper", "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/chorelet~npi-providers-scraper/run-sync": { "post": { "operationId": "run-sync-chorelet-npi-providers-scraper", "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", "properties": { "specialties": { "title": "Specialties", "type": "array", "description": "As the registry words them: `dentist`, `psychiatry`, `physical therapist`, `family medicine`, `chiropractor`, `pharmacy`, `home health`. Several are searched one after another.", "items": { "type": "string" } }, "states": { "title": "States", "type": "array", "description": "Two-letter codes: `CA`, `TX`, `NY`.", "items": { "type": "string" } }, "cities": { "title": "Cities", "type": "array", "description": "Searched inside the states above, if any.", "items": { "type": "string" } }, "postalCodes": { "title": "Postal codes", "type": "array", "description": "Five-digit ZIP codes — the most precise way to stay under the registry's 1,200-per-search ceiling.", "items": { "type": "string" } }, "providerType": { "title": "Provider type", "enum": [ "", "individual", "organisation" ], "type": "string", "description": "Individuals are doctors and therapists; organisations are clinics, practices and hospitals.", "default": "" }, "firstName": { "title": "First name", "type": "string", "description": "For looking up a particular person." }, "lastName": { "title": "Last name", "type": "string", "description": "For looking up a particular person." }, "organizationName": { "title": "Organisation name", "type": "string", "description": "For looking up a particular clinic or practice." }, "npiNumbers": { "title": "NPI numbers", "type": "array", "description": "Ten-digit numbers to look up directly — enrichment for a list you already have.", "items": { "type": "string" } }, "onlyWithPhone": { "title": "Only providers with a phone number", "type": "boolean", "description": "What turns the registry into a call list.", "default": false }, "onlyActive": { "title": "Only active records", "type": "boolean", "description": "Drops deactivated NPIs.", "default": true }, "maxResults": { "title": "Max providers", "minimum": 1, "maximum": 50000, "type": "integer", "description": "Across every search. The registry serves at most 1,200 per individual search, so split wide sweeps by city or postal code.", "default": 1000 } } }, "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }