API Reference
Search Healthgrades physicians and facilities, fetch public profiles, browse Health A-Z articles, and track hospital awards as structured JSON. 16 endpoints documented below.
curl "https://api.crawlora.net/api/v1/healthgrades/physicians/search?query=Cardiology&where=Boston%2C+MA" \
-H "x-api-key: $CRAWLORA_API_KEY"Crawlora's 16 Healthgrades endpoints connect directory discovery to public profile detail, Health A-Z content, and hospital awards. On 2026-10-04, a live physician search for Cardiology in Boston returned 350 results across 18 pages, with 20 physicians on page one and filter groups for insurance, gender, distance, age, availability, language, rating, clinical focus, hospital affiliation, and affirming care. Read filter values from the matching filters endpoint or search response instead of inventing codes. Patient-authored review text is never returned, and the data routes use US egress where Healthgrades restricts content by region.
Call /healthgrades/physicians/search with a specialty, condition, procedure, or provider query and optional location. Use /healthgrades/physicians/filters for query-specific insurer, language, specialty, clinical-focus, and hospital codes, then pass a returned profile URL to /healthgrades/physician for professional fields and practice locations.
Use /healthgrades/facilities/search for hospitals, pharmacies, urgent-care centers, or group practices. Pair hospital-only rating and award values from /healthgrades/facilities/filters with the same search, then retrieve /healthgrades/hospital or /healthgrades/facility by a returned profile URL.
Start with /healthgrades/health-topics, then page through /healthgrades/health-articles for a returned topic slug; the list is ordered by most recently modified. Pass a returned URL to /healthgrades/health-article and preserve its authors, reviewed_by, date_published, and date_modified fields. Healthgrades says condition, treatment, and wellness content is medically reviewed at least once every two years and is educational, not medical advice, so retain its review dates rather than treating it as real-time guidance.
Read valid award years, states, cities, and specialty values from /healthgrades/hospital-awards/filters, then query /healthgrades/hospital-awards. The result includes award-matched hospitals and profile URLs that can feed the hospital-detail route.
Healthgrades API endpoints/healthgrades/autocompleteapiKey2 credits/requestReturns dynamic provider, specialty, condition, procedure, and other suggestions for a free-text query. Group categories vary with the query and are returned as data, not accepted as a closed enum.
Required: term.
Sampled 14 Oct 2026: 4 items. Filled in every item: category, title, suggestions. In the sample: suggestions: median 5 entries.
/healthgrades/facilities/filtersapiKey2 credits/requestReturns the sorts and filters for a Healthgrades facility search: distance values and, for hospitals, every specialty rating and award value accepted by /healthgrades/facilities/search.
Required: type (4 allowed values: hospital, pharmacy, group_practice, urgent_care), where. Optional: query.
Sampled 14 Oct 2026: 3 items. Filled in every item: key, label.
/healthgrades/facilities/searchapiKey3 credits/requestReturns one page of Healthgrades facility search results near a location for one facility type (hospital, pharmacy, group practice, or urgent care), with name, address, phone, distance, profile URL, affiliated provider and rating counts, hospital awards, and the filters available for the search. Requests use US egress because Healthgrades restricts content by region.
Required: type (4 allowed values: hospital, pharmacy, group_practice, urgent_care), where. Optional: query, page, sort (3 allowed values: bestmatch, distance, patientsatisfaction), distance (8 allowed values: 0.5, 1, 5, 10, 25, 50, 100, national), rating, award.
Sampled 14 Oct 2026: 20 items. Filled in every item: id, name, type, type_code, url, phone, street, city and 6 more. Not in every item: affiliated_provider_count (16), five_star_ratings_count (10), awards (9). In the sample: distance_miles: 0.4 to 5.33, median 2.82; url: healthgrades.com; about: median 202 characters; awards: median 5 entries; affiliated_provider_count: 1 to 5,342, median 821; five_star_ratings_count: 2 to 26, median 4.
/healthgrades/facilityapiKey2 credits/requestReturns one Healthgrades pharmacy, urgent care center, or group practice profile; the type (pharmacy, urgent_care, or group_practice) is inferred from the URL. Pharmacies: opening hours, services (for example compounding, immunizations, Medicare), and nearby pharmacies. Urgent care centers: opening hours and aggregated visitor answers to amenity questions. Group practices: specialties, providers with specialty and rating, medical services offered, language services, office locations with phones and coordinates, FAQs, and nearby offices. All types include name, address, and phone. Patient-authored reviews are not returned. Requests use US egress because Healthgrades restricts content by region.
Required: url.
Sampled 14 Oct 2026: 7 items. Filled in every item: day, hours.
/healthgrades/health-articleapiKey2 credits/requestReturns one Healthgrades Health A-Z or drug article: headline, description, authors, medical reviewers, published and modified dates, image, the conditions the article is tagged with, and the article body as headed sections of paragraphs and lists. Works for standard, chaptered, and slideshow articles. Requests use US egress because Healthgrades restricts content by region.
Required: url.
Sampled 14 Oct 2026: 11 fields returned with a value. In the sample: date_published: 2021-11-01; url: resources.healthgrades.com; headline: 8 characters; authors: 1 entry; description: 199 characters; reviewed_by: 1 entry; date_modified: 2023-03-06; conditions: 3 entries.
/healthgrades/health-articlesapiKey2 credits/requestReturns one page of a Healthgrades Health A-Z topic's articles (slug, URL, and last-modified date), most recently modified first, with total and total pages. Use topic=drugs for drug articles. Use an article URL with /healthgrades/health-article.
Required: topic. Optional: page, page_size.
Sampled 14 Oct 2026: 20 items. Filled in every item: slug, topic, url, last_modified. In the sample: last_modified: 2026-09-15 to 2026-10-02; url: resources.healthgrades.com.
/healthgrades/health-topicsapiKey2 credits/requestReturns every topic of Healthgrades' Health A-Z library (conditions, body systems, treatments, and wellness topics) with its article count, last-modified date, and topic hub URL where one exists, plus the drugs topic for Healthgrades' drug articles. Use a slug with /healthgrades/health-articles.
Takes no parameters.
Sampled 14 Oct 2026: 196 items. Filled in every item: slug, article_count, last_modified. Not in every item: url (171). In the sample: last_modified: 2020-08-03 to 2026-10-12; article_count: 1 to 599, median 20; url: resources.healthgrades.com.
/healthgrades/hospital-awardsapiKey2 credits/requestReturns one page (20 hospitals) of a Healthgrades hospital quality award list: America's Best Hospitals (top 50, 100, or 250), Specialty Excellence (by specialty, top 50 or 100), Patient Safety Excellence, Outstanding Patient Experience, Ob-Gyn Care, or Specialty State Rankings. Filter by year, state, city, specialty, and Ob-Gyn award type; sort by name or, with latitude and longitude, by distance. Each hospital includes its profile URL (for /healthgrades/hospital), address, coordinates, phone, and every award it holds with years. Read accepted filter values from /healthgrades/hospital-awards/filters. Requests use US egress because Healthgrades restricts content by region.
Required: award (6 allowed values: americas-best-hospitals, specialty-excellence-americas-best-care, patient-safety-excellence-award, outstanding-patient-experience-award, ob-gyn-care-excellence-awards, state-rankings). Optional: year, state, city, list (3 allowed values: top50, top100, top250), list_category (2 allowed values: top50, top100), specialty (20 allowed values: BAR, CVO, CWS, PCI, NSG, CCU, GIO, GSO, ORJ, NSC, ORT, OJO, OOR, OBP, PRS, PUL, ORS, NEU, OVSC, VAS), ob_gyn_type (3 allowed values: GYS, LAB, OBG), sort (2 allowed values: name, distance), latitude, longitude, page.
Sampled 14 Oct 2026: 20 items. Filled in every item: id, name, url, description, phone, address, latitude, longitude and 1 more. In the sample: url: healthgrades.com; description: median 197 characters; awards: median 13 entries.
/healthgrades/hospital-awards/filtersapiKey2 credits/requestReturns the filter values Healthgrades offers for one hospital award list: list sizes, specialty codes, Ob-Gyn award types, award years, states with recipients, and (with a state) cities with recipient counts, plus the sort options. Each group's param names the /healthgrades/hospital-awards parameter that accepts its values.
Required: award (6 allowed values: americas-best-hospitals, specialty-excellence-americas-best-care, patient-safety-excellence-award, outstanding-patient-experience-award, ob-gyn-care-excellence-awards, state-rankings). Optional: state, year.
Sampled 14 Oct 2026: 3 items. Filled in every item: param, label, values. In the sample: values: median 17 entries.
/healthgrades/hospitalapiKey2 credits/requestReturns one Healthgrades hospital profile: hospital-wide and specialty awards with years, clinical outcome ratings by service line (procedure or condition, measure, outcome rating, and 1-5 stars), patient-experience measures with national comparisons, address, and phone. Patient-authored reviews are not returned. Requests use US egress because Healthgrades restricts content by region.
Required: url.
Sampled 14 Oct 2026: 12 items. Filled in every item: name, category, years. Not in every item: description (3). In the sample: description: median 200 characters; years: median 1 entry.
/healthgrades/locationsapiKey2 credits/requestReturns location autocomplete suggestions for a city, state, ZIP code, or other free-text location. Private upstream metadata and coordinates are omitted.
Required: term.
Sampled 14 Oct 2026: 1 item. Filled in every item: category, title, suggestions. In the sample: suggestions: median 5 entries.
/healthgrades/physicianapiKey2 credits/requestReturns public professional profile fields and practice locations for one Healthgrades physician. Patient-authored review text is not returned. Requests use US egress because Healthgrades restricts some content by region.
Required: url.
Sampled 14 Oct 2026: 7 fields returned with a value. In the sample: npi: 1,134,108,103; profile_url: healthgrades.com; image_url: 138 characters; specialties: 1 entry; awards: 1 entry; practices: 1 entry.
/healthgrades/physicians/filtersapiKey2 credits/requestReturns every filter available for a Healthgrades provider search at a location, with accepted values, labels, and result counts: insurers (with plan IDs), gender, distance, age, availability, language, patient rating, clinical focus, affiliated hospitals, practicing specialties, and affirming care. Insurer, language, clinical focus, hospital, and specialty values depend on the query and location. Each group's param names the /healthgrades/physicians/search parameter that accepts its values.
Required: query. Optional: where.
Sampled 14 Oct 2026: 10 items. Filled in every item: param, label, values. In the sample: values: median 6 entries.
/healthgrades/physicians/searchapiKey3 credits/requestReturns one page of Healthgrades provider search results for a specialty, condition, procedure, or provider name near a location, with each provider's NPI, specialty, office, aggregate patient rating, accepted insurers, and profile URL, plus the filters available for the search. Closed-set filters accept the listed values; insurance, insurance_plan, language, clinical_focus, affiliated_hospital, and specialty accept values returned in the filters for the same query/where. List filters take comma-separated values. Requests use US egress because Healthgrades restricts content by region. Patient review text is not returned.
Required: query. Optional: where, page, sort (3 allowed values: bestmatch, distance, ratings), gender (2 allowed values: F, M), distance (7 allowed values: 1, 5, 10, 25, 50, 100, national), age (5 allowed values: *-40, 41-50, 51-60, 61-70, 71-*), availability (6 allowed values: today, tomorrow, nextTwoWeeks, online, acceptsNewPatients, telehealth), rating (5 allowed values: 1, 2, 3, 4, 5), insurance, insurance_plan, language, clinical_focus, affiliated_hospital, specialty, affirming_care.
Sampled 14 Oct 2026: 20 items. Filled in every item: name, id, npi, profile_url, specialty, specialist_descriptions, gender, age and 9 more. Not in every item: years_experience (17), image_url (4). In the sample: npi: 1,003,852,526 to 1,962,454,298, median 1,427,029,263; profile_url: healthgrades.com; accepts_new_patients: true in 6 of 20; about: median 134 characters; specialist_descriptions: median 2 entries; age: 43 to 79, median 56; years_experience: 10 to 40, median 25; telehealth_available: true in 14 of 20.
/healthgrades/specialtiesapiKey2 credits/requestReturns every specialty name and directory URL shown on Healthgrades' public A-Z specialty directory.
Takes no parameters.
Sampled 14 Oct 2026: 184 items. Filled in every item: name, url. In the sample: url: healthgrades.com.
/healthgrades/top-searchesapiKey2 credits/requestReturns the popular specialty searches Healthgrades currently suggests, in `groups`. Each group has a category, a title such as Popular Healthcare Specialties, and suggestions with a label and value. The set changes over time and is not a fixed list.
Takes no parameters.
Sampled 14 Oct 2026: 1 item. Filled in every item: category, title, suggestions. In the sample: suggestions: median 12 entries.
Results from the 7 days to 14 Oct 2026. Current status
| Endpoint | Request | Checks passed | Median response |
|---|---|---|---|
| Get Healthgrades search suggestions | GET /healthgrades/autocomplete?term=orthopedic+surgeon | 100% | 1.85 s |
| List Healthgrades facility search filters | GET /healthgrades/facilities/filters?type=hospital&where=Boston%2C+MA | 100% | 4.18 s |
| Search Healthgrades hospitals, pharmacies, group practices, and urgent care | GET /healthgrades/facilities/search?type=hospital&where=Boston%2C+MA | 100% | 4.26 s |
| Get a Healthgrades pharmacy, urgent care, or group practice profile | GET /healthgrades/facility?url=https%3A%2F%2Fwww.healthgrades.com%2Fpharmacy%2Fwalgreens-12805-pas6pu | 100% | 2.41 s |
| Get a Healthgrades Health A-Z article | GET /healthgrades/health-article?url=https%3A%2F%2Fresources.healthgrades.com%2Fdrugs%2Fatenolol | 100% | 1.61 s |
| List Healthgrades Health A-Z articles in a topic | GET /healthgrades/health-articles?topic=diabetes | 100% | 3.00 s |
| List Healthgrades Health A-Z topics | GET /healthgrades/health-topics | 99.7% | 2.83 s |
| List Healthgrades hospital award recipients | GET /healthgrades/hospital-awards?award=americas-best-hospitals&list=top50 | 100% | 2.69 s |
| List Healthgrades hospital award filters | GET /healthgrades/hospital-awards/filters?award=state-rankings | 100% | 2.64 s |
| Get a Healthgrades hospital profile | GET /healthgrades/hospital?url=https%3A%2F%2Fwww.healthgrades.com%2Fhospital%2Fmassachusetts-general-hospital-60c282 | 100% | 1.97 s |
| Get Healthgrades location suggestions | GET /healthgrades/locations?term=Boston | 100% | 1.58 s |
| Get a Healthgrades physician profile | GET /healthgrades/physician?url=https%3A%2F%2Fwww.healthgrades.com%2Fphysician%2Fdr-nitinkumar-shah-xvwnq | 100% | 3.56 s |
| List Healthgrades physician search filters | GET /healthgrades/physicians/filters?query=Cardiology&where=Boston%2C+MA | 100% | 4.41 s |
| Search Healthgrades physicians | GET /healthgrades/physicians/search?query=Cardiology&where=Boston%2C+MA | 100% | 4.54 s |
| List Healthgrades physician specialties | GET /healthgrades/specialties | 100% | 2.24 s |
| List popular Healthgrades searches | GET /healthgrades/top-searches | 100% | 1.03 s |