CMS Hospital Compare Scraper: US Hospitals & Ratings

Export general information, quality metrics, and operational details for U.S. hospitals directly from official healthcare catalogs. Gather comprehensive facility records—including addresses, contact numbers, ownership models, emergency services availability, and overall star ratings—into structured files ready for export as JSON, CSV, or Excel.

Instead of manually browsing through individual hospital profiles, you can extract reliable, clean datasets for entire states or targeted facility types in bulk.

Use Cases

• Hospital quality assessment: Pull current overall star ratings, physical addresses, and contact numbers across specific states.
• Healthcare directory building: Export lists of acute-care facilities along with ownership types and emergency service flags.
• Market & safety comparison: Compare mortality, patient safety, and readmission measure counts across medical facilities.
• Automated updates: Keep spreadsheets and internal data pipelines refreshed with scheduled exports.
• Research sample collection: Extract structured healthcare data for analytical projects without dealing with complex web pagination.

Extracted Data Points

Each facility entry captures detailed operational and performance attributes:

• Medicare Facility ID and hospital name
• Complete street address, city, state, ZIP code, and county
• Primary telephone number
• Hospital type and ownership category
• Emergency services and birthing-friendly designation indicators
• Overall star rating and associated rating footnotes
• Mortality, safety, and readmission performance measure counts (compared against national averages)

Input Parameters

Parameter	Type	Default	Description
mode	String	rows	Extraction mode (exports one dataset row per facility).
datasetId	String	xubh-q36u	Dataset identifier for Hospital General Information.
state	String	empty	Optional two-letter state abbreviation (e.g., AL).
conditions	Array	[]	Extra property and value filters for targeted queries.
maxItems	Integer	100	Maximum number of hospital rows to save (up to 1,000).
timeoutSecs	Integer	300	Overall execution limit in seconds.

Example Input

{
  "mode": "rows",
  "datasetId": "xubh-q36u",
  "state": "AL",
  "conditions": [
    {
      "property": "hospital_type",
      "value": "Acute Care Hospitals"
    }
  ],
  "maxItems": 100,
  "timeoutSecs": 300
}

Output Format

{
  "facility_id": "010001",
  "facility_name": "SOUTHEAST HEALTH MEDICAL CENTER",
  "address": "1108 ROSS CLARK CIRCLE",
  "citytown": "DOTHAN",
  "state": "AL",
  "zip_code": "36301",
  "countyparish": "HOUSTON",
  "telephone_number": "(334) 793-8701",
  "hospital_type": "Acute Care Hospitals",
  "hospital_ownership": "Government - Hospital District or Authority",
  "emergency_services": "Yes",
  "meets_criteria_for_birthing_friendly_designation": "Y",
  "hospital_overall_rating": "4",
  "hospital_overall_rating_footnote": ""
}

How It Works

1. Processes input options, building state filters and optional property criteria.
2. Formats requests efficiently to fetch records in structured batches.
3. Deduplicates entries based on unique facility identifiers.
4. Handles brief network hiccups using retry delays to maintain execution stability.
5. Exports clean hospital records ready for download in CSV, JSON, or Excel format.

Frequently Asked Questions

How many hospital records can I export in a single run?

The default limit per run is set to 100 rows, but you can increase maxItems up to 1,000 rows.

What happens if I specify an unknown filter property?

If an invalid filter or dataset property is submitted, an error entry explaining the issue will be logged, allowing the execution to complete without crashing.

Can I export datasets directly to CSV or Excel?

Yes. Once completed, your dataset can be downloaded instantly in JSON, CSV, or Excel formats.

---

Legal & Compliance

Trademark Notice

CMS Hospital Compare and related names, logos, and trademarks belong to their respective owners. Their mention in this documentation is strictly to identify data compatibility and utility, and does not imply affiliation, sponsorship, or endorsement.

Disclaimer

This tool is an independent utility and is not affiliated with, endorsed by, or officially connected to third-party healthcare data providers. Users are responsible for ensuring their usage complies with relevant terms of service and local guidelines.

Is web scraping legal?

This tool collects publicly available healthcare information without bypassing access controls. Collecting public data is standard practice, but proper compliance requires considering how the data is used:

• Personal data: Ensure dataset usage respects regional privacy regulations (such as GDPR or CCPA) when combining outputs with personal user records.
• Copyright & Terms: Respect the terms of use, usage limits, and licensing terms set by the data source.
• Legal advice: This summary is provided for general informational purposes and does not constitute formal legal counsel.