Endpoint Playground
Returns 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.
14 Oct 2026: 3 filters; 3 fields had a value in every checked item.
Sample value profiles: values: median 17 entries.
curl 'https://api.crawlora.net/api/v1/healthgrades/hospital-awards/filters?award=americas-best-hospitals' \
-H "x-api-key: $CRAWLORA_API_KEY"| Parameter | Type | Required | Prefilled value | Description |
|---|---|---|---|---|
| award | string | Yes | americas-best-hospitals | Award list |
| state | string | No | State slug, to list its cities | |
| year | string | No | Award year |
{
"code": 0,
"message": "success",
"data": {
"award": "patient-safety-excellence-award",
"sorts": [
{
"key": "name",
"label": "Hospitals (A to Z)"
},
{
"key": "distance",
"label": "Closest (with latitude and longitude)"
}
],
"filters": [
{
"param": "year",
"label": "Year",
"values": [
{
"value": "2026",
"label": "2026",
"selected": true
}
]
},
{
"param": "city",
"label": "City",
"values": [
{
"value": "los-angeles",
"label": "Los Angeles",
"count": 5
}
]
}
]
}
}The sample response, schema and code snippets below work without an account. Sending a live request needs an API key.