Docs menu

Healthgrades API endpoint

Healthgrades Physician Filters API

Returns every filter available for a Healthgrades provider search at a location, with accepted values, labels, and result counts: insurers (with plan IDs), gender, distance, age, availability, language, patient rating, clinical focus, affiliated hospitals, practicing specialties, and affirming care. Insurer, language, clinical focus, hospital, and specialty values depend on the query and location. Each group's param names the /healthgrades/physicians/search parameter that accepts its values.

GETapiKey2 credits/requestHealthgradeshealthgrades.physicianFiltersResponseDoc/healthgrades/physicians/filters

Endpoint facts

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

Healthgrades Scraper API Try Healthgrades Physician Filters API in Playground Healthgrades API documentation

How this endpoint behaves

Query parameters:

query (required): specialty, condition, procedure, or provider name; maximum 120 characters.
where (optional): city and state or ZIP code.

Returns every filter Healthgrades offers for the search, with each value's label and result count. Each group's param names the /api/v1/healthgrades/physicians/search parameter that accepts its values:

insurance: insurer codes; each insurer lists its plans (IDs for insurance_plan).
gender: F, M.
distance: 1, 5, 10, 25, 50, 100, national.
age: *-40, 41-50, 51-60, 61-70, 71-*.
availability: today, tomorrow, nextTwoWeeks, online, acceptsNewPatients, telehealth.
language: language codes (for example spanish).
rating: 5, 4, 3, 2, 1.
clinical_focus: clinical focus codes for the searched specialty.
affiliated_hospital: hospital codes near the location.
specialty: practicing-specialty codes (for example ps1027) offered when the search spans several specialties.
affirming_care: true.

Insurer, language, clinical-focus, hospital, and specialty values depend on the query and location; groups with no values are omitted.

Live monitoring

Monitored request: GET /healthgrades/physicians/filters?query=Cardiology&where=Boston%2C+MA
Checks passed, 7 days to 14 Oct 2026: 100%
Median response time: 4.41 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /healthgrades/physicians/filters?query=Cardiology&where=Boston%2C+MA
Items in filters: 10
Fields filled in every checked item: 3

Field	Filled in, of 10 checked	Values in the sample
param	10
label	10
values	10	median 6 entries

Request parameters

Parameter	Type	Required	Description	Example
query	string	Yes	Specialty, condition, procedure, or provider name	Cardiology
where	string	No	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/physicians/filters?query=Cardiology" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 0,
  "message": "success",
  "data": {
    "query": "Cardiology",
    "where": "Boston, MA",
    "filters": [
      {
        "param": "insurance",
        "label": "Insurance",
        "values": [
          {
            "value": "HPY00006F7",
            "label": "Cigna",
            "count": 227,
            "plans": [
              {
                "id": "HPT0000407",
                "name": "PPO"
              }
            ]
          }
        ]
      },
      {
        "param": "language",
        "label": "Language",
        "values": [
          {
            "value": "spanish",
            "label": "Spanish",
            "count": 12
          }
        ]
      }
    ]
  }
}

Request schema

No body schema

Response schema

#/definitions/healthgrades.physicianFiltersResponseDoc

Field	Type	Required	Description
data	healthgrades.PhysicianFiltersResponse	No
data.filters	array	No	PhysicianFilterGroup record, 10 fields: label, param, values. Described under Healthgrades facility search API.
data.query	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/physicians/filters?query=Cardiology" \
  -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 filters 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

Open in Playground Back to group

Docs menu

Healthgrades API endpoint

Healthgrades Physician Filters API

GETapiKey2 credits/requestHealthgradeshealthgrades.physicianFiltersResponseDoc/healthgrades/physicians/filters

Endpoint facts

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

Healthgrades Scraper API Try Healthgrades Physician Filters API in Playground Healthgrades API documentation

How this endpoint behaves

Query parameters:

query (required): specialty, condition, procedure, or provider name; maximum 120 characters.
where (optional): city and state or ZIP code.

insurance: insurer codes; each insurer lists its plans (IDs for insurance_plan).
gender: F, M.
distance: 1, 5, 10, 25, 50, 100, national.
age: *-40, 41-50, 51-60, 61-70, 71-*.
availability: today, tomorrow, nextTwoWeeks, online, acceptsNewPatients, telehealth.
language: language codes (for example spanish).
rating: 5, 4, 3, 2, 1.
clinical_focus: clinical focus codes for the searched specialty.
affiliated_hospital: hospital codes near the location.
specialty: practicing-specialty codes (for example ps1027) offered when the search spans several specialties.
affirming_care: true.

Insurer, language, clinical-focus, hospital, and specialty values depend on the query and location; groups with no values are omitted.

Live monitoring

Monitored request: GET /healthgrades/physicians/filters?query=Cardiology&where=Boston%2C+MA
Checks passed, 7 days to 14 Oct 2026: 100%
Median response time: 4.41 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /healthgrades/physicians/filters?query=Cardiology&where=Boston%2C+MA
Items in filters: 10
Fields filled in every checked item: 3

Field	Filled in, of 10 checked	Values in the sample
param	10
label	10
values	10	median 6 entries

Request parameters

Parameter	Type	Required	Description	Example
query	string	Yes	Specialty, condition, procedure, or provider name	Cardiology
where	string	No	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/physicians/filters?query=Cardiology" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 0,
  "message": "success",
  "data": {
    "query": "Cardiology",
    "where": "Boston, MA",
    "filters": [
      {
        "param": "insurance",
        "label": "Insurance",
        "values": [
          {
            "value": "HPY00006F7",
            "label": "Cigna",
            "count": 227,
            "plans": [
              {
                "id": "HPT0000407",
                "name": "PPO"
              }
            ]
          }
        ]
      },
      {
        "param": "language",
        "label": "Language",
        "values": [
          {
            "value": "spanish",
            "label": "Spanish",
            "count": 12
          }
        ]
      }
    ]
  }
}

Request schema

No body schema

Response schema

#/definitions/healthgrades.physicianFiltersResponseDoc

Field	Type	Required	Description
data	healthgrades.PhysicianFiltersResponse	No
data.filters	array	No	PhysicianFilterGroup record, 10 fields: label, param, values. Described under Healthgrades facility search API.
data.query	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/physicians/filters?query=Cardiology" \
  -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 Physician 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 Physician 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