CMS Hospital General Information Scraper

Extract the complete CMS Hospital General Information directory — every Medicare-certified hospital in the United States (~5,400 facilities) with the official overall star rating, quality-of-care measure counts across mortality / safety / readmission / patient experience / timely & effective care, hospital type, ownership, emergency-services availability, birthing-friendly designation, and full contact info.

This is the same primary-source dataset that powers Medicare's public Care Compare site. It is the canonical regulator-maintained hospital roster, refreshed quarterly by CMS.

Data fields

Field	Description
facilityId	CMS Certification Number (CCN)
facilityName	Hospital name
address, city, state, zipCode, county	Location
phone	Hospital main number
hospitalType	Acute Care, Critical Access, Childrens, Psychiatric, Veterans, Department of Defense
hospitalOwnership	Voluntary non-profit / Proprietary / Government / Tribal (with sub-classifications)
emergencyServices	Whether the hospital provides emergency services
birthingFriendly	Meets CMS Birthing-Friendly designation criteria
overallRating	Overall CMS 5-star rating
mortalityMeasures*	Total / Better / Worse / Same than national rate (mortality group)
safetyMeasures*	Total / Better / Worse / Same (safety of care group)
readmissionMeasures*	Total / Better / Worse / Same (readmissions group)
patientExperienceMeasuresTotal	Count of HCAHPS patient-experience measures reported
timelyEffectiveMeasuresTotal	Count of timely-effective-care measures reported

How to scrape CMS hospital data

1. (Optional) Set state, city, county to scope a region.
2. (Optional) Set hospitalType — e.g. Acute Care, Critical Access, Childrens.
3. (Optional) Set hospitalOwnership — e.g. Voluntary non-profit, Proprietary.
4. (Optional) Enable emergencyServicesOnly for ER-equipped hospitals.
5. (Optional) Set minOverallRating for quality filtering (e.g. 4+ stars).
6. (Optional) Enable birthingFriendlyOnly for the CMS Birthing-Friendly designation.
7. Set maxResults (0 = unlimited).
8. Click Start.

Pricing

Pay-per-result: $0.003 per hospital record. The full directory (~5,400 hospitals) costs about $16. Most users run state- or system-scoped queries.

Input example

{
  "state": "TX",
  "hospitalType": "Acute Care",
  "minOverallRating": 4
}

Output example

{
  "facilityId": "010001",
  "facilityName": "SOUTHEAST HEALTH MEDICAL CENTER",
  "city": "DOTHAN",
  "state": "AL",
  "zipCode": "36301",
  "phone": "(334) 793-8701",
  "hospitalType": "Acute Care Hospitals",
  "hospitalOwnership": "Government - Hospital District or Authority",
  "emergencyServices": true,
  "overallRating": 4,
  "mortalityMeasuresTotal": 8,
  "safetyMeasuresBetter": 3
}

Use cases

• Healthcare B2B sales: medical devices, EHR vendors, group purchasing, facility management — segment hospitals by type, ownership, region, or rating tier.
• Provider network design: payer / TPA network adequacy & quality screening.
• Health policy & journalism: nationwide analysis of quality-measure outcomes.
• Pharmaceutical / biotech sales: prospect by hospital type and rating tier.
• Real-estate / capital projects: identify acute-care hospitals by region with ownership.

FAQ

How fresh is the data? CMS refreshes the underlying Care Compare dataset quarterly. Every run hits the live API.

Are individual quality-measure scores included? This Actor returns the per-group measure counts (how many measures are better / worse / same than national). For per-measure raw scores, CMS publishes a separate dataset; we can build a sibling Actor on request.

Why is the CCN (CMS Certification Number) useful? It is the universal hospital identifier across CMS datasets — joins to claims data, MedPAR, Hospital Compare measure files, Provider of Services file, and more.

Legal

Data sourced from data.cms.gov — the U.S. Centers for Medicare & Medicaid Services public Provider Data Catalog. Records are public federal data. No authentication bypass. Facility-level data only — no patient PHI.