CMS Nursing Home Ratings Scraper

CMS Nursing Home Ratings Scraper

Scrape CMS nursing home ratings for any state, city, or ZIP code, up to a million facilities per run. Every record includes the five-star overall rating, health inspection, quality measure, and staffing scores, plus ownership details. Export to CSV, JSON, Excel, or XML.

The CMS Provider Data catalog holds the official five-star ratings for every Medicare and Medicaid certified nursing home in the United States, but browsing it manually means clicking through page after page. This Actor reads the public dataset directly, letting you filter by state, city, ZIP code, provider name, or CMS Certification Number, and returns each matching facility in one flat row. No API key, no registration, no rate-limit headaches.

Who uses it	What they scrape CMS Nursing Home Compare for
Healthcare market analysts	Benchmark nursing home quality across states or ownership types.
Senior living referral services	Build a searchable database of top-rated facilities by ZIP code.
Journalists and researchers	Investigate patterns in health inspection scores and staffing levels.
Compliance officers	Monitor competitors' ratings and identify facilities with declining scores.

What it does

This Actor collects nursing home records from the CMS Provider Data catalog and returns each facility as a flat row with its five-star ratings, location, and ownership type.

• ⭐ Five-star ratings: overall, health inspection, quality measure, and staffing ratings for every facility.
• 📍 Location filters: narrow results by state, city, or ZIP code to focus on one region.
• 🔍 Provider search: find a specific nursing home by name or its 6-digit CMS Certification Number.
• 🏢 Ownership type: filter by for-profit, non-profit, or government ownership to compare sectors.
• 📊 Bulk extraction: pull up to a million records in a single run for nationwide analysis.

Results export to CSV, JSON, Excel, or XML, or straight from the API.

What you can do with CMS Nursing Home Compare data

📈 Benchmark nursing home quality by region.

A healthcare analyst pulls all nursing homes in California with a one-star overall rating to identify facilities that need intervention.

🏥 Build a referral database for families.

A senior living advisor scrapes five-star facilities in Houston and exports them to a searchable directory for client consultations.

📰 Investigate staffing patterns across ownership types.

A journalist compares staffing ratings between for-profit and non-profit nursing homes nationwide to support a long-form report.

🛡️ Monitor competitor quality scores.

A compliance officer at a nursing home chain tracks health inspection ratings of nearby facilities to benchmark their own performance.

Why choose this scraper

	What you get
Official CMS data	Ratings come straight from the Centers for Medicare & Medicaid Services, the same source used for the Nursing Home Compare website.
No API key needed	Reads the public dataset directly, so you skip the registration and rate-limiting of the CMS API.
Flexible filtering	Combine location, name, CCN, and five-star rating filters to zero in on exactly the facilities you need.
Flat row output	Every nursing home lands as one row in your dataset, ready for CSV, JSON, Excel, or XML export.

How it compares

No other Store actor targets CMS Nursing Home Compare the same way, so the honest comparison is with the alternatives teams actually weigh.

	CMS Nursing Home Ratings Scraper	Build it in-house	By hand
Setup	Run it now, zero config	Days of engineering	None, but hours per pull
When CMS Nursing Home Compare changes	Maintained for you	You fix it	You re-learn the page
Proxies, retries, anti-bot	Built in	Your problem	Browser only
Output	Fixed JSON schema, CSV/Excel export	Whatever you build	Copy-paste
Cost	Pay per result	Engineering time	Analyst hours

Configure the run

Drive the Actor from state, city, ZIP code, provider name, or CMS Certification Number, alone or together, and rating filters run as each record is read so only matches reach your dataset. The Input tab lists every parameter.

A first run with the defaults:

{
  "maxItems": 10,
  "state": "CA"
}

A larger pull:

{
  "maxItems": 200,
  "state": "CA"
}

Pricing

Pay-per-result: $0.01599 per result collected. You pay only for the results written to your dataset.

Results collected	Approximate cost
100 results	$1.60
1,000 results	$15.99
10,000 results	$159.90

New Apify accounts start with $5 in free credit.

Free users

Free-plan runs return up to 10 results as a preview. Upgrade your Apify plan to collect up to 1,000,000 results per run.

Run it

1. Create a free Apify account with $5 in credit.
2. Open the CMS Nursing Home Ratings Scraper.
3. Set your inputs and any filters, then click Start.
4. Export the results as CSV, Excel, JSON, or XML from the Dataset tab.

Run it programmatically through the Apify API (run-sync-get-dataset-items) or the ApifyClient for JavaScript and Python.

Use with AI agents (MCP)

Give an AI agent live access to CMS Nursing Home Compare through the Model Context Protocol. Add the Actor to Claude, Cursor, or any MCP client:

claude mcp add --transport http apify "https://mcp.apify.com?tools=parseforge/cms-nursing-home-ratings-scraper"

Then prompt it in plain language to run the scraper and read back the results.

Troubleshooting

Why am I getting no results?

Check that your filters are not too restrictive. Try removing one filter at a time, starting with the rating filters, to see which combination returns data. Also verify that your state code is a valid 2-letter abbreviation.

The Actor returned fewer results than my maxItems setting.

This is expected when your filters match fewer nursing homes than the maximum you set. The Actor returns every facility that matches your criteria, up to the maxItems limit.

My provider name search is not finding the facility I expect.

The search supports partial matches, so try a shorter substring of the name. For example, use 'oak' instead of 'Oakwood Nursing and Rehabilitation Center'. You can also try the CCN field for an exact lookup.

Can I get historical rating data?

This Actor returns the current ratings available in the CMS catalog at the time of your run. It does not access historical snapshots or archived rating data.

The run timed out before collecting all records.

Try reducing the maxItems setting or narrowing your filters to a smaller geographic area, such as a single state or city, and run the Actor in batches.

FAQ

Question	Answer
What data does this Actor return for each nursing home?	Each row includes the provider name, address, city, state, ZIP code, CMS Certification Number, overall five-star rating, health inspection rating, quality measure rating, staffing rating, and ownership type.
Can I filter by a specific five-star rating?	Yes. You can filter by overall rating, health inspection rating, quality measure rating, or staffing rating, each on a scale of 1 to 5.
How do I look up a single nursing home?	Enter the 6-digit CMS Certification Number in the CCN field, or type the provider name for a partial match search.
Can I scrape nursing homes in multiple states at once?	The state filter accepts one 2-letter code per run. To collect data for multiple states, run the Actor once per state or leave the state field empty to pull all states.
Is this the same data as the CMS Nursing Home Compare website?	Yes. The Actor reads the same public CMS Provider Data catalog that powers the official Nursing Home Compare tool on Medicare.gov.
Do I need a CMS account or API key?	No. The Actor reads the publicly available dataset directly, so no registration, API key, or OAuth is required.
How many records can I pull in one run?	You can set the maximum up to 1,000,000 nursing homes per run. The actual number returned depends on how many facilities match your filters.
What export formats are supported?	Your dataset can be exported to CSV, JSON, Excel, or XML from the Apify platform.
Can I search by partial provider name?	Yes. The provider name filter supports partial matches, so entering 'sunrise' will return all facilities with 'sunrise' in their name.
How often is the CMS data updated?	The Actor reads the latest data available in the CMS Provider Data catalog at the time of your run. CMS updates its ratings on a regular schedule.

Related actors

Browse the full ParseForge collection for more scrapers.

🆘 Need help? Email parseforge@protonmail.com with your run ID, your input, and what you expected.

⚠️ Disclaimer. This Actor is unofficial and is not affiliated with, endorsed by, or sponsored by Centers for Medicare & Medicaid Services. It collects only publicly available data. You are responsible for using the collected data in compliance with the source's terms of service and applicable data-protection laws, including GDPR, CCPA, and PIPL. Do not use it to collect personal data unlawfully.