{ "openapi": "3.0.1", "info": { "title": "Healthline Medical Providers Directory Scraper", "description": "Collect medical provider profiles from the Healthline FindCare directory. Get physician names, specialties, credentials, insurance acceptance, patient ratings, office locations, telehealth availability, and profile details to support healthcare research, recruiting, and provider database building.", "version": "1.0", "x-build-id": "UbF9Ci0H0sJuxN6Xh" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/parseforge~healthline-medical-providers-directory-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-parseforge-healthline-medical-providers-directory-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/parseforge~healthline-medical-providers-directory-scraper/runs": { "post": { "operationId": "runs-sync-parseforge-healthline-medical-providers-directory-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/parseforge~healthline-medical-providers-directory-scraper/run-sync": { "post": { "operationId": "run-sync-parseforge-healthline-medical-providers-directory-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": { "startUrl": { "title": "Start URL", "type": "string", "description": "Direct URL to scrape (e.g. https://care.healthline.com/find-care/specialty/cardiology/ny/new-york). If provided, specialty/state/city filters are ignored." }, "maxItems": { "title": "Max Items", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "Free users: Limited to 100. Paid users: Optional, max 1,000,000." }, "specialty": { "title": "Specialty", "type": "string", "description": "Medical specialty slug to search (e.g. cardiology, dermatology, orthopedics, primary-care-doctors). Used when Start URL is not provided." }, "state": { "title": "State", "type": "string", "description": "Two-letter US state abbreviation (e.g. ny, ca, tx). Leave blank to scrape all cities in all states." }, "city": { "title": "City", "type": "string", "description": "City slug (e.g. new-york, los-angeles, chicago). Leave blank to scrape all cities in the state." }, "sortBy": { "title": "Sort By", "enum": [ "recommended", "distance", "rating" ], "type": "string", "description": "Sort provider results. Applies to both generated searches and startUrl runs." }, "acceptsNewPatients": { "title": "Accepts New Patients", "type": "boolean", "description": "Keep only providers marked as accepting new patients.", "default": false }, "offersTelehealth": { "title": "Offers Telehealth", "type": "boolean", "description": "Keep only providers marked as offering telehealth.", "default": false }, "schedulesOnline": { "title": "Schedules Online", "type": "boolean", "description": "Keep only providers whose listing indicates online scheduling.", "default": false }, "insuranceCarrierId": { "title": "Insurance Carrier ID", "type": "string", "description": "Healthline insurance carrier ID. Use together with Insurance Carrier Name." }, "insuranceCarrierName": { "title": "Insurance Carrier Name", "type": "string", "description": "Healthline insurance carrier name (for example: Aetna). Use together with Insurance Carrier ID." }, "rawFilters": { "title": "Raw Filters", "type": "string", "description": "Optional raw Healthline filters clause appended to the URL filters parameter. For advanced use only." }, "includeDetails": { "title": "Include Full Profile Details", "type": "boolean", "description": "If enabled, fetches each provider's full profile page for additional details (education, hospital affiliations, languages spoken, NPI). Slower but more complete.", "default": false }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Proxy settings. US Residential proxies are required for this site." } } }, "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 } } } } } } } } } }