---
title: "Search Healthgrades physicians"
method: GET
path: "/healthgrades/physicians/search"
tags: ["Healthgrades"]
---

# Search Healthgrades physicians

`GET /healthgrades/physicians/search`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/healthgrades/physicians/search`
- Auth: API key in header `x-api-key`

Returns one page of Healthgrades provider search results for a specialty, condition, procedure, or provider name near a location, with each provider's NPI, specialty, office, aggregate patient rating, accepted insurers, and profile URL, plus the filters available for the search. Closed-set filters accept the listed values; insurance, insurance_plan, language, clinical_focus, affiliated_hospital, and specialty accept values returned in the filters for the same query/where. List filters take comma-separated values. Requests use US egress because Healthgrades restricts content by region. Patient review text is not returned.

## Query parameters

- `query` string, required
- `where` string
- `page` integer
- `sort` 'bestmatch' | 'distance' | 'ratings'
- `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'
- `rating` '1' | '2' | '3' | '4' | '5'
- `insurance` string
- `insurance_plan` string
- `language` string
- `clinical_focus` string
- `affiliated_hospital` string
- `specialty` string
- `affirming_care` boolean

## Headers

- `x-api-key` string, required

## Response `200`

OK

- HealthgradesPhysicianSearchResponseDoc
  - `data` HealthgradesPhysicianSearchResponse
    - `filters` HealthgradesPhysicianFilterGroup[]
      - `label` string
      - `param` string
      - `values` HealthgradesPhysicianFilterValue[]
        - `count` integer
        - `label` string
        - `plans` HealthgradesPhysicianFilterPlan[]
          - `id` string
          - `name` string
        - `selected` boolean
        - `value` string
    - `page` integer
    - `page_size` integer
    - `physicians` HealthgradesPhysicianSearchResult[]
      - `about` string
      - `accepts_new_patients` boolean
      - `affiliated_hospital_ids` string[]
      - `age` integer
      - `distance_miles` number
      - `gender` string
      - `id` string
      - `image_url` string
      - `insurers` string[]
      - `name` string
      - `npi` string
      - `office` HealthgradesPhysicianOffice
        - `city` string
        - `latitude` number
        - `longitude` number
        - `name` string
        - `phone` string
        - `postal_code` string
        - `state` string
        - `street` string
      - `profile_url` string
      - `rating` HealthgradesPhysicianRating
        - `count` integer
        - `score` number
      - `specialist_descriptions` string[]
      - `specialty` string
      - `telehealth_available` boolean
      - `telehealth_only` boolean
      - `years_experience` integer
    - `query` string
    - `sort` string
    - `sorts` HealthgradesPhysicianSortOption[]
      - `key` string
      - `label` string
    - `total_pages` integer
    - `total_results` integer
    - `where` string

## Other responses

- `400`: Bad Request
- `429`: Too Many Requests
- `503`: Service Unavailable

---

[API](https://skmtc.dev/crawlora/apis/crawlora-api.md) · [All operations](https://skmtc.dev/crawlora/apis/crawlora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlora/apis/crawlora-api/revisions/028417aa35bb?raw)