{ "openapi": "3.0.1", "info": { "title": "Healthgrades Scraper — Doctor & Dentist Leads, NPI + Phone", "description": "Scrape the Healthgrades provider directory by specialty and city — doctor/dentist name, credentials, specialty, NPI number, star rating, review count, every office address with phone and GPS, awards and profile URL. 184 specialties, all 50 states. Public data, no login. Export JSON/CSV/Excel.", "version": "0.1", "x-build-id": "ddvs6VeqowGpcksvB" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapersdelight~healthgrades-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapersdelight-healthgrades-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/scrapersdelight~healthgrades-scraper/runs": { "post": { "operationId": "runs-sync-scrapersdelight-healthgrades-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/scrapersdelight~healthgrades-scraper/run-sync": { "post": { "operationId": "run-sync-scrapersdelight-healthgrades-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": "One or more Healthgrades specialties. Use the everyday name (\"Family Medicine\", \"Dentistry\", \"Cardiology\", \"Psychiatry\") or the exact directory slug (\"dermatology-directory\"). 184 specialties are supported — the full list is at https://www.healthgrades.com/specialty-directory. Every specialty is crossed with every location below.", "default": [], "items": { "type": "string" } }, "locations": { "title": "Locations", "type": "array", "description": "\"City, ST\" for a city (e.g. \"Los Angeles, CA\") or just a state code (\"CA\") to sweep the whole state. Tip: Healthgrades spells cities out — use \"Saint Louis, MO\", not \"St. Louis\" (the actor converts St./Ft./Mt. for you).", "default": [], "items": { "type": "string" } }, "startUrls": { "title": "Start URLs (optional)", "type": "array", "description": "Directory URLs (…/family-practice-directory/ca-california/los-angeles, pagination followed) and/or provider profiles (…/physician/…, …/dentist/…, …/providers/…), one row each.", "default": [], "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "excludeSponsored": { "title": "Skip sponsored listings", "type": "boolean", "description": "Healthgrades injects up to 3 paid \"sponsored\" cards at the top of each page. Turn this on to keep only organic results.", "default": false }, "minRating": { "title": "Minimum star rating", "enum": [ "0", "3", "3.5", "4", "4.5", "5" ], "type": "string", "description": "Drop providers rated below this. Unrated providers are dropped when a floor is set. \"Any rating\" keeps everyone.", "default": "0" }, "minReviewCount": { "title": "Minimum number of ratings", "minimum": 0, "type": "integer", "description": "Drop providers with fewer patient ratings than this. 0 = keep everyone.", "default": 0 }, "requirePhone": { "title": "Only providers with a phone number", "type": "boolean", "description": "Drops rows with no office phone. Needs profile enrichment ON (phone is not on the listing card).", "default": false }, "includeProviderDetails": { "title": "Enrich from each provider profile (NPI + phone)", "type": "boolean", "description": "ON (recommended): opens every provider profile to add the NPI number, office phone numbers, all office addresses with GPS coordinates, awards, bio and \"accepting new patients\". OFF: listing-level fields only (name, specialty, rating, one address) — about 5× faster, but no phone and no NPI.", "default": true }, "includeReviews": { "title": "Include patient reviews", "type": "boolean", "description": "Adds a nested reviews list to each provider row: text, rating, date, title, per-question scores. Up to the 20 newest written reviews the profile shows. Included in the per-provider price.", "default": false }, "maxReviewsPerProvider": { "title": "Max reviews per provider", "minimum": 0, "maximum": 100, "type": "integer", "description": "Newest first. Healthgrades shows up to 20 written reviews per provider; 0 = all of them.", "default": 20 }, "reviewsNewerThan": { "title": "Only reviews newer than", "type": "string", "description": "Absolute date (2026-01-01) or relative to now (30 days, 6 months, 1 year). Inclusive. Leave empty for no lower bound." }, "reviewsOlderThan": { "title": "Only reviews older than", "type": "string", "description": "Absolute date or relative (e.g. 7 days). Inclusive. Combine with the field above for a window, e.g. 2026-01-01 to 2026-06-30." }, "maxItems": { "title": "Max providers", "minimum": 0, "type": "integer", "description": "Stop after this many provider rows in total (across all searches). Set 0 for no limit.", "default": 200 }, "maxPagesPerSearch": { "title": "Max result pages per search", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Healthgrades returns 20 organic providers per page (a big city can run to 400+ pages). This caps how deep each specialty × location goes.", "default": 5 }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Off by default — Healthgrades answers direct requests from Apify, which is faster and cheaper on its large pages. If Healthgrades refuses a direct request, the run switches itself to the Apify datacenter proxy. Turn a proxy on here only if you want every request to go through it.", "default": { "useApifyProxy": false } } } }, "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 } } } } } } } } } }