Endpoint Playground
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.
14 Oct 2026: 20 hospitals; 9 fields had a value in every checked item.
Sample value profiles: url: healthgrades.com; description: median 197 characters; awards: median 13 entries.
curl 'https://api.crawlora.net/api/v1/healthgrades/hospital-awards?award=americas-best-hospitals&list=top50&list_category=top50&specialty=BAR&ob_gyn_type=GYS&sort=name' \
-H "x-api-key: $CRAWLORA_API_KEY"| Parameter | Type | Required | Prefilled value | Description |
|---|---|---|---|---|
| award | string | Yes | americas-best-hospitals | Award list |
| year | string | No | Award year from the filters (defaults to the latest) | |
| state | string | No | State slug from the filters | |
| city | string | No | City slug from the filters for the state (requires state) | |
| list | string | No | top50 | America's Best Hospitals list size (award=americas-best-hospitals) |
| list_category | string | No | top50 | Specialty Excellence list size (award=specialty-excellence-americas-best-care) |
| specialty | string | No | BAR | Specialty code (award=specialty-excellence-americas-best-care or state-rankings) |
| ob_gyn_type | string | No | GYS | Ob-Gyn award (award=ob-gyn-care-excellence-awards): GYS gynecologic surgery, LAB labor and delivery, OBG obstetrics and gynecology |
| sort | string | No | name | Result order; distance requires latitude and longitude |
| latitude | number | No | Latitude for distance sorting | |
| longitude | number | No | Longitude for distance sorting | |
| page | integer | No | Page number (20 hospitals per page) |
{
"code": 0,
"message": "success",
"data": {
"award": "state-rankings",
"title": "Healthgrades Specialty State Rankings",
"year": "2026",
"region": "Texas",
"sort": "name",
"page": 1,
"page_size": 20,
"total": 5,
"total_pages": 1,
"hospitals": [
{
"id": "6D9F49",
"name": "Baylor Scott and White the Heart Hospital Plano",
"url": "https://www.healthgrades.com/hospital/baylor-scott-and-white-the-heart-hospital-plano-6d9f49",
"phone": "(469) 814-3278",
"address": {
"street": "1100 Allied Dr",
"city": "Plano",
"state": "TX",
"postal_code": "75093"
},
"awards": [
{
"code": "CVO",
"name": "Cardiac Care Excellence Award",
"years": [
2026,
2025
],
"matched": true
}
]
}
]
}
}The sample response, schema and code snippets below work without an account. Sending a live request needs an API key.