{ "openapi": "3.0.1", "info": { "title": "Medicare Doctors & Clinicians Scraper - NPI & Specialty", "description": "Find US Medicare-enrolled doctors and clinicians with NPI, credential, medical school, specialties, group practice, full address and phone. Filter by specialty, state, city, ZIP, name, credential, school or NPI. Export to JSON, CSV or Excel.", "version": "0.1", "x-build-id": "UbwHz00Tln5Uu4Pcu" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapers_lat~medicare-doctors-clinicians-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapers_lat-medicare-doctors-clinicians-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/scrapers_lat~medicare-doctors-clinicians-scraper/runs": { "post": { "operationId": "runs-sync-scrapers_lat-medicare-doctors-clinicians-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/scrapers_lat~medicare-doctors-clinicians-scraper/run-sync": { "post": { "operationId": "run-sync-scrapers_lat-medicare-doctors-clinicians-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": "Filter by primary specialty. One run can scan several. Use the exact Medicare specialty label, for example DERMATOLOGY, CARDIOLOGY, INTERNAL MEDICINE, FAMILY PRACTICE, PSYCHIATRY, NURSE PRACTITIONER, PHYSICIAN ASSISTANT.", "items": { "type": "string" } }, "states": { "title": "States", "type": "array", "description": "Filter by 2-letter US state code, for example CA, NY, TX. One run can scan several.", "items": { "type": "string" } }, "cities": { "title": "Cities", "type": "array", "description": "Optional. Filter by practice city, for example SAN FRANCISCO, MIAMI.", "items": { "type": "string" } }, "zipCodes": { "title": "ZIP codes", "type": "array", "description": "Optional. Filter by practice ZIP code (5 or 9 digit).", "items": { "type": "string" } }, "lastName": { "title": "Last name starts with", "type": "string", "description": "Optional. Keep only clinicians whose last name starts with this text." }, "firstName": { "title": "First name starts with", "type": "string", "description": "Optional. Keep only clinicians whose first name starts with this text." }, "credentials": { "title": "Credentials", "type": "array", "description": "Optional. Filter by credential, for example MD, DO, NP, PA.", "items": { "type": "string" } }, "medicalSchool": { "title": "Medical school contains", "type": "string", "description": "Optional. Keep only clinicians whose medical school name contains this text, for example HARVARD or STANFORD." }, "groupName": { "title": "Group / practice name contains", "type": "string", "description": "Optional. Keep only clinicians whose group or practice name contains this text." }, "npiNumbers": { "title": "NPI numbers", "type": "array", "description": "Optional. Look up specific clinicians by their 10-digit NPI.", "items": { "type": "string" } }, "graduatedAfterYear": { "title": "Graduated in or after year", "minimum": 1900, "maximum": 2030, "type": "integer", "description": "Optional. Keep only clinicians who graduated in or after this year." }, "onlyWithPhone": { "title": "Only clinicians with a phone number", "type": "boolean", "description": "When on, skip records that have no published practice phone number.", "default": false }, "maxProviders": { "title": "Max Clinicians To Scrape", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "Maximum number of clinicians to collect." } } }, "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 } } } } } } } } } }