healthgrades_hospital_awards
Retrieve Healthgrades hospital award recipients by award, year, state, city, or specialty to get profile URLs, addresses, phone numbers, and award years.
Instructions
List Healthgrades hospital award recipients. Returns 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.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| city | No | City slug from the filters for the state (requires state) | |
| list | No | America's Best Hospitals list size (award=americas-best-hospitals) | |
| page | No | Page number (20 hospitals per page) | |
| sort | No | Result order; distance requires latitude and longitude | |
| year | No | Award year from the filters (defaults to the latest) | |
| award | Yes | Award list | |
| state | No | State slug from the filters | |
| latitude | No | Latitude for distance sorting | |
| longitude | No | Longitude for distance sorting | |
| specialty | No | Specialty code (award=specialty-excellence-americas-best-care or state-rankings) | |
| ob_gyn_type | No | Ob-Gyn award (award=ob-gyn-care-excellence-awards): GYS gynecologic surgery, LAB labor and delivery, OBG obstetrics and gynecology | |
| list_category | No | Specialty Excellence list size (award=specialty-excellence-americas-best-care) |