Healthgrades

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.

get/healthgrades/hospital-awards

Request

  • Base URL: https://api.crawlora.net/api/v1
  • URL: https://api.crawlora.net/api/v1/healthgrades/hospital-awards
  • Auth: API key in header x-api-key

Query parameters

award'americas-best-hospitals' | 'specialty-excellence-americas-best-care' | 'patient-safety-excellence-award' | 'outstanding-patient-experience-award' | 'ob-gyn-care-excellence-awards' | 'state-rankings' required

Award list

yearstring

Award year from the filters (defaults to the latest)

statestring

State slug from the filters

citystring

City slug from the filters for the state (requires state)

list'top50' | 'top100' | 'top250'

America's Best Hospitals list size (award=americas-best-hospitals)

list_category'top50' | 'top100'

Specialty Excellence list size (award=specialty-excellence-americas-best-care)

specialty'BAR' | 'CVO' | 'CWS' | 'PCI' | 'NSG' | 'CCU' | 'GIO' | 'GSO' | 'ORJ' | 'NSC' | 'ORT' | 'OJO' | 'OOR' | 'OBP' | 'PRS' | 'PUL' | 'ORS' | 'NEU' | 'OVSC' | 'VAS'

Specialty code (award=specialty-excellence-americas-best-care or state-rankings)

ob_gyn_type'GYS' | 'LAB' | 'OBG'

Ob-Gyn award (award=ob-gyn-care-excellence-awards): GYS gynecologic surgery, LAB labor and delivery, OBG obstetrics and gynecology

sort'name' | 'distance'

Result order; distance requires latitude and longitude

latitudenumber

Latitude for distance sorting

longitudenumber

Longitude for distance sorting

pageinteger

Page number (20 hospitals per page)

Headers

x-api-keystring required

API key required

Response

OK

Changes

No recorded changes to this operation across all 3 revisions of this API.