Endpoint Playground
Test Crawlora's Healthgrades physician search API with realistic prefilled parameters. Generate a cURL request, inspect the expected structured JSON response, and open the full docs or pricing page when you are ready to integrate this public web data extraction endpoint into your application.
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
}
]
}
]
}
}Public Playground
Sample responses, schemas, request previews, and code snippets are visible before sign in. Create an account when you are ready to save an API key and run authenticated requests.
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.
{
"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
}
]
}
]
}
}curl "https://api.crawlora.net/api/v1/healthgrades/physicians/search?query=<query>" \
-H "x-api-key: $CRAWLORA_API_KEY"