Healthgrades

Search Healthgrades physicians

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.

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

Query parameters

querystring required

Specialty, condition, procedure, or provider name

wherestring

City and state, or ZIP code

pageinteger

Result page (1-500, 20 results per page)

sort'bestmatch' | 'distance' | 'ratings'

Result order

gender'F' | 'M'

Provider gender

distance'1' | '5' | '10' | '25' | '50' | '100' | 'national'

Search radius in miles

age'*-40' | '41-50' | '51-60' | '61-70' | '71-*'

Comma-separated provider age bands

availability'today' | 'tomorrow' | 'nextTwoWeeks' | 'online' | 'acceptsNewPatients' | 'telehealth'

Comma-separated availability filters

rating'1' | '2' | '3' | '4' | '5'

Minimum patient-satisfaction stars (5 means exactly 5)

insurancestring

Comma-separated insurer codes from the insurance filter

insurance_planstring

Comma-separated plan IDs from an insurer's plans (requires insurance)

languagestring

Comma-separated language codes from the language filter

clinical_focusstring

Comma-separated clinical focus codes from the clinical_focus filter

affiliated_hospitalstring

Comma-separated hospital codes from the affiliated_hospital filter

specialtystring

Comma-separated practicing-specialty codes from the specialty filter

affirming_careboolean

Only providers marked LGBTQ+ affirming

Headers

x-api-keystring required

API key required

Response

OK

Changes

No recorded changes to this operation across all 2 revisions of this API.