Endpoint Playground
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.
14 Oct 2026: 20 physicians; 17 fields had a value in every checked item and 2 varied between items.
Sample value profiles: npi: 1,003,852,526 to 1,962,454,298, median 1,427,029,263; profile_url: healthgrades.com; accepts_new_patients: true in 6 of 20.
curl 'https://api.crawlora.net/api/v1/healthgrades/physicians/search?query=Cardiology&sort=bestmatch&gender=F&distance=1&age=*-40&availability=today&rating=1' \
-H "x-api-key: $CRAWLORA_API_KEY"| Parameter | Type | Required | Prefilled value | Description |
|---|---|---|---|---|
| query | string | Yes | Cardiology | Specialty, condition, procedure, or provider name |
| where | string | No | City and state, or ZIP code | |
| page | integer | No | Result page (1-500, 20 results per page) | |
| sort | string | No | bestmatch | Result order |
| gender | string | No | F | Provider gender |
| distance | string | No | 1 | Search radius in miles |
| age | string | No | *-40 | Comma-separated provider age bands |
| availability | string | No | today | Comma-separated availability filters |
| rating | string | No | 1 | Minimum patient-satisfaction stars (5 means exactly 5) |
| insurance | string | No | Comma-separated insurer codes from the insurance filter | |
| insurance_plan | string | No | Comma-separated plan IDs from an insurer's plans (requires insurance) | |
| language | string | No | Comma-separated language codes from the language filter | |
| clinical_focus | string | No | Comma-separated clinical focus codes from the clinical_focus filter | |
| affiliated_hospital | string | No | Comma-separated hospital codes from the affiliated_hospital filter | |
| specialty | string | No | Comma-separated practicing-specialty codes from the specialty filter | |
| affirming_care | boolean | No | Only providers marked LGBTQ+ affirming |
{
"code": 0,
"message": "success",
"data": {
"query": "Cardiology",
"where": "Boston, MA",
"page": 1,
"page_size": 20,
"total_results": 350,
"total_pages": 18,
"sort": "bestmatch",
"sorts": [
{
"key": "bestmatch",
"label": "Most Relevant"
},
{
"key": "distance",
"label": "Closest"
},
{
"key": "ratings",
"label": "Highest Rated"
}
],
"physicians": [
{
"name": "Dr. Lana Tsao, MD",
"id": "2QGW4",
"npi": "1467555466",
"profile_url": "https://www.healthgrades.com/physician/dr-lana-tsao-2qgw4",
"specialty": "Cardiology",
"gender": "F",
"age": 62,
"years_experience": 35,
"rating": {
"score": 4.2,
"count": 10
},
"accepts_new_patients": false,
"telehealth_available": false,
"telehealth_only": false,
"distance_miles": 0.5,
"office": {
"name": "Massachusetts General Hospital",
"street": "55 Fruit St",
"city": "Boston",
"state": "MA",
"postal_code": "02114",
"phone": "(617) 643-6148"
},
"insurers": [
"Aetna",
"Cigna"
]
}
],
"filters": [
{
"param": "gender",
"label": "Gender",
"values": [
{
"value": "F",
"label": "Female",
"count": 120
},
{
"value": "M",
"label": "Male",
"count": 230
}
]
}
]
}
}The sample response, schema and code snippets below work without an account. Sending a live request needs an API key.