Docs menu

Healthgrades API endpoint

Healthgrades facility search filters API

Returns the sorts and filters for a Healthgrades facility search: distance values and, for hospitals, every specialty rating and award value accepted by /healthgrades/facilities/search.

GETapiKey2 credits/requestHealthgradeshealthgrades.facilityFiltersResponseDoc/healthgrades/facilities/filters

Endpoint facts

Method: GET
API path: /healthgrades/facilities/filters
Auth: apiKey
Credits: 2 credits/request
Charged on: Successful 2xx responses only
Platform: Healthgrades
Response schema: #/definitions/healthgrades.facilityFiltersResponseDoc

Healthgrades Scraper API Try Healthgrades facility search filters API in Playground Healthgrades API documentation

How this endpoint behaves

Query parameters:

type (required): hospital, pharmacy, group_practice, or urgent_care.
query (optional): facility name or keyword.
where (required): city and state or ZIP code.

Returns the supported sorts and the filter groups. Each group's param names the /api/v1/healthgrades/facilities/search parameter: distance (0.5, 1, 5, 10, 25, 50, 100, national) and, for hospitals, rating (specialty ratings such as Bowel Obstruction|BLO, with counts) and award (hospital awards such as Critical Care Excellence Award|CCU, with counts; present only where nearby hospitals hold awards).

Live monitoring

Monitored request: GET /healthgrades/facilities/filters?type=hospital&where=Boston%2C+MA
Checks passed, 7 days to 14 Oct 2026: 100%
Median response time: 4.18 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /healthgrades/facilities/filters?type=hospital&where=Boston%2C+MA
Items in sorts: 3
Fields filled in every checked item: 2

Field	Filled in, of 3 checked
key	3
label	3

Request parameters

Parameter	Type	Required	Description	Example
type	string	Yes	Facility type Allowed values: hospital, pharmacy, group_practice, urgent_care.	hospital
query	string	No	Optional facility name or keyword
where	string	Yes	City and state, or ZIP code	Boston, MA
x-api-key (header)	string	Yes	API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/healthgrades/facilities/filters?type=hospital&query=coffee&where=Boston%2C+MA" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 0,
  "message": "success",
  "data": {
    "type": "hospital",
    "where": "Boston, MA",
    "sorts": [
      {
        "key": "bestmatch",
        "label": "Best Match"
      },
      {
        "key": "distance",
        "label": "Closest"
      },
      {
        "key": "patientsatisfaction",
        "label": "Patient Satisfaction"
      }
    ],
    "filters": [
      {
        "param": "rating",
        "label": "Ratings",
        "values": [
          {
            "value": "Bowel Obstruction|BLO",
            "label": "Bowel Obstruction"
          }
        ]
      }
    ]
  }
}

Request schema

No body schema

Response schema

#/definitions/healthgrades.facilityFiltersResponseDoc

Field	Type	Required	Description
data	healthgrades.FacilityFiltersResponse	No
data.filters	array	No	PhysicianFilterGroup record, 10 fields: label, param, values. Described under Healthgrades facility search API.
data.query	string	No
data.sorts	array	No
data.sorts[].key	string	No
data.sorts[].label	string	No
data.type	string	No
data.where	string	No

Failure responses

Status	Description	Schema
400	Bad Request	#/definitions/app.Response
429	Too Many Requests	#/definitions/app.Response
503	Service Unavailable	#/definitions/app.Response

Code examples

Use environment variables for secrets and keep Crawlora API keys server-side.

curl -X GET "https://api.crawlora.net/api/v1/healthgrades/facilities/filters?type=hospital&query=coffee&where=Boston%2C+MA" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Shared guides

Authentication Errors and retries Rate limits and credits Pricing Acceptable use

More Healthgrades endpoint docs Healthgrades Scraper API Healthgrades search autocomplete API documentation Healthgrades facility search API documentation Healthgrades facility profile API documentation Healthgrades Health A-Z article API documentation Healthgrades Health A-Z articles API documentation Healthgrades Health A-Z topics API documentation

Open in Playground Back to group

Docs menu

Healthgrades API endpoint

Healthgrades facility search filters API

Returns the sorts and filters for a Healthgrades facility search: distance values and, for hospitals, every specialty rating and award value accepted by /healthgrades/facilities/search.

GETapiKey2 credits/requestHealthgradeshealthgrades.facilityFiltersResponseDoc/healthgrades/facilities/filters

Endpoint facts

Method: GET
API path: /healthgrades/facilities/filters
Auth: apiKey
Credits: 2 credits/request
Charged on: Successful 2xx responses only
Platform: Healthgrades
Response schema: #/definitions/healthgrades.facilityFiltersResponseDoc

Healthgrades Scraper API Try Healthgrades facility search filters API in Playground Healthgrades API documentation

How this endpoint behaves

Query parameters:

type (required): hospital, pharmacy, group_practice, or urgent_care.
query (optional): facility name or keyword.
where (required): city and state or ZIP code.

Live monitoring

Monitored request: GET /healthgrades/facilities/filters?type=hospital&where=Boston%2C+MA
Checks passed, 7 days to 14 Oct 2026: 100%
Median response time: 4.18 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /healthgrades/facilities/filters?type=hospital&where=Boston%2C+MA
Items in sorts: 3
Fields filled in every checked item: 2

Field	Filled in, of 3 checked
key	3
label	3

Request parameters

Parameter	Type	Required	Description	Example
type	string	Yes	Facility type Allowed values: hospital, pharmacy, group_practice, urgent_care.	hospital
query	string	No	Optional facility name or keyword
where	string	Yes	City and state, or ZIP code	Boston, MA
x-api-key (header)	string	Yes	API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/healthgrades/facilities/filters?type=hospital&query=coffee&where=Boston%2C+MA" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 0,
  "message": "success",
  "data": {
    "type": "hospital",
    "where": "Boston, MA",
    "sorts": [
      {
        "key": "bestmatch",
        "label": "Best Match"
      },
      {
        "key": "distance",
        "label": "Closest"
      },
      {
        "key": "patientsatisfaction",
        "label": "Patient Satisfaction"
      }
    ],
    "filters": [
      {
        "param": "rating",
        "label": "Ratings",
        "values": [
          {
            "value": "Bowel Obstruction|BLO",
            "label": "Bowel Obstruction"
          }
        ]
      }
    ]
  }
}

Request schema

No body schema

Response schema

#/definitions/healthgrades.facilityFiltersResponseDoc

Field	Type	Required	Description
data	healthgrades.FacilityFiltersResponse	No
data.filters	array	No	PhysicianFilterGroup record, 10 fields: label, param, values. Described under Healthgrades facility search API.
data.query	string	No
data.sorts	array	No
data.sorts[].key	string	No
data.sorts[].label	string	No
data.type	string	No
data.where	string	No

Failure responses

Status	Description	Schema
400	Bad Request	#/definitions/app.Response
429	Too Many Requests	#/definitions/app.Response
503	Service Unavailable	#/definitions/app.Response

Code examples

Use environment variables for secrets and keep Crawlora API keys server-side.

curl -X GET "https://api.crawlora.net/api/v1/healthgrades/facilities/filters?type=hospital&query=coffee&where=Boston%2C+MA" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Shared guides

Authentication Errors and retries Rate limits and credits Pricing Acceptable use

Open in Playground Back to group

Healthgrades facility search filters API

Endpoint facts

How this endpoint behaves

Live monitoring

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related

Healthgrades facility search filters API

Endpoint facts

How this endpoint behaves

Live monitoring

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related