Physician and facility directory research
Mit Healthgrades-Endpunkten verwandelst du physician and facility directory research in wiederholbare API-Requests mit dokumentierten Inputs und JSON-Antworten.
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.
Endpunkt-Familien
6
Dokumentierte Parameter
69
Beispiele
16
Live-Katalog-Snapshot
Aktive Endpunkte
16
Methoden
GET
Pflichtparameter
31
Schema-Referenzen
16
{
"platform": "Healthgrades",
"endpoint": "healthgrades-physician",
"method": "GET",
"path": "/healthgrades/physician",
"auth": "apiKey"
}Use Cases
Search Healthgrades physicians and facilities, fetch public profiles, browse Health A-Z articles, and track hospital awards as structured JSON.
Mit Healthgrades-Endpunkten verwandelst du physician and facility directory research in wiederholbare API-Requests mit dokumentierten Inputs und JSON-Antworten.
Mit Healthgrades-Endpunkten verwandelst du hospital award and specialty coverage analysis in wiederholbare API-Requests mit dokumentierten Inputs und JSON-Antworten.
Mit Healthgrades-Endpunkten verwandelst du health a-z topic and article monitoring in wiederholbare API-Requests mit dokumentierten Inputs und JSON-Antworten.
Managed Execution
Jede Zahl unten stammt direkt aus dem Live-Healthgrades-Endpunktkatalog — 16 Endpunkte, 69 dokumentierte Request-Parameter und 16 veröffentlichte Response-Schemas — demselben Katalog, gegen den auch Docs und Playground laufen.
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.
Abdeckungskarte
/healthgrades/facilities/search
/healthgrades/hospital-awards
/healthgrades/physicians/search
/healthgrades/autocomplete
/healthgrades/facility
/healthgrades/health-article
Ausgewählte Endpunkte
/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.
MCP-Tool 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.
MCP-Tool 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.
MCP-Tool 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.
MCP-Tool 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.
MCP-Tool 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.
MCP-Tool healthgrades_hospital
Verwandte APIs
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.
So scrapst du 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.
FAQ
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.