# Healthgrades Scraper — Doctors, Reviews & Provider Leads (`scrapesage/healthgrades-scraper`) Actor Scrape Healthgrades doctors & healthcare providers by specialty and location, or from profile URLs. Get NPI, specialties, ratings, patient reviews, education, board certifications, locations, phones & leads — plus optional practice-email enrichment and monitoring. No login, no browser. - **URL**: https://apify.com/scrapesage/healthgrades-scraper.md - **Developed by:** [Scrape Sage](https://apify.com/scrapesage) (community) - **Categories:** Lead generation, Other, Automation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $12.00 / 1,000 provider scrapeds 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 ## Healthgrades Scraper — Doctors, Reviews & Healthcare Provider Leads Extract **complete Healthgrades provider data** — doctors, dentists and healthcare professionals by **specialty and location**, or from any profile URL. Get the fields most scrapers miss: **NPI numbers, granular specialties, star ratings, patient-experience scores, every practice location with phone & geo, accepted insurance, education, board certifications, languages and hospital affiliations** — plus patient reviews, an opt-in **practice-website email enrichment** step, and a **monitoring mode** that returns only new providers. No login, no cookies, no browser — fast HTML/JSON extraction with 99%+ reliability. ### Why this Healthgrades scraper? Most provider scrapers return a name, a rating and an address. This actor pulls the full record Healthgrades renders — including the embedded data the page ships to the browser — and outputs the **richest provider dataset in the category**: | Data | Typical scrapers | This actor | |---|---|---| | NPI number | ❌ | ✅ | | Specialty + sub-specialty (e.g. *Oral & Maxillofacial Surgery*) | partial | ✅ | | Star rating, rating %, review count | ✅ | ✅ | | Patient-experience scores (wait time, listened, trustworthy…) with counts | ❌ | ✅ | | Accepts new patients / telehealth flags | partial | ✅ | | Every practice location (street, ZIP, lat/lng) + office phone | partial | ✅ | | Fax number | ❌ | ✅ | | Education, board certifications, certifying agencies, languages | ❌ | ✅ | | Accepted insurance plans | ❌ | ✅ | | Hospital affiliations (name + address) | ❌ | ✅ | | Conditions treated & procedures performed | ❌ | ✅ | | Patient reviews (rating, text, date) | partial | ✅ opt-in | | Practice **contact emails** (from the practice website) | ❌ | ✅ opt-in | | Lead score (0–100) per provider | ❌ | ✅ | | Monitoring — only **new** providers since last run | ❌ | ✅ | ### Use cases - **Healthcare lead generation** — build targeted lists of doctors, dentists and specialists by specialty + city for medical-device, pharma, healthtech/SaaS sales, staffing and recruiting. Score them by contactability and reach (`leadScore`, `phone`, `acceptsNewPatients`, `reviewCount`) and reach the practice directly. - **Provider directories & marketplaces** — power a "find a doctor" product with structured profiles, ratings, specialties, locations and accepted insurance. - **Reputation & review monitoring** — track a provider's or group's rating, review volume and new patient reviews over time. - **Market & network analysis** — map provider density by specialty and geography, hospital affiliations, and insurance acceptance for payer/provider strategy. - **Recruiting & credentialing** — filter by specialty, board certifications, languages, years in practice and location; verify with the NPI. ### How to use 1. [Sign up for Apify](https://console.apify.com/sign-up) — the free plan is enough to try this actor. 2. Open the **Healthgrades Scraper**, enter a **specialty** (or doctor name) in *Search terms* and one or more **City, ST / ZIP** *Locations* — or paste Healthgrades URLs into *Start URLs*. 3. Click **Start** and watch provider records stream into the dataset. 4. **Export** as JSON, CSV, Excel, XML, or RSS — or pull results programmatically via the [Apify API](https://docs.apify.com/api/v2). ### Input ```json { "searchQueries": ["Cardiology", "Dentistry"], "locations": ["New York, NY", "Austin, TX", "90210"], "maxProvidersPerSearch": 60, "maxProviders": 200, "acceptingNewPatientsOnly": true, "minRating": 4, "includeProviderDetails": true, "includeReviews": true, "maxReviewsPerProvider": 25, "enrichPracticeEmails": true, "deduplicateProviders": true } ```` - **searchQueries** — a specialty (`Dermatology`, `Pediatrics`), a condition/procedure, or a doctor's name. Combined with every location. - **locations** — `City, ST` (`Chicago, IL`) or a 5-digit ZIP. Each is paired with every search term. - **startUrls** — Healthgrades provider profile URLs (`/physician/…`, `/dentist/…`) or search-result URLs (`/usearch?what=…&where=…`). Processed alongside searches. - **maxProvidersPerSearch / maxProviders** — per-search and whole-run caps. - **acceptingNewPatientsOnly / minRating / gender / telehealthOnly** — filters. - **includeProviderDetails** *(default true)* — open each profile for education, board certifications, languages, accepted insurance, all locations + geo, fax, hospital affiliations, conditions and procedures. - **includeReviews** *(default false)* — also output patient review records (`type: "review"`). - **enrichPracticeEmails** *(default false)* — when a practice website is found, crawl it (home + contact/about) for contact emails, phones and socials. Healthgrades never exposes emails — this is the only way to get them. - **deduplicateProviders** *(default true)* — emit each provider once per run (keyed by NPI / profile URL). - **monitorMode** *(default false)* — emit only providers not seen in previous runs. ### Output One record per provider (`type: "provider"`), plus optional patient reviews (`type: "review"`): ```json { "type": "provider", "npi": "1396709085", "providerId": "YBDM3", "fullName": "Dr. Devin Okay, DDS", "firstName": "Devin", "lastName": "Okay", "credential": "DDS", "gender": "M", "age": 61, "yearsInPractice": null, "specialty": "Oral & Maxillofacial Surgery", "specialtyCategory": "Dentistry", "specialties": ["Oral & Maxillofacial Surgery", "Dentistry"], "bio": "Dr. Devin Okay, DDS is an oral & maxillofacial surgery specialist in New York, NY…", "profileUrl": "https://www.healthgrades.com/physician/dr-devin-okay-ybdm3", "imageUrl": "https://photos.healthgrades.com/img/prov/y/b/d/ybdm3_w185h248.jpg", "rating": 4.23, "ratingPercent": 94, "reviewCount": 13, "acceptsNewPatients": true, "telehealthAvailable": false, "isRecommendedProvider": true, "patientExperience": [ { "title": "Listened/answered questions", "count": 32, "positiveCount": 32, "positivePercent": 100 } ], "practiceName": "Head Neck and Thyroid Institute", "primaryAddress": { "street": "10 Union Sq E Frnt 5", "city": "New York", "state": "NY", "postalCode": "10003", "latitude": 40.73547, "longitude": -73.9897 }, "city": "New York", "state": "NY", "phone": "(212) 226-6368", "fax": "(646) 537-9205", "offices": [ { "street": "10 Union Sq E Frnt 5", "city": "New York", "state": "NY", "postalCode": "10003", "phone": "(212) 226-6368", "latitude": 40.73547, "longitude": -73.9897 } ], "officeCount": 2, "insuranceAccepted": ["Aetna", "Cigna", "UnitedHealthcare"], "education": ["Columbia University — DDS"], "boardCertifications": ["American Board of Oral & Maxillofacial Surgery"], "languages": ["English", "Spanish"], "hospitalAffiliations": [ { "name": "Mount Sinai Hospital", "street": "1 Gustave L Levy Pl", "city": "New York", "state": "NY", "postalCode": "10029" } ], "conditionsTreated": ["Dentofacial Anomalies"], "proceduresPerformed": ["Facial Reconstruction"], "website": "https://example-practice.com", "contactEmails": ["office@example-practice.com"], "socialLinks": { "facebook": "https://facebook.com/examplepractice" }, "leadScore": 78, "searchQuery": "Dentistry", "searchLocation": "New York, NY", "scrapedAt": "2026-06-14T12:00:00.000Z" } ``` ### Automate & schedule Run this actor on autopilot and pull results into your own stack: - **[Apify API](https://docs.apify.com/api/v2)** — start runs, fetch datasets, and manage schedules over REST. - **[apify-client for JavaScript](https://docs.apify.com/api/client/js/)** and **[apify-client for Python](https://docs.apify.com/api/client/python/)** — official SDKs. - **[Schedules](https://docs.apify.com/platform/schedules)** — run it daily/weekly to watch a specialty or area for new providers; pair with **Monitoring mode** so each run returns only new doctors. - **[Webhooks](https://docs.apify.com/platform/integrations/webhooks)** — trigger downstream actions (CRM import, Slack alert, email sequence) the moment a run finishes. ```js import { ApifyClient } from 'apify-client'; const client = new ApifyClient({ token: 'MY_APIFY_TOKEN' }); const run = await client.actor('scrapesage/healthgrades-scraper').call({ searchQueries: ['Dermatology'], locations: ['Los Angeles, CA'], maxProviders: 200, acceptingNewPatientsOnly: true, enrichPracticeEmails: true, }); const { items } = await client.dataset(run.defaultDatasetId).listItems(); console.log(`Got ${items.length} providers & reviews`); ``` ### Integrate with any app Connect the dataset to 5,000+ apps — no code required: - **[Make](https://docs.apify.com/platform/integrations/make)** — multi-step automation scenarios. - **[Zapier](https://docs.apify.com/platform/integrations/zapier)** — push new provider leads straight into your CRM. - **[Slack](https://docs.apify.com/platform/integrations/slack)** — get notified when a monitored search finds new providers. - **[Google Drive / Sheets](https://docs.apify.com/platform/integrations/drive)** — auto-export every run to a spreadsheet. - **[Airbyte](https://docs.apify.com/platform/integrations/airbyte)** — pipe results into your data warehouse. - **[GitHub](https://docs.apify.com/platform/integrations/github)** — trigger runs from commits or releases. ### Use with AI assistants (MCP) The output is clean, LLM-ready JSON. You can call this actor from Claude, ChatGPT, or any agent framework through the **[Apify MCP server](https://docs.apify.com/platform/integrations/mcp)** — ask your assistant to "find dermatologists in Los Angeles accepting new patients and list their practice phone numbers" and let it run this scraper for you. ### More scrapers from scrapesage Build a complete **B2B lead-gen & market-intel stack**: - **[SAM.gov Scraper](https://apify.com/scrapesage/sam-gov-scraper)** — federal contract opportunities and contacts. - **[Bark Listing Scraper](https://apify.com/scrapesage/bark-listing-scraper)** — service-provider directory leads. - **[LinkedIn Jobs Scraper](https://apify.com/scrapesage/linkedin-jobs-scraper)** — job postings as hiring-intent signals. - **[Multi-ATS Job Scraper](https://apify.com/scrapesage/multi-ats-job-scraper)** — jobs from Greenhouse, Lever, Ashby & Workday. - **[Eventbrite Scraper](https://apify.com/scrapesage/eventbrite-scraper)** — events plus organizer leads with emails. - **[Facebook Ad Library Scraper](https://apify.com/scrapesage/facebook-ad-library-scraper)** — competitor ad intelligence. - **[Google Ads Transparency Scraper](https://apify.com/scrapesage/google-ads-transparency-scraper)** — who's advertising what on Google. - **[Airbnb Scraper](https://apify.com/scrapesage/airbnb-scraper)** — listings, prices, and availability. ### Tips - **Exhaust a city**: Healthgrades caps a single search at a few hundred results. Split by specialty and/or use multiple ZIPs/cities to cover a metro completely. - **Cost control**: turn off *Include provider details* for a fast, cheap listing (the search results already carry NPI, specialty, rating, phone, address and patient-experience scores); turn it on for education, board certs, insurance and hospital affiliations. - **Email enrichment** only runs for providers whose profile exposes a practice website, so you pay for it only when there's something to crawl. - **Recurring monitoring**: combine [Schedules](https://docs.apify.com/platform/schedules) with **Monitoring mode** to receive only newly listed providers in your target specialty/area. ### FAQ **How do I scrape doctors for a specific city and specialty?** Put the specialty in *Search terms* (e.g. `Cardiology`) and the place in *Locations* as `City, ST` or a ZIP (e.g. `Miami, FL`). Each term is combined with each location. **Do I need a Healthgrades or NPI API key?** No. This actor reads public Healthgrades pages — no key, no login, no browser. **Where do the emails come from?** Never from Healthgrades (it doesn't publish emails). With *Enrich practice emails* on, the actor visits the provider's own practice website and extracts publicly listed contact emails — the same thing a human visitor would see. **Can I export to Google Sheets, CSV, or Excel?** Yes — one click in the dataset view, or automatically on every run via the [Google Drive integration](https://docs.apify.com/platform/integrations/drive). **How do I monitor new providers automatically?** Turn on **Monitoring mode** and create a [Schedule](https://docs.apify.com/platform/schedules); each run emits only providers not seen before. Add a [webhook](https://docs.apify.com/platform/integrations/webhooks) to push them into your CRM. **A field is null — why?** Some providers genuinely don't publish education, languages, a website or a full review history. Fields are `null` only when the data doesn't exist, not because the scraper skipped them. **Is scraping Healthgrades legal?** This actor collects publicly available data only. You are responsible for using the data in compliance with applicable laws (e.g. GDPR/CCPA for personal data, and TCPA/CAN-SPAM and HIPAA-adjacent rules for outreach) and Healthgrades' terms. ### Need help? Open an issue on the actor's **Issues** tab, or visit the [Apify help center](https://help.apify.com/). Feature requests are welcome — this actor is actively maintained. # Actor input Schema ## `searchQueries` (type: `array`): What to search for on Healthgrades — a specialty (`Dentistry`, `Cardiology`, `Dermatology`), a condition/procedure, or a doctor's name. Each term is combined with every location below. Leave empty if you only use Start URLs. ## `locations` (type: `array`): Where to search — `City, ST` (e.g. `New York, NY`, `Austin, TX`) or a 5-digit ZIP code. Each location is paired with every search term. Required for search; ignored for Start URLs. ## `startUrls` (type: `array`): Paste Healthgrades provider profile URLs (`/physician/...`, `/dentist/...`) or search-result URLs (`/usearch?what=...&where=...`). Processed in addition to any search terms above. ## `maxProvidersPerSearch` (type: `integer`): Cap the number of providers collected per search term + location pair (each results page has ~20 providers). Raise it for bigger pulls — opening every profile for full details is the slow part, so very large caps need a higher run timeout. ## `maxProviders` (type: `integer`): Global cap on the total number of provider records emitted in this run, across all searches and Start URLs. ## `acceptingNewPatientsOnly` (type: `boolean`): Keep only providers flagged as accepting new patients. ## `minRating` (type: `integer`): Keep only providers with an overall star rating at or above this value (0 = no filter). Rated 1-5. ## `gender` (type: `string`): Optionally keep only male or female providers. ## `telehealthOnly` (type: `boolean`): Keep only providers that offer telehealth visits. ## `includeProviderDetails` (type: `boolean`): Visit each provider's profile page to add the deep fields: education, residencies, board certifications, certifying agencies, languages, accepted insurance, all practice locations with geo, fax, hospital affiliations, conditions treated, procedures and awards. One extra request per provider. ## `includeReviews` (type: `boolean`): Also output patient review records (type `review`) from each provider's profile — star rating, review text, author and date (most recent batch shown on the profile). Requires opening profiles. ## `maxReviewsPerProvider` (type: `integer`): How many reviews to emit per provider when 'Include patient reviews' is on. ## `enrichPracticeEmails` (type: `boolean`): Opt-in lead enrichment: when a provider/practice website is found, visit it (home + a contact/about page) and extract contact emails, phone numbers and social links — for medical sales, recruiting and partnership outreach. Only runs when a website exists. ## `deduplicateProviders` (type: `boolean`): Emit each provider only once per run (keyed by NPI / profile URL), even if they appear in multiple searches or locations. ## `monitorMode` (type: `boolean`): Remember providers already returned and emit ONLY providers not seen in previous runs (new doctors/practices for a search). Pairs with Apify Schedules to track new providers in a specialty or area over time. ## `monitorStoreName` (type: `string`): Named key-value store that holds the 'already seen' provider ids for monitoring mode. Use a different name per tracked search to keep their histories separate. ## `maxConcurrency` (type: `integer`): Maximum parallel requests. Raise it to pull large result sets faster (uses more memory — give the run 2 GB+ if you push it high); lower it if you hit rate limits on very large runs. ## `proxyConfiguration` (type: `object`): Proxy settings. Healthgrades serves clean pages to US IPs, so the default Apify proxy is enough; switch to residential for very large or high-frequency runs. ## Actor input object example ```json { "searchQueries": [ "Dentistry" ], "locations": [ "New York, NY" ], "maxProvidersPerSearch": 30, "maxProviders": 200, "acceptingNewPatientsOnly": false, "minRating": 0, "gender": "any", "telehealthOnly": false, "includeProviderDetails": true, "includeReviews": false, "maxReviewsPerProvider": 25, "enrichPracticeEmails": false, "deduplicateProviders": true, "monitorMode": false, "monitorStoreName": "healthgrades-monitor", "maxConcurrency": 6, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyCountry": "US" } } ``` # Actor output Schema ## `results` (type: `string`): All scraped records in the default dataset. Provider rows carry full profile, ratings, specialties, practice locations, phones, lead data and enrichment; review rows carry their own fields. # 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 = { "searchQueries": [ "Dentistry" ], "locations": [ "New York, NY" ] }; // Run the Actor and wait for it to finish const run = await client.actor("scrapesage/healthgrades-scraper").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 = { "searchQueries": ["Dentistry"], "locations": ["New York, NY"], } # Run the Actor and wait for it to finish run = client.actor("scrapesage/healthgrades-scraper").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 '{ "searchQueries": [ "Dentistry" ], "locations": [ "New York, NY" ] }' | apify call scrapesage/healthgrades-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=scrapesage/healthgrades-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Healthgrades Scraper — Doctors, Reviews & Provider Leads", "description": "Scrape Healthgrades doctors & healthcare providers by specialty and location, or from profile URLs. Get NPI, specialties, ratings, patient reviews, education, board certifications, locations, phones & leads — plus optional practice-email enrichment and monitoring. No login, no browser.", "version": "0.1", "x-build-id": "M0Jmv5xd5OTbXU8XW" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapesage~healthgrades-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapesage-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/scrapesage~healthgrades-scraper/runs": { "post": { "operationId": "runs-sync-scrapesage-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/scrapesage~healthgrades-scraper/run-sync": { "post": { "operationId": "run-sync-scrapesage-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": { "searchQueries": { "title": "Search terms (specialty, condition or doctor name)", "type": "array", "description": "What to search for on Healthgrades — a specialty (`Dentistry`, `Cardiology`, `Dermatology`), a condition/procedure, or a doctor's name. Each term is combined with every location below. Leave empty if you only use Start URLs.", "items": { "type": "string" } }, "locations": { "title": "Locations (City, ST or ZIP)", "type": "array", "description": "Where to search — `City, ST` (e.g. `New York, NY`, `Austin, TX`) or a 5-digit ZIP code. Each location is paired with every search term. Required for search; ignored for Start URLs.", "items": { "type": "string" } }, "startUrls": { "title": "Start URLs (provider profiles or search pages)", "type": "array", "description": "Paste Healthgrades provider profile URLs (`/physician/...`, `/dentist/...`) or search-result URLs (`/usearch?what=...&where=...`). Processed in addition to any search terms above.", "items": { "type": "string" } }, "maxProvidersPerSearch": { "title": "Max providers per search", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Cap the number of providers collected per search term + location pair (each results page has ~20 providers). Raise it for bigger pulls — opening every profile for full details is the slow part, so very large caps need a higher run timeout.", "default": 30 }, "maxProviders": { "title": "Max providers (whole run)", "minimum": 1, "maximum": 50000, "type": "integer", "description": "Global cap on the total number of provider records emitted in this run, across all searches and Start URLs.", "default": 200 }, "acceptingNewPatientsOnly": { "title": "Only providers accepting new patients", "type": "boolean", "description": "Keep only providers flagged as accepting new patients.", "default": false }, "minRating": { "title": "Minimum star rating", "minimum": 0, "maximum": 5, "type": "integer", "description": "Keep only providers with an overall star rating at or above this value (0 = no filter). Rated 1-5.", "default": 0 }, "gender": { "title": "Gender", "enum": [ "any", "M", "F" ], "type": "string", "description": "Optionally keep only male or female providers.", "default": "any" }, "telehealthOnly": { "title": "Only providers offering telehealth", "type": "boolean", "description": "Keep only providers that offer telehealth visits.", "default": false }, "includeProviderDetails": { "title": "Open each profile for full details", "type": "boolean", "description": "Visit each provider's profile page to add the deep fields: education, residencies, board certifications, certifying agencies, languages, accepted insurance, all practice locations with geo, fax, hospital affiliations, conditions treated, procedures and awards. One extra request per provider.", "default": true }, "includeReviews": { "title": "Include patient reviews", "type": "boolean", "description": "Also output patient review records (type `review`) from each provider's profile — star rating, review text, author and date (most recent batch shown on the profile). Requires opening profiles.", "default": false }, "maxReviewsPerProvider": { "title": "Max reviews per provider", "minimum": 1, "maximum": 200, "type": "integer", "description": "How many reviews to emit per provider when 'Include patient reviews' is on.", "default": 25 }, "enrichPracticeEmails": { "title": "Enrich practice contacts (crawl website for emails, phone, socials)", "type": "boolean", "description": "Opt-in lead enrichment: when a provider/practice website is found, visit it (home + a contact/about page) and extract contact emails, phone numbers and social links — for medical sales, recruiting and partnership outreach. Only runs when a website exists.", "default": false }, "deduplicateProviders": { "title": "Deduplicate providers", "type": "boolean", "description": "Emit each provider only once per run (keyed by NPI / profile URL), even if they appear in multiple searches or locations.", "default": true }, "monitorMode": { "title": "Monitoring mode — only new providers", "type": "boolean", "description": "Remember providers already returned and emit ONLY providers not seen in previous runs (new doctors/practices for a search). Pairs with Apify Schedules to track new providers in a specialty or area over time.", "default": false }, "monitorStoreName": { "title": "Monitor store name", "type": "string", "description": "Named key-value store that holds the 'already seen' provider ids for monitoring mode. Use a different name per tracked search to keep their histories separate.", "default": "healthgrades-monitor" }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "maximum": 20, "type": "integer", "description": "Maximum parallel requests. Raise it to pull large result sets faster (uses more memory — give the run 2 GB+ if you push it high); lower it if you hit rate limits on very large runs.", "default": 6 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Proxy settings. Healthgrades serves clean pages to US IPs, so the default Apify proxy is enough; switch to residential for very large or high-frequency runs.", "default": { "useApifyProxy": true, "apifyProxyCountry": "US" } } } }, "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 } } } } } } } } } } ```