Endpoint Playground
Returns 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.
14 Oct 2026: 20 facilities; 14 fields had a value in every checked item and 3 varied between items.
Sample value profiles: distance_miles: 0.4 to 5.33, median 2.82; url: healthgrades.com; about: median 202 characters.
curl 'https://api.crawlora.net/api/v1/healthgrades/facilities/search?type=hospital&where=Boston%2C+MA&sort=bestmatch&distance=0.5' \
-H "x-api-key: $CRAWLORA_API_KEY"| Parameter | Type | Required | Prefilled value | Description |
|---|---|---|---|---|
| type | string | Yes | hospital | Facility type |
| query | string | No | Optional facility name or keyword | |
| where | string | Yes | Boston, MA | City and state, or ZIP code |
| page | integer | No | Result page (1-500, 20 results per page) | |
| sort | string | No | bestmatch | Result order; patientsatisfaction is hospital-only and group_practice supports only distance |
| distance | string | No | 0.5 | Search radius in miles |
| rating | string | No | Hospital specialty-rating value from /healthgrades/facilities/filters (type=hospital only) | |
| award | string | No | Hospital award value from /healthgrades/facilities/filters (type=hospital only) |
{
"code": 0,
"message": "success",
"data": {
"type": "hospital",
"query": "Mass General",
"where": "Boston, MA",
"page": 1,
"page_size": 20,
"total_results": 7,
"total_pages": 1,
"sort": "bestmatch",
"facilities": [
{
"id": "60C282",
"name": "Massachusetts General Hospital",
"type": "hospital",
"type_code": "STAC",
"url": "https://www.healthgrades.com/hospital/massachusetts-general-hospital-60c282",
"city": "Boston",
"state": "MA",
"awards": [
"America's 250 Best Hospitals Award"
]
}
],
"filters": [
{
"param": "distance",
"label": "Distance",
"values": [
{
"value": "0.5",
"label": "0.5 miles"
}
]
}
]
}
}The sample response, schema and code snippets below work without an account. Sending a live request needs an API key.