Physician and facility directory research
Usa los endpoints de Healthgrades para convertir physician and facility directory research en solicitudes API repetibles con inputs documentados y respuestas JSON.
Turn Healthgrades' public healthcare directory into structured JSON — physician and facility search with server-reported filters, physician, hospital, pharmacy, urgent-care, and group-practice profiles, Health A-Z topics and articles, hospital award lists, specialties, autocomplete, and popular searches. Patient review text is excluded.
Search Healthgrades physicians and facilities, fetch public profiles, browse Health A-Z articles, and track hospital awards as structured JSON.
Familias de endpoints
6
Parámetros documentados
69
Ejemplos
16
Snapshot en vivo del catálogo
Endpoints activos
16
Métodos
GET
Parámetros obligatorios
31
Referencias de esquema
16
{
"platform": "Healthgrades",
"endpoint": "healthgrades-physician",
"method": "GET",
"path": "/healthgrades/physician",
"auth": "apiKey"
}Casos de uso
Search Healthgrades physicians and facilities, fetch public profiles, browse Health A-Z articles, and track hospital awards as structured JSON.
Usa los endpoints de Healthgrades para convertir physician and facility directory research en solicitudes API repetibles con inputs documentados y respuestas JSON.
Usa los endpoints de Healthgrades para convertir hospital award and specialty coverage analysis en solicitudes API repetibles con inputs documentados y respuestas JSON.
Usa los endpoints de Healthgrades para convertir health a-z topic and article monitoring en solicitudes API repetibles con inputs documentados y respuestas JSON.
Ejecución gestionada
Cada cifra de abajo se lee directamente del catálogo de endpoints en vivo de Healthgrades — 16 endpoints, 69 parámetros de solicitud documentados y 16 esquemas de respuesta publicados — el mismo catálogo contra el que corren Docs y Playground.
16 documented Healthgrades endpoints, grouped into 13 request families — Facilities, Hospital Awards and Physicians, plus 10 more.
69 request parameters are documented across those Healthgrades endpoints, 31 of them required — the full input contract is public before you write any integration code.
16 of the 16 Healthgrades endpoints ship a recorded example response, and 16 carry a documented response schema — you can code against the real JSON before the first request.
Healthgrades endpoints document their error responses (400, 404, 429 and 503) alongside the success schema, so a block, a rate limit, or a missing record comes back as a typed error rather than silently empty data.
16 hosted MCP tools back the Healthgrades endpoints, so an agent can call the same routes with the same parameters and the same JSON contract, with no custom glue.
Mapa de cobertura
/healthgrades/facilities/search
/healthgrades/hospital-awards
/healthgrades/physicians/search
/healthgrades/autocomplete
/healthgrades/facility
/healthgrades/health-article
Endpoints destacados
/healthgrades/physicians/searchReturns 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.
Herramienta MCP healthgrades_physicians_search
/healthgrades/physicians/filtersReturns 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.
Herramienta MCP healthgrades_physicians_filters
/healthgrades/physicianReturns public professional profile fields and practice locations for one Healthgrades physician. Patient-authored review text is not returned. Requests use US egress because Healthgrades restricts some content by region.
Herramienta MCP healthgrades_physician
/healthgrades/facilities/searchReturns one page of Healthgrades facility search results near a location for one facility type (hospital, pharmacy, group practice, or urgent care), with name, address, phone, distance, profile URL, affiliated provider and rating counts, hospital awards, and the filters available for the search. Requests use US egress because Healthgrades restricts content by region.
Herramienta MCP healthgrades_facilities_search
/healthgrades/facilities/filtersReturns the sorts and filters for a Healthgrades facility search: distance values and, for hospitals, every specialty rating and award value accepted by /healthgrades/facilities/search.
Herramienta MCP healthgrades_facilities_filters
/healthgrades/hospitalReturns one Healthgrades hospital profile: hospital-wide and specialty awards with years, clinical outcome ratings by service line (procedure or condition, measure, outcome rating, and 1-5 stars), patient-experience measures with national comparisons, address, and phone. Patient-authored reviews are not returned. Requests use US egress because Healthgrades restricts content by region.
Herramienta MCP healthgrades_hospital
APIs relacionadas
Business & Market Intelligence
Turn public GitHub ecosystem signals into structured data for developer-market research, open-source intelligence, recruiting, and AI-agent workflows.
Business & Market Intelligence
Collect public TrustMRR startup marketplace and leaderboard data as normalized JSON for startup research, SaaS discovery, and market intelligence workflows.
Business & Market Intelligence
Add website and competitive intelligence signals from SimilarWeb to research pipelines.
Cómo hacer scraping de Healthgrades
Crawlora's 16 Healthgrades endpoints connect directory discovery to public profile detail, Health A-Z content, and hospital awards. On 2026-10-04, a live physician search for Cardiology in Boston returned 350 results across 18 pages, with 20 physicians on page one and filter groups for insurance, gender, distance, age, availability, language, rating, clinical focus, hospital affiliation, and affirming care. Read filter values from the matching filters endpoint or search response instead of inventing codes. Patient-authored review text is never returned, and the data routes use US egress where Healthgrades restricts content by region.
Call /healthgrades/physicians/search with a specialty, condition, procedure, or provider query and optional location. Use /healthgrades/physicians/filters for query-specific insurer, language, specialty, clinical-focus, and hospital codes, then pass a returned profile URL to /healthgrades/physician for professional fields and practice locations.
Use /healthgrades/facilities/search for hospitals, pharmacies, urgent-care centers, or group practices. Pair hospital-only rating and award values from /healthgrades/facilities/filters with the same search, then retrieve /healthgrades/hospital or /healthgrades/facility by a returned profile URL.
Start with /healthgrades/health-topics, then page through /healthgrades/health-articles for a returned topic slug; the list is ordered by most recently modified. Pass a returned URL to /healthgrades/health-article and preserve its authors, reviewed_by, date_published, and date_modified fields. Healthgrades says condition, treatment, and wellness content is medically reviewed at least once every two years and is educational, not medical advice, so retain its review dates rather than treating it as real-time guidance.
Read valid award years, states, cities, and specialty values from /healthgrades/hospital-awards/filters, then query /healthgrades/hospital-awards. The result includes award-matched hospitals and profile URLs that can feed the hospital-detail route.
Preguntas frecuentes
No patient-authored review text is returned. A physician profile may include an aggregate rating score and review count, alongside public professional fields and practice locations; individual review content is excluded.
/healthgrades/facilities/search supports hospital, pharmacy, group_practice, and urgent_care. Sort and filter combinations vary by facility type, so use the documented enum and the paired filters endpoint rather than applying hospital-only values to every search.
Closed filters such as sort and distance are documented. Insurer, language, clinical-focus, affiliated-hospital, and specialty codes depend on the query and location; read them from /healthgrades/physicians/filters or the search response for the same inputs.
Yes. The topic endpoint returns Health A-Z topics; the article list accepts a topic slug and pages most-recently-modified entries; detail accepts a returned article URL. Preserve authors, medical reviewers, and publication/modification dates. Healthgrades says condition, treatment, and wellness articles are medically reviewed at least every two years and are educational rather than medical advice.
It returns the selected award list, applied year and region, pagination, and hospitals with profile URLs and matched award records. Available years and geographic or specialty filters come from /healthgrades/hospital-awards/filters.
Healthgrades says its hospital-quality ratings are based on clinical outcomes adjusted for patient risk factors. /healthgrades/hospital-awards returns award records and matched hospitals, not the underlying claims data or patient-review text, so keep those measures separate in comparisons.